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. 02 – Word Wrap Example
Trimming
The TextOptions.Trimming property makes it possible to customize text trimming.
Fig. 03 - Trimming Property and Values
- 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.
Fig. 04 – Trimming set to “None”
- Character – With the “Character” value selected, the text line is trimmed after the last completely visible character.
Fig. 05 – Trimming set to “Character”
- Word – With the “Word” value selected, the text line is trimmed after the last completely visible word.
Fig. 06 – Trimming set to “Word”
- 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.
Fig. 07 – Trimming set to “Ellipsis Character”
- 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.
Fig. 08 – Trimming set to “Ellipsis Word”
- 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.
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
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
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
- 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.
Fig. 19 – Remove Text
- Hide – The “Hide” value removes both the text content and the text components from all duplicates after the first.
Fig. 20 - Hide
- Merge – The “Merge” value combines duplicates into a single text component.
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. 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
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.