Text Area Builder

Text Area Builder

In this topic ...

Specifying Inputs
Related Topics ...

Overview: Creating Pages and Forms

The Text Area builder adds a text area to one or more pages in the model . A user can enter text and when the user submits the form, the contents of the text area get passed as an input to the action handling the form submission.

Specifying Inputs

The Text Area builder takes the inputs described in the table below. For help on inputs common to many or all builders such as those in the Properties and HTML Attributes input groups, see "Using the Builder Call Editor."

Input Name Description
Name Enter a name for this builder call. The Designer displays this name in the Builder Call List.
Page Location Use the Page Location input to specify the page or pages on which this builder call will act. Alternatively, we can type in the page location syntax directly.
See "Locating Control Builders on Pages" for detailed documentation about the Page Location input and page location syntax.
Default Text Enter a default value for this text area. If the user does not specify a value, the action processing the form submission receives this value as an input.
Replace Tag Contents By default, the Text Area builder replaces the contents of the named tag on which it operates with its Default Text value.
If you want the Text Area to append the Default Text value to the existing contents of the named tag, disable the Replace Tag Contents check box.
Attributes
Cols Controls the width of the text area. Enter an integer representing the width in columns (characters) for the text area.
Example: 50
Rows Controls the height of the text area. Enter an integer representing the height in rows for the text area.
Example: 15
Wrap Forces text lines longer than the Cols setting to wrap to a following line. There are three options for this setting:

Off - Disables wrapping. Text entered in Text Area is transmitted to the server exactly as typed with lines broken only when user presses the Enter key. Horizontal scroll bar is provided if/when text width exceeds Cols setting.
Virtual - Causes text to wrap. Text area can contain multiple lines of text, but only a single line will be sent to the server and no "newline" characters will be used.
Physical - Causes text to wrap. Text area can contain multiple lines of text and multiple lines will be sent to the server separated by "newline" characters.

Input Name	Description
Name	Enter a name for this builder call. The Designer displays this name in the Builder Call List.
Page Location	Use the Page Location input to specify the page or pages on which this builder call will act. Alternatively, we can type in the page location syntax directly. See "Locating Control Builders on Pages" for detailed documentation about the Page Location input and page location syntax.
Default Text	Enter a default value for this text area. If the user does not specify a value, the action processing the form submission receives this value as an input.
Replace Tag Contents	By default, the Text Area builder replaces the contents of the named tag on which it operates with its Default Text value. If you want the Text Area to append the Default Text value to the existing contents of the named tag, disable the Replace Tag Contents check box.
Attributes
Cols	Controls the width of the text area. Enter an integer representing the width in columns (characters) for the text area. Example: 50
Rows	Controls the height of the text area. Enter an integer representing the height in rows for the text area. Example: 15
Wrap	Forces text lines longer than the Cols setting to wrap to a following line. There are three options for this setting: Off - Disables wrapping. Text entered in Text Area is transmitted to the server exactly as typed with lines broken only when user presses the Enter key. Horizontal scroll bar is provided if/when text width exceeds Cols setting. Virtual - Causes text to wrap. Text area can contain multiple lines of text, but only a single line will be sent to the server and no "newline" characters will be used. Physical - Causes text to wrap. Text area can contain multiple lines of text and multiple lines will be sent to the server separated by "newline" characters.