The Extended Combo Box Widget

View Class: ExtendedComboBoxView
Spec Class: ExtendedComboBoxSpec

The ExtendedComboBox Widget is a generalized kind of ComboBox widget - in contrast to the ComboBox, which has a popUpList hardwired into itself, any other view may be used as pop up with the ExtendedComboBox.
In fact, the view as popped up can itself be described by a windowSpec.

In addition, the ExtendedComboBox provides support to scroll the popped view - which is especially required if long menu lists are to be presented.

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. The last model also provides the combo box with a list. In this case, it is not necessary to define an extra aspect for the list.
Adjust Button Right	If on, the menu button is placed at the right side; if off, its placed at the left.
Read Only	If on, the input field is read only.

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 Menu Section:

Widget	Aspect selector or binding which provides the widget which is popped up.
Max. Height	The maximum height of the popup. Scrollbars will be added, if the widget is larger.
Use Preferred Width	If on, the widget is popped with its preferred width; if off, it is popped with the comboBoxes width.
Scroll Bars	Controls if the pulled menu should have scrollbars and (if so) if those should be mini scrollers.
Auto-Hide ScrollBars	If on, scrollbars are hidden if all of the pulled menus contents is visible.

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"