The PopUp List Widget

View Class: PopUpList
Spec Class: PopUpListSpec

The PopUp List Widget is used to provide always displayed selection on a list. The list is only displayed, if the widget's view is selected (the list pops up). The selected item stay displayed as the current selection.

The Basics Section:

ID	Unique symbolic name (ID) of the popup 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 popup 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 the `String` instance can also be replaced by a `Text` instance. The last model also provides the popup 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 popup 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 popup 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.
Default	Default label. It is used, if nothing is selected.

The Details Section:

Font	Defines the font style of the popup 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 popup list takes its default font style from the style sheet.
Resize For Label	Turns on/off that the popup list resizes its layout for a changed label string.
Initially Disabled	Turns on/off that the popup list is initially disabled.
Initially Invisible	Turns on/off that the popup list is initially invisible.
Can Tab	Turns on/off that the popup list can be reached by tabbing.
Show Handle	If on, a menu handle is displayed.

The Channels Section:

Enable

Aspect selector or binding for en-/disabling the popup 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 popup 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"