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 Drawable group in the Tool Box view.

Use this object for a specified chunk of text, which will use 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 Drawable group in the Tool Box view.

This object is like a WordBox 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. You can change the object's default appearance by setting the values of its properties.

The text property specifies the string to be displayed in the WordBox 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 will adapt 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.

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