Properties of a Multi-line text control
Use the following tabs to configure the properties of a Multi-line text control.
General
Type |
The type of the control. |
||||||||||||||||||||
Name |
A unique name for the text field. For example, use "CustName" instead of "textbox1". |
||||||||||||||||||||
Tooltip |
Supplementary information about the text field. For example, inform the user that the name must start with a Capital letter. Add a tooltip for the Customer Name field in the Customer Details form like "Enter your name here and make sure that the name starts with a Capital letter." |
||||||||||||||||||||
State |
The state of the field to be Optional, Mandatory, or Hidden. (Default: Optional) |
||||||||||||||||||||
Enabled |
Enables the field at runtime. |
||||||||||||||||||||
Read only |
If selected, makes the text field non-editable at runtime. |
||||||||||||||||||||
Security token |
Makes the control secure. See Security tokens. |
||||||||||||||||||||
Text |
A meaningful text for the text field. For example, use "Customer name" instead of "textbox1". |
||||||||||||||||||||
Hint text |
Hints the user to enter a value in the input field. The hint text appears before the user enters a value. When you click on the field, the hint text disappears. The hint text only appears if the field does not have a value, default value, or focus. If you import a form from a previous version of TotalAgility, the hint text appears empty. |
||||||||||||||||||||
Error message |
A message to appear at runtime when a mandatory text field contains no data. |
||||||||||||||||||||
Max length |
The maximum number of characters allowed in a text field. If set, you cannot enter more than the specified number of characters into the text field. If you enter more characters, only characters up to the set maximum number appear in the field. By default, the maximum length of a text field is 0 (zero), which means a user can enter any number of characters in the field. The max length property is independent of Type and Format properties. |
||||||||||||||||||||
Multiline |
Handles text that may go beyond one line, such as customer address. The Height of the control defaults to 66. If selected for a capture text field, you can preserve line breaks during OCR lassoing. See
Capture controls for more
information on a Capture text field.
|
||||||||||||||||||||
Field type |
Predefined field types used for entering specific types of data in a text field. For example, if the text field will be used for entering dates, select Date as the field type. TotalAgility supports the following field types.
If you view a form in a phone browser like Safari using a touchscreen, the device displays the touchscreen keypad to enter the data. |
||||||||||||||||||||
Mask |
Controls the format of the value entered by the user at runtime. See Masked text field. |
||||||||||||||||||||
Format |
Set up a field mask in the form of a regular expression that appears when a user enters data. Use a pre-defined regular expression or create custom expressions. |
||||||||||||||||||||
Regular expression |
A set of rules applied to a text field. The rules specify the type and range of data that a user can enter. The expression tests the accuracy of input data as the form is being completed and ensures that the data entered conforms to the specified pattern. If the pattern is not followed, a message can inform the user of the error. For example, specify a regular expression for a text field in which a user must enter a name in the following format: <First name starting with a capital letter> space <Last name starting with a capital letter>. If the user forgets to enter the space before the Last name, a message can be displayed. Supported regular expressions include:
|
||||||||||||||||||||
Value when empty |
A default value to be used by an action (.Net, Web service, or DB query) at runtime if the text box remains empty. The value can be Null or String. If the text field value is empty at runtime, the system checks which property is selected at the design time. If Null is selected, the value of the text field when empty is null. If String is selected, the value of the text field fetches the string value given at the design time and displays it at runtime. By default, the text field is empty. |
||||||||||||||||||||
Show time |
If selected, displays the time element at runtime. This property is only displayed when the textbox field type is set to Date. |