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.0416.641

      The following release notes apply to Toolbox build 24.1.0416.641. Maestro Toolfile Fix There was an issue with Maestro SCM Toolfiles reportedly experienced by some users, wherein the labels output by autolabeling would be in incorrect positions, an ...
    • Toolbox Release Notes | Build 24.1.0409.641

      The following release notes apply to Toolbox build 24.1.0409.641 Saw Delimited Processing Station Figure 1: The Saw Delimited option in a custom processing station. New options have been added to saw processing stations to allow for control over data ...
    • Toolbox Release Notes | Build 24.1.0328.641

      The following release notes apply to Toolbox Build 24.1.0328.641 Fillet Token Fixes Issues were discovered in the use of fillet tokens on products that also had the IRIB setting enabled: Some users processed work orders with rounded parts, which ...
    • Microvellum Foundation Library Release Notes | Build 24.0322

      Additions Added the Master Angled Ends Cabinet. Added a Global prompt, "Hinge Plate Offset From Front" for easier control. Added “Double Division” option to Horizontal Designer Cabinets, 3 Door Cabinets, and other similar products. Added a new ...
    • Common Floating License Connectivity Issues

      This document lists common issues reported by users regarding the topic of Microvellum’s Floating License Activation (FLA) and the connectivity required for FLA to function. Firewall Blocking Activation of Floating License Some users have had an ...