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

Specify if the value in the field should be validated as soon as you tab out of the field, or in the case of a radio button, dropdownbox, or checkbox control, as soon as you change a value. The 'server-side' option will generate an Ajax callback, so you should try to limit the number of fields that require real-time server-side validation.

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.