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 ...
    • Understanding the Rich Text Editor in Report Designer

      The articles in this section of the Knowledge Base involve working with Rich Text for display in your reports. To learn more about the Rich Text editor, and how to access this section within the Report Designer, see An Introduction to the Rich Text ...
    • Recent Articles

    • Microvellum Foundation Library Release Notes | Build 26.0220

      The following release notes apply to the Microvellum Foundation Library build 26.0220. Additions Added DTC Magic Pro and Magic Star Ultra drawer systems. Magic Pro Items added in hardware file 300 and 600 lengths for all drawer heights. Add 60kg ...
    • Microvellum Release Notes | Build 25.2.0223.641

      The following release notes apply to Microvellum build 25.2.0223.641. Add 2D Elevation Tokens to 3D Drawings Fig. 1: The new 2D Elevation setting. A popularly requested feature by the community has been added to the Microvellum software: the checkbox ...
    • Microvellum Processing Center Application

      The standalone Processing Center application provides shop-floor tools for managing and executing manufacturing data generated from Microvellum projects. It enables users to: Print part labels View and print reports Create and re-create manufacturing ...
    • Microvellum Release Notes | Build 25.2.0213.641

      The following release notes apply to Microvellum build 25.2.0213.641 File Name Fix An issue was occurring when processing work orders with the Create Sequential File Names setting enabled. When the setting was enabled, a work order being processed ...
    • Microvellum Release Notes | Build 25.2.0206.641

      The following release notes apply to Microvellum build 25.2.0206.641. Item Number Fix An issue was reported regarding item numbers in composite drawings. Users who processed work orders with multiple products reported that the item numbers would ...