Multi Line Settings

Defines settings which enable multi-line input and display of string data in a Data Field.

Remarks

Configures how multi-line text input and display is handled for a Data Field.

Overview

Use this object to control the appearance and behavior of fields that accept or display multiple lines of text, such as comments, addresses, or descriptions.

Key Features

• Set the number of visible lines in the input area using 'Display Lines'.
• Enable or disable word wrapping with 'Word Wrap' to control how long lines are displayed.

Configuration Guidance

• Assign a MultiLineSettings object to a Data Field to allow users to enter or view multi-line text.
• Adjust 'Display Lines' to provide enough space for typical input without excessive scrolling.
• Enable 'Word Wrap' for fields where long lines should be wrapped within the visible area.

Example Use Cases

• Address Field: Set 'Display Lines' to 3 and enable 'Word Wrap' to allow entry of multi-line addresses.
• Comments Field: Increase 'Display Lines' for longer user comments or notes.

For best results, configure these settings to match the expected length and format of user input for your field.

Properties

Name	Type		Description
Display Lines	Int32	►	The number of lines. Default3 Min1 Specifies how many lines of text are visible in the input area for the field. Increase this value to provide more space for multi-line input, reducing the need for scrolling. Typical values range from 1 (single-line) to 10 or more for large comment fields.
Word Wrap	Boolean	►	In multi-line mode, controls whether text wrapping is enabled. DefaultFalse When enabled, long lines of text will automatically wrap to the next line within the input area. Disable this to require horizontal scrolling for long lines, which may be useful for data where line breaks are significant.

Used By

Data ColumnData Field