DisplayHostLineBreak Property

Gets or sets a value which determines whether new lines should be inserted to match host line breaks (Multi-line entry fields only).

object.DisplayHostLineBreak = [boolean]

Where object is an object expression that evaluates to one of the controls in the Applies To list, and boolean is a boolean expression that evaluates to either True or False, as described in Settings.

Client support

Newlook Smartclient only.

Use

Multi-line text box controls support word wrapping by default, however if you wish to respect the location of line breaks in the host display, then setting this property to True, will ensure that a new line character will be inserted at the position where text starts on another line in the host display.

TIP

This property only applies to multi-line entry fields.

As an example, the following image is an example of an entry field that spans several lines. The text breaks in the middle of a word on the first line:

Setting DisplayHostLineBreak to True will render the field with line breaks in exactly the same location as the host field:

Setting DisplayHostLineBreak to False will turn word wrapping on and let the GUI dictate line breaks.

Settings

The DisplayHostLineBreaks settings for the text box control are :

Setting

Description

True

Insert a new line character where text starts on another line in the host display.

False

(Default ) Let the GUI control dictate line breaks.

See Also

MultiLine property

Applies To

Text box control


© 2004-2021 looksoftware. All rights reserved.