Combo Box Widget
Allows the user to select a specific value within a list of possible values.
The list of possible values can be an Attribute of an Entity, an Attribute of a Structure or a list of special values. You can also add special values like "All" and "None" to the list fetched from an Entity or Structure.
Properties
Name | Description | Mandatory | Default value | Observations |
---|---|---|---|---|
Name | Identifies an element in the scope where it is defined, like a screen, action, or module. | Yes | ||
Variable | Holds the value entered by the user. | Mandatory if Source Entity/Structure is specified. | ||
Validation Parent | Specifies an Edit Record widget. Widgets with the same Validation Parent are validated as a group. | |||
Mandatory | Boolean literal or expression that defines if the user input is required. | Yes | No | |
Source Record List | Current list of records displayed by the widget. | |||
Source Entity | Data entity to populate the widget. | |||
Source Attribute | Specifies the attribute of the records in the list to populate the widget. | |||
Source Identifier Attribute | Attribute of the structure to be used as the identifier of the selected value. | |||
Special Variable | Holds the value selected by the user if this value belongs to the defined Special List. | The variable must be of type Text, Phone Number, Email, Boolean, Integer, or Long Integer. At runtime, if the user selects a value among the Source Entity/Structure list of values, this property will have the value "". |
||
Width | Width of the widget in columns. Other accepted units are pixels(px), points(pt), or percentage(%). Overrides the style sheet definition. | |||
Margin Left | Left margin of the widget in columns. Other accepted units are pixels(px), points(pt), or percentage(%). Overrides the style sheet definition. | |||
Margin Top | Top margin of the widget in pixels. Other accepted units are points(pt) or percentage(%). Overrides the style sheet definition. | |||
Style Classes | Specifies one or more style classes to apply to the widget. Separate multiple values with spaces. | |||
Visible | Boolean literal or expression that defines if the widget is displayed. | Yes | ||
Enabled | Boolean literal or expression that defines if the widget is editable. | Yes | ||
Extended Properties | ||||
Property | Name of an attribute to add to the HTML translation for this element. | You can pick a property from the drop-down list or type a free text. The name of the property will not be validated by the platform. Duplicated properties are not allowed. Spaces, " or ' are also not allowed. |
||
Value | Value of the attribute. | You can type the value directly or write expressions using the Expression Editor. If the Value is empty, the corresponding HTML tag is created as property="property". For example, the nowrap property does not require a value, therefore nowrap="nowrap" is added. |
||
On Change | ||||
Destination | Screen action to be executed or a screen to navigate to when the value of the element changes. | It might be necessary to specify additional input arguments. | ||
Special List | ||||
Value | Value assigned to the Special Variable. | |||
Option | Text displayed in the widget. |
Runtime Properties
Name | Description | Read Only | Type | Observations |
---|---|---|---|---|
SpecialListValue | SpecialListValue runtime property is deprecated. Consider using the Special Variable property instead. | Text | ||
Valid | Always True for Combo Boxes. You can override this property value when performing custom validation. | Boolean | ||
ValidationMessage | Message describing the built-in validation constraints not satisfied when 'Valid' is False. You can override this property value when performing custom validations. | Text | ||
Id | Identifies the widget instance at runtime (HTML 'id' attribute). You can use it in JavaScript and Extended Properties. | Yes | Text |