The Combo List Widget

View Class: ComboListView
Spec Class: ComboListSpec

The Combo List Widget is a combination of the Entry Field Widget and the List Widget. The entry field is always visible and in read only mode. 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 list. 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 list. 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. The last model also provides the combo list with a list. In this 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 list. 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 list 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.

The Details Section:

Font	Defines the font style of the combo list. 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 list takes its default font style from the style sheet.
FG-Color	Defines the foreground color of the combo list. After selecting the check toggle the foreground color can be chosen by selecting the desired colored button. If no color is selected, the combo list takes its default foreground color from the style sheet.
BG-Color	Defines the background color of the combo list. After selecting the check toggle the background color can be chosen by selecting the desired colored button. If no color is selected, the combo list takes its default background color from the style sheet.
Initially Disabled	Turns on/off that the combo list is initially disabled.
Initially Invisible	Turns on/off that the combo list is initially invisible.
Can Tab	Turns on/off that the combo list can be reached by tabbing.

The Channels Section:

Enable

Aspect selector or binding for en-/disabling the combo list.
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 list.

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

The Help Section:

see "Using the Help Tool"

The Layout Section:

see "The Layout of the Widgets"