Field Properties
Description
Properties available in the "Field Properties" section for a UX Control.
- Name
- Description
- Variable name
Name of the control. Must be Unique.
- Type
The control type.
- Treat field as a Logical field
Only available if Type is set to 'Numeric'. If the field is a Numeric (Integer) field, and it contains only values of 0 or 1, then you can treat it as a Logical field and set the control type to a Checkbox.
- Default value
Specify the default value for the control.
- Validation Xbasic
Specify Xbasic code to test if the data in this field is valid.
- Validation rules
Specify rules to test if the data in this field is valid. By default, only dirty fields are validated. You can specify that all fields should be validated in Update Settings, Edit Properties. If this field is a Repeating Section, see the setting in the Repeating Section for 'Validation - field option' and 'Validation - row option'.
- Immediate validation
Defines when server-side and client-side validation is applied.
- Validation Javascript
Defines javascript used to do client-side validation of data entered into an application.
- Class
Specify the class name for the control. <Default> will use the default class name for the style name selected.
- Style
Specify the in-line style for the control.
- Width
Specify the control's width. Use CSS units (e.g. 1in, 200px, etc.) If you specify a width here and also in the 'style' property, this value will be used. Leave blank to use the default width.
- Height
Specify the control's height. Use CSS units (e.g. 1in, 200px, etc.) If you specify a height here and also in the 'style' property, this value will be used. Leave blank to use the default height.
- Container in-line style
Only applies to controls that have a smart field button - e.g. Lookups, Date/Time pickers, In-control buttons. Specify style attributes for the container for the control. The container encloses both the input control and the smart field button.
- Break
Force a column break after this control.
- Break height
Only available if Break is set to 'After'. Specify the vertical distance between this control and the next control. Use CSS syntax, e.g. 10px, .5in, 20pt, etc.
- Horizontal spacer
Only available if Break is set to 'None'. Specify the horizontal distance between this control and the next control. Use CSS syntax, e.g. 10px, .5in, 20pt, etc.
- Hide
Specify if this control should be hidden. Controls are typically hidden so that they can be manually placed into the HTML in a 'Free-form Container'.
- Has help
Specify if there is help for this field. The help will appear in a window when the user presses F1. The Help text is read from a database. Go to the Properties pane to configure the Help database source. The Help Window style can either be a pop-up window or a dropdown window. To configure the Help Window style, go to the Properties pane and set the 'Field help window style' property.
- Help ID
Only available if Has help is enabled. Specify the Help ID. The help text for this field is looked up in the Help table using this ID as the key.
- Show help icon
Only available if Has help is enabled. Specify if an icon should be shown next to the control to indicate help is available for this control.
- Help icon
Only available if Show help icon is set to 'LeftOfControl' or 'RightOfControl'. Specify the icon to show next to the field control. Clicking or hovering over this icon will show the help text for the field.
- Help icon behavior
Only available if Show help icon is set to 'LeftOfControl' or 'RightOfControl'. Specify the action when the user clicks the help icon or moves the mouse over the help icon.
- Captcha form validation
Specify if a Captcha image should be displayed for this control. The user will need to enter the text shown in the Captcha image in order to submit the UX Component.
- Number of characters
Only available if Captcha form validation enabled. Specify the number of characters to display in the Captcha image.
- Image height
Only available if Captcha form validation enabled. Specify the height (in inches) of the Captcha image.
- Image width
Only available if Captcha form validation enabled. Specify the width (in inches) of the Captcha image.
- Refresh icon
Only available if Captcha form validation enabled. Specify the icon for the 'Refresh' button. This is the button that the user can click to get a new Captcha image if the text in the current image is too hard to read.
- Refresh icon help
Only available if Captcha form validation enabled. Specify the bubble help for the refresh icon for the Captcha image.
- Captcha error text
Only available if Captcha form validation enabled. Specify the error text to show if the user does not enter the correct text into the Captcha control when submitting the UX Component.
- Initial focus
Specify if this control should have focus when the UX Component is first shown. If you check this property on more than one control, the first control checked will get focus.
- Control container class name
Advanced/Optional. All controls are automatically wrapped in a div with a class name of 'A5CWLayout' or 'A5container', unless the control is a 'NoFloat' container. You can specify a class name to use for the control container in addition to the 'A5CWLayout' or 'A5container' class that is automatically assigned. This allows you to have more control over the appearance of the control.
- Control container prevent float
Advanced/Optional. All controls are automatically wrapped in a div with a class name of 'A5CWLayout' or 'A5container', unless the control is a 'NoFloat' container. This container automatically 'floats' the control, aligning controls in a flow layout from left to right until a control with a 'break' is encountered. In addition, the class adds padding around the control. By checking this property, you are removing the 'A5CWLayout' or 'A5container' class from the div container enclosing this control.