Text Properties in Report Designer

Text Properties in Report Designer

Word Wrap

Text that cannot fit on one line is trimmed by default. To avoid this, and allow text to fill multiple lines, set the TextOptions.WordWrap property to True. Horizontal and vertical alignments are used when the text is wrapped on a new line.

Fig. 01 - Word Wrap Property
Fig. 01 – Word Wrap Property

Fig. 02 - Word Wrap Example
Fig. 02 – Word Wrap Example

Trimming

The TextOptions.Trimming property makes it possible to customize text trimming.

Fig. 03 - Trimming Property and Values
Fig. 03 - Trimming Property and Values

  1. None – With the “None” value selected, the text is trimmed by the edge of the text component. Multiline text is trimmed by the last word. 

  2. Fig. 04 – Trimming set to “None”

  3. Character – With the “Character” value selected, the text line is trimmed after the last completely visible character. 

  4. Fig. 05 – Trimming set to “Character”

  5. Word – With the “Word” value selected, the text line is trimmed after the last completely visible word. 

  6. Fig. 06 – Trimming set to “Word”

  7. Ellipsis Character – With the “Ellipsis Character” value selected, the text line is trimmed after the last completely visible character, but an ellipsis is added to the end. 

  8. Fig. 07 – Trimming set to “Ellipsis Character”

  9. Ellipsis Word – With the “Ellipsis Word” value selected, the text line is trimmed after the last completely visible word, but an ellipsis is added to the end. 

  10. Fig. 08 – Trimming set to “Ellipsis Word”

  11. Ellipsis Path – With the “Ellipsis Path” value selected, the text line is trimmed in the middle, so the beginning and end of the text line remain visible. 

  12. Fig. 09 – Trimming set to “Ellipsis Path”

Line Limit

When the TextOptions.LineLimit property is set to true full lines are output as opposed to being vertically cut off.

When there is no additional line, this property may change the word wrap.

Fig. 10 – Text Additional > TextOptions.LineLimit Property

Fig. 11 - Line Limit Example
Fig. 11 – Line Limit Example

Underlining

The Text Additional > Lines Of Underline property can be used to underline text with horizontal lines. There are different styles of underlining available, as can be seen in Figures 12 and 13.


Fig. 12 – Text Additional > Lines Of Underline Property

Fig. 13 - Underline Examples
Fig. 13 – Underline Examples

Max Number of Lines

To increase the maximum amount of horizontal lines in a text component, use the Text Additional > Max Number Of Lines Property. This property is equal to zero by default, and the component increases vertically. Page size limits the component increasing. Setting the value of the property to five increases the horizontal lines by five when the vertical size increases.


Fig. 14 – Text Additional > Max Number Of Lines Property


Fig. 15 – Text Additional > MaxNumberOfLines Example

Text Rotation

Text rotation is determined with the Text Additional > Angle property. The angle is given in degrees, anticlockwise.


Fig. 16 – Text Additional > Angle Property


Fig. 17 – Text Additional > Angle Examples

Processing Duplicates

The Text Additional > Processing Duplicates property allows for the combination of duplicate values. The values for the ProcessingDuplicates can be seen in Figure 18.


Fig. 18 – Text Additional > Processing Duplicates Property

  1. Remove Text – The “Remove Text” value keeps the first text component AND the text content, but removes all duplicate text content. This value leaves blank text components. 
  2. Fig. 19 - Remove Text
    Fig. 19 – Remove Text

  3. Hide – The “Hide” value removes both the text content and the text components from all duplicates after the first. 
  4. Fig. 20 - Hide
    Fig. 20 - Hide

  5. Merge – The “Merge” value combines duplicates into a single text component. 
  6. Fig. 21 - Merge
    Fig. 21 – Merge
Combining components with the same value is taken into account in the name of the components of the report template. Text Components that have the same text content, but different names, are not merged. The Global Merge, Global Remove Text, and Global Hide values can be used to avoid this limitation.

Ignoring Null Values

If it is not necessary to print zeros in your report, use the Hide Zeros property to remove them. Setting the property to true prevents the text component from printing zero values.

Fig. 22 - Hide Zeros Property
Fig. 22 – Hide Zeros Property

Fig. 23 - Hide Zeros Example
Fig. 23 – Hide Zeros Example

Shrink Font to Fit and Shrink Font to Fit Minimum Size Properties

Fig. 24 - Shrink Font to Fit and Shrink Font to Fit Minimum Size
Fig. 24 – Shrink Font To Fit and Shrink Font To Fit Minimum Size

The Shrink Font To Fit property is used to adjust the height of the text to the size of the text component. The Shrink Font To Fit Minimum Size property controls the minimum size the font can be reduced to.

    • Related Articles

    • Auto-Sizing Text Components in Report Designer

      The articles in this section of the Knowledge Base involve working with Auto-Size properties in Report Designer. To learn additional information regarding Auto-Sizing properties, see Understanding Auto-Sizing Properties in Report Designer. This ...
    • Understanding Text Formatting in the Report Designer

      The articles in this section of the Knowledge Base involve Text Formatting for display in your reports. To access the Report Designer, select Toolbox Setup > Design Reports > Design (Report Type) Report. Select New Report to design a report from ...
    • Multi Line Expressions

      Multiple lines of text can be produced in a report by a single expression. To create a multi-line expression, insert a line feed before any new line. To do this, press the Enter key at the appropriate place in the code editor. There is no limit to ...
    • Understanding the Text Editor in Report Designer

      The Text Editor allows users to edit text components in Report Designer. This ability to modify text components allows for better customization of report appearances. Expression Tab Fig. 01 – Expression Tab (Text Editor) This tab has the following ...
    • Fonts and Font Brushes

      Microvellum Reports features two components that are used to draw and set up text. These components are Text and Rich Text. To access the font for these components, open the Style Designer, and the Font property is found in the Object Inspector at ...
    • Recent Articles

    • Toolbox Release Notes | Build 24.1.1105.641

      The following release notes apply to Toolbox build 24.1.1105.641 Nesting Fix Fig. 1: The fatal error that would occur during processing. There was reportedly an issue that occurred when clients attempted to process a work order using the nesting ...
    • Microvellum Foundation Library Release Notes | Build 24.1025

      The following release notes apply to Microvellum Foundation Library build 24.1025. Additions Added new global variable “Remove Stop Dado On Bottom Edge” for wood drawer boxes. Check this option to run the dado through at the bottom of the sub front ...
    • Toolbox Release Notes | Build 24.1.1030.641

      The following release notes apply to Toolbox build 24.1.1030.641 Routing and Profile Fixes Several issues were found with routing and polyline paths: Fig. 1: Horizontal routes off of a part disappearing (left) and appearing correctly (right). When ...
    • Toolbox Release Notes | Build 24.1.1010.641

      The following release notes apply to Toolbox build 24.1.1010.641 Biesse Winstore Fix Several issues with the Biesse Winstore plugin have been resolved: There was an issue that would sometimes occur wherein materials that were intended to stack wound ...
    • Toolbox Release Notes | Build 24.1.1001.641

      The following release notes apply to Toolbox build 24.1.1001.641 HBore Toolfile Fix Fig. 1: The location in the Toolfile UI where the error would occur. There was an issue reported with the functionality of the Horizontal Boring Machine setting in ...