The List Widget

View Class: SequenceView
Spec Class: SequenceViewSpec

The List Widget is used to display a list of text items, from which individual items can be selected.

ID	Unique symbolic name (ID) of the widget. This ID can be used by the application to access the widget via "`builder>>componentAt:#`ID".
Model	Aspect selector or binding for the widgets model. Typically, the name of a method implemented in the application, which returns the model. The model can be either a SelectionInList instance (which holds both the list and the selection), or a `ValueModel`* instance, holding the selection alone.
List	Aspect selector or binding for the lists contents. Typically, the name of a method implemented in the application, which returns the list; usually, either a collection or `ValueModel`* instance, holding some collection. For constant lists, the field may also specify an array-literal, containing the lists string items. (i.e. #('item1' 'item2' 'item3' ...)
Index	If on, the selection is kept as an index (or a collection of indices). If off, the selection holds the selected item itself (or a collection of items).

Popup Menu Selector	Aspect selector or binding for the building of a popup menu for the list widget. It should return a menu spec or a menu.
Popup Menu Performer	Aspect selector or binding for sending the messages of the popup menu items to an object. It should return an object which is able to receive the messages as specified in the menu items. If blank, the application gets the menu messages.
Menu Editor	Opens a Menu Editor on the popup menu spec.

Vertical Scroll Bar	Turns on/off that the list widget provides vertical scrolling capabilities.
Vertical Mini Scroll Bar	Turns on/off that the list widget uses a small vertical scroll bar. This attributes can only be set, if the attribute Vertical Scroll Bar is turned on.
Horizontal Scroll Bar	Turns on/off that the list widget provides horizontal scrolling capabilities.
Horizontal Mini Scroll Bar	Turns on/off that the list widget uses a small horizontal scroll bar. This attributes can only be set, if the attribute Horizontal Scroll Bar is turned on.
Auto Hide	Controls autoHiding of scrollbars. If on, scrollbars hide themself, if the contents is smaller than the scrolled view. If off, scrollBars never hide themSelf. If set to default, the autoHide feature is controlled by the viewStyle and scrollbars behave "natural" for the operating system. (true for windows, false for most unix-styles).

Font	Defines the font style of the widget. 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 widget takes its default font style from the style sheet.
FG-Color	Defines the foreground color of the widget. After selecting the check toggle the foreground color can be chosen by selecting the desired colored button. If no color is selected, the widget takes its default foreground color from the style sheet.
BG-Color	Defines the background color of the widget. After selecting the check toggle the background color can be chosen by selecting the desired colored button. If no color is selected, the widget takes its default background color from the style sheet.
Border	Defines the width of the border.
Level	Defines the width of the 3D-border. Positive values provide a raising, negative values provide a lowering of the widget.

Allow multiple selections	If off, only a single item may be selected, If off, multiple items may be selected (shift-click), and the selection will consist of a collection.
Initially Disabled	Turns on/off that the widget is initially disabled.
Initially Invisible	Turns on/off that the widget is initially invisible.
Can Tab	Turns on/off that the widget can be reached by tabbing.

Enable

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

Dbl-Click

Aspect selector or binding for a valueHolder which gets notified of double clicks.
It should return one of

- Block instance which will be evaluated on double click
- ValueModel* instance which gets an index-value on double click.

Selected	Method invoked when the selection changes. This defines the name of a method in the application, which will be invoked whenever the selection changes. Using a callback may be more convenient than adding a change interest on the model (i.e. defining a notification with #onChange:send:to:).
Dbl-Click	Method invoked on double click. This defines the name of a method in the application, which will be invoked whenever the user double clicks on an item.

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

see document "Implementing Drag and Drop"

see document "Using the Help Tool"