Combo Box

A component that combines an editable field and a drop-down list. The user can select a value from the drop-down list. If you make the combo box editable, then the combo box includes an editable field into which the user can type a value.

This is what a combo box looks like:

The Type of Selected Item property and the type of data in the Value column of the Selection Values tabular property is dynamic. It cannot be manually changed from the GUI Builder, but it is changed by the binding whose target points to the Selection Values property of Combo Box. This binding rewrites the Selection Values table. The binding is automatically created when dragging a field that has selection values to a combo box.

Common Properties

Width, Height, Bindings, Enabled, Visible, Foreground, Background, Opaque, Border, Font, Cursor, Tooltip, Focusable, Popup Menu

Custom Properties

Maximum Displayed Row Count

Sets the maximum number of rows the Combo Box displays. If the number of items greater than count, the combo box uses a scrollbar.

Property name: maximumRowCount

Property type: Integer

Selection Values

List of items available in the combo box.

Property name: options

Property type: Data Table

It is possible to fill a Combo Box with selection values of a certain Data Table field using a binding. For example, binding that will fill a Combo Box with the countries available in the Country field of User Information variable defined in the User context of user admin will look as follows:

Target: form/comboBox1:options

Expression: {users.admin:childInfo$country#options}

Selected Item

(Default Property)

Item selected by default.

Property name: selectedItem

Property type: Dynamic

Selected Item Color

(Default Property)

Defines color of selected item.

Property name: selectedItemColor

Property type: Color

Use Custom Button Color

Enables the usage of custom button properties defined by the Button Properties property.

Property name: useCustomButtonProperties

Property type: Boolean

Button Properties

Sets background, foreground, and border colors for the combo box button.

Property name: buttonProperties

Property type: Data Table

Fields of Button Properties:

Field

Type

Description

foreground

Color

Foreground color of the combo box button

background

Color

Background color of the combo box button

border

Color

Border color of the combo box button

Searchable

Enables auto-completion of values that are typed in the combo box.

Property name: searchable

Property type: Boolean

Common Events

Hidden, Shown, Moved, Resized, Mouse Clicked, Mouse Pressed, Mouse Released, Mouse Entered, Mouse Exited, Mouse Moved, Mouse Wheel Moved, Key Typed, Key Pressed, Key Released, Focus Gained, Focus Lost

Was this page helpful?