Word Box and Word Wrap Box

The Word Box and Word Wrap Box are layout objects for the display of text.

Word Box

Word Box (WordBox type) is a layout container, found in the Drawables group in the Tool Box view.

Use this object for a specified chunk of text, which uses the current font.

These properties are specific to Word Box:

trimText, underline, strikethrough, fidelity, localizeText

Word Wrap Box

Word Wrap Box (WordWrapBox type) is a layout container, found in the Drawables group in the Tool Box view.

This object is like a Word Box with paragraphs of uniform text.

These properties are specific to Word Wrap Box:

trimText, indent, fidelity, localizeText

Properties

Select the object on the Report Design page to display its properties in the Properties View.

The text property specifies the string to be displayed in the Word Box or Word Wrap Box.

You can set the textAligment property for a Word Box or Word Wrap Box to left, right, or center. The alignment does not influence page break positions even if the indent property is set to some value. For Word Wrap Boxes, the textAlignment property can also be set to justified.

The localizeText property enables the localization of text content in Word Boxes and Word Wrap Boxes.

Additional properties are inherited from Layout Node.

Tip:
  • Don't set the Y-Size (height) property on a Word Wrap Box, because the element should typically grow in accordance with its content. If you set a fixed Y-Size, you prevent that automatic enlargement.
  • Use relative positioning for Word Boxes and Word Wrap boxes. Relative positioning means the text adapts to changes in font and page setting, as well as to translation.
  • A Word Wrap Box can span pages. When the available vertical space for a Word Wrap Box is not sufficient to display the entire text, the box propagates the exceeding content to additional boxes, with the same behavior as a propagating Mini Page.
  • Use the Suppress property in the Repetitions section to ensure that the value of a Word Box displays only once per page. For further details, see Hide repeated values.

Entering text and line breaks

The text value can be edited directly in the report design document. Double-click the object to place the input cursor in the box, and type your text. The Text property and the layout are updated on each keystroke.
Note: Line breaks display in the Text property as a newline character, \n.

You can also enter an RTL expression in the Text property. To force a line break in an RTL expression, use (10).toChar(), for example:

orderline.account.addr1+(10).toChar()+orderline.account.city