Text
- Last UpdatedJun 25, 2024
- 5 minute read
Use Text control to enter and view textual data in your form.
Properties
The properties for the control are grouped under the following tabs:
Basic
|
Property |
Description |
|---|---|
|
Name |
Name that identifies the control. This value is also used for the label of the control. |
|
XML Node |
XML node mapped to the control. Use this value to map a list to a form and a form to a workflow.
Note: |
|
Description |
Description for the control. |
|
Tooltip |
Message that appears when the pointer hovers over the control. |
|
Default Value |
The default value for the control. Note: Ensure the value is within the Minimum Length and the Maximum Length. |
Appearance
|
Property |
Description |
|---|---|
|
Enable |
Enable or disable the control.
|
|
Visible |
Show or hide the control.
|
|
Read-Only |
Allow or deny a user to enter a value for the control.
|
|
Label Position |
Position of the label for the control.
Note: |
|
Label-Control Area |
Area occupied by the label and the control in percentage.
Note: |
|
Watermark |
Hint text that appears when no value is entered for the control. |
|
Width |
Width in pixels for the control. The default value is 0. Note: If the value is 0, then the width of the control is set as per the default values. |
|
Height |
Height in pixels for the control. The default value is 0. Note: If the value is 0, then the height of the control is set as per the default values. |
|
Retain Space |
Reserve or remove space when the control is hidden.
|
|
Display Mode |
Number of lines to show for the control.
Note: The Multi Line option is applicable only when the Rows property is set to 2 or more. |
|
Rows |
Number of rows for the control. |
Validation
|
Property |
Description |
|
Mandatory |
Enforce or bypass entering a value for the control.
|
|
Text Pattern |
Regular expression to validate the text for the control. For example, use the following regular expression to validate a text string as a phone number: ^[2-9]\d{2}-\d{3}-\d{4}$ |
|
Minimum Length |
Minimum length of the value for the control. The default value is 0. Note: If the value is 0, then the minimum length for the control is not set. |
|
Maximum Length |
Maximum length of the value for the control. The default value is 0. Note: If the value is 0, then the maximum length for the control is not set. |
Advanced
|
Property |
Description |
|---|---|
|
On Data Change |
Run a script when value of the control changes. For more information, see scripting guidelines for On Data Change property. |
|
ID |
Reference identification code for the control. This value is automatically generated and cannot be changed. |
|
Include in Summary |
Allow or deny a user to view the value in the Summary of a Base Form.
Note: |
Scripts
For information about using scripts, see scripting guidelines for Text control.