The Combo Box Widget

View Class: ComboBoxView
Spec Class: ComboBoxSpec

The Combo Box Widget is a combination of the Entry Field Widget and the List Widget. The entry field is always visible and serves for adding new items to the list or removing existing ones from the list. The list is only displayed whenever the user clicks on the widget's view.

The Basics Section:

ID	Unique symbolic name (ID) of the combo box. This ID can be used by the application to access the widget via `"builder » componentAt:#ID"`.
Model	Aspect selector or binding for the selection (and list) of the combo box. It should return a `- String` instance (only for static behavior) `- ValueModel`* instance with a `String` instance `- SelectionInList` instance with a `Array` instance (and optional with an initial selection index) whereby `String` can also be replaced by a `Text` instance. If an instance of selectionInList is used as model, this one also provides the combo box with a list. In that case, it is not necessary to define an extra aspect for the list.
List	Aspect selector or binding for holding the list of the combo box. It should return a `- Array` instance (only for static behavior) `- List` instance `- ValueModel`* instance with a `Array` instance whereby the `Array` instance can also be replaced by an `OrderedCollection` instance or by a `SortedCollection` instance. They contain the items of the combo box as `String` instances, `Text` instances, or as `LabelAndIcon` instances.
Index	Turns on/off that the value model of the selection (model) is provided by the current list index of the item. If not turned on, the item itself is set in the value model.

For the attributes concerning the entry field, read the documentation of the "The Entry Field Widget".

The Details Section:

Font	Defines the font style of the combo box. After selecting the check toggle the font style can be chosen by selecting one of the Family/Face/Style/Size buttons. If no font style is selected, the combo box takes its default font style from the style sheet.
FG-Color	Defines the foreground color of the combo box. After selecting the check toggle the foreground color can be chosen by selecting the desired colored button. If no color is selected, the combo box takes its default foreground color from the style sheet.
BG-Color	Defines the background color of the combo box. After selecting the check toggle the background color can be chosen by selecting the desired colored button. If no color is selected, the combo box takes its default background color from the style sheet.
Initially Disabled	Turns on/off that the combo box is initially disabled.
Initially Invisible	Turns on/off that the combo box is initially invisible.
Can Tab	Turns on/off that the combo box can be reached by tabbing.

For the attributes concerning the entry field load the document "The Entry Field Widget".

The Channels Section:

Enable

Aspect selector or binding for en-/disabling the combo box.
It should return a

- Boolean instance** (only for static behavior)
- ValueModel* instance with a Boolean instance**

A value model is used to provide a dynamically changing of the ability of the combo box.

* = ValueHolder, AspectAdaptor, BufferedValueHolder, RangeAdaptor, TriggerValue
** = true, false

The Help Section:

see document "Using the Help Tool"

The Layout Section:

see document "The Layout of the Widgets"