Properties of a Textbox control
Use the following tabs to configure the properties of a Textbox control.
The type of the control.
A unique name for the text field. For example, use
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 similar to "Enter your name here and make sure that the name starts with a Capital letter."
The state of the field to be Optional, Mandatory or Hidden. (Default: Optional)
If selected, enables the field at runtime.
If selected, makes the text field non-editable at runtime.
Makes the control secure. See Security tokens.
A meaningful text for the text field. For example, use "Customer name" instead of "textbox1".
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.
A message to appear at runtime when a mandatory text field contains no data.
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.
Handles text that may go beyond one line, such as customer address. If selected, allows you to specify the height of the text field. If clear, the height of the control defaults to 22.
Capture controls for more information on capture text field.If selected for a capture text field, you can preserve line breaks during OCR lassoing. See
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 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.
Controls the format of the value entered by the user at runtime. See Masked text field.
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.
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 textbox remains empty. If the text field value is empty at runtime, the system checks which property is selected at the design time.
For a String field type, the value can be Null or String. 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 for String is empty at design time.
For a Date field type, the value can be Null or Date (default). If Null is selected, the value of the text field when empty is null. If Date is selected, you can select a date which is displayed at runtime. By default, the Date field is empty at design time.
For a numeric textbox, (field type set to Numeric, Decimal, and Currency), the value can be Null or Number. If Null is selected, the value of the text field when empty is null. If Number is selected, you can enter a numeric value (default: Number, 0) which is displayed at runtime. This applies to Desktop, Tablet and Mobile forms.