How to Setup
When adding a Text Field to a form it needs to be positioned under a "Field Set Container" that is under a "Form". The text field is fairly basic. Nevertheless, it does have some configuration options;
Allow Blank
By default this field is set to True.
If changed to False, the Text Control will require the user to enter data into this field before it is allowed to be saved - a Mandatory Field. In the following image the Text box was changed to All Blank FALSE. Note the information button carries a message, which displays the text that is controlled in the "Blank Text" property (below).
Anchor
The Anchor number is a method of rapidly navigating a large form.
Blank Text
The Blank text is displayed if the Allow Blank property is set to False and the user tries to save the Form with no data in the field
Data Binding
This property is where control is bound to the property of the object that is either going to be displayed and/or edited.
Field Label
The name that will appear next to the Text Field.
Field Width
The width in pixels that the Text Field will display, 0 is 100%.
Hide Label
If set to "True" the Label will be hidden.
Hide When Blank
If the field bound to this field is empty the Text Field will not appear instead of displaying an empty box.
Input Mask
This property will accept a regular expression (see http://www.regular-expressions.info for more expalnation of regular expressions) that is used to assess and "reject" the data that has been entered into the control.
Read only
By default this control is set to False and the control will allow the user to type in a value. The control can be set to True, in which case it will not accept any data changes.
Tool Tip Text
If any text is entered into this property, the control will display an Information icon next to it. If the User mouses-over the blue information icon, then the text entered into this property will display. Useful for Help tips and data descriptions.
Validate Blank
If this option is set to TRUE then the Control will follow the validation rules set in the Validation Type explained below
Prevent Advanced Search
If this Option is set to True, then this control will not be presented to the User in the Advanced Search Option (XPOR back end search function). This only applies if the form is the Object Editor for this object type
Maximum Length
The maximum characters allowed, if exceeded it will not be possible to save. 0 is unlimited.
Minimum Length
The minimum characters allowed, if not reached it will not be possible to save.
Validation Message
If the Validation type is not satisfied when they are entering data into the control, then this message is disaplyed.
Validation Type
There are Five options for Validation Type.
- By default the control is set with "None" - the first option!
- The second option is Alpha - which means the control will only accept LETTERS entered into it.
- The third option is Alpha numeric - i.e. letter and numbers.
- The fourth option is Email - this checks that the data being entered is XXXX@XXXX.XXX format. It will only allow the object to be saved if the format is correct.
- The fifth Option is URL - similar to the email option, this will only accept format http://www.XXXXXX.XXX
Watermark
If the bound field has no content this text will be displayed in grey text.