Combo Box

Top  Previous  Next

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.

gb_component_combobox

This is what a combo box looks like:

ls_widgets_combo_box

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, Tooltip

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

note_tip-wt

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}

This binding is created automatically when dragging a variable field to a Combo Box in GUI Builder. Check details here.

Selected Item (Default Property)

Item selected by default.

Property name: selectedItem

Property type: dynamic

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