TextArea

Displays a multi-line text entry box.

Properties for this display component are:

• rows– Specifies the number of text area rows. (Integer)

• columns– Specifies the number of text area columns. (Integer)

• readOnly– Displays read-only text in the text entry box. When set to true, this component will not have a border. (Boolean)

• format– Set to control how setValue() behaves and determine the type of object returned by getPostData(). (String)

• sorted– Enables sorting of lines in the text area, when set to true. This feature is convenient when the area is used to display a list of selections, not free-form text. (Boolean)

• noTrim– Specifies whether text posted from the HTML form is trimmed. The default is to trim white space. To preserve white space, set this value to true.

Example

To display a text box with five visible rows that wraps after each 70 characters specify:

<Field name=’Description’>
   <Display class=’TextArea’>
     <Property name=’rows’ value=’5’/>
     <Property name=’columns’ value=’70’/>
   </Display>
</Field>

If the user enters text beyond the defined visible rows, the text area displays a scroll bar.