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 25.1.0213.641

      The following release notes apply to Toolbox build 25.1.0213.641. Stay Down Nesting Additions 3 new settings have been added to Stay Down Nesting, to resolve specific issues with routes and connectors that have been reported: Fig. 1: New options in ...
    • Toolbox Release Notes: Year of 2024

      This document will catalog all releases for Microvellum Toolbox software builds that were released in the year 2024. This encompasses builds 24.1.0104.641 to 24.1.1206.641. Toolbox Release Notes | Build 24.1.1206.641 The following release notes apply ...
    • Toolbox Release Notes | Build 25.1.0129.641

      The following release notes apply to Toolbox build 25.1.0129.641. SMA Fixes A wide variety of issues with the Solid Model Analyzer have been resolved. Multiple modifications to existing interfaces or settings have been made to improve precision and ...
    • Microvellum Foundation Library Release Notes | Build 25.0124

      The following release notes apply to Microvellum Foundation Library build 25.0124. Additions Added Century Components Waste Bins, Vanity Organizers, and Base Cabinet Organizers. 11”, 14”, 17” Signature Series Bottom Mount 34qt & 50qt. 4”, 5”, 6”, 9”, ...
    • SQL Server Backups

      This article will list out the various types of backups you can create for databases hosted on an SQL Server, explore methods for creating backups manually and automatically, as well as list software/services that may assist you with backing up your ...