The Gallery Widget

View Class: UIGalleryView
Spec Class: UIGalleryViewSpec

The Gallery Widget has a similar behavior like the Note Book Widget extended by a drag and drop capability. For each page a resource specification (window spec method) with defined widgets must be created. The widgets should have the same behavior like the widgets of ST/X (means spec class is subclass of class UISpecification, and view class is subclass of class SimpleView).

The Basics Section:

ID	Unique symbolic name (ID) of the gallery. This ID can be used by the application to access the widget via `"builder>>componentAt:#ID"`.
Model	Aspect selector or binding for the selected label of the gallery. It should return a `- String` instance (only for static behavior) `- ValueModel`* instance with a `String` instance whereby `String` can also be replaced by a `Text` instance.
Label	Aspect selector or binding for holding the list of the labels of the gallery. It should return a `- Array` instance (only for static behavior) whereby the `Array` instance can also be replaced by an `OrderedCollection` instance or by a `SortedCollection` instance. They contain the items of the gallery as `String` instances, `Text` instances, or as `LabelAndIcon` instances.
From Class	Name of the class implementing the window spec methods.
Selector List	Name of the selector sent to the application returning a list of resource specification selectors.
Selection Specification	Aspect selector or binding for the resource specification of the current selected widget.

The Details Section:

Font	Defines the font style of the gallery. 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 gallery bar takes its default font style from the style sheet.
BG-Color	Defines the background color of the gallery. After selecting the check toggle the background color can be chosen by selecting the desired colored button. If no color is selected, the gallery takes its default background color from the style sheet.
Style	Defines the type of the border style of the tab item (Windows or Mac).
Orientation	Defines the side for the arrangement of the tab item (top, bottom, left, or right).
Level	Defines the width of the 3D-border. Positive values provide a raising, negative values provide a lowering of the gallery.
One Tab Per Row	Turns on/off that only one tab item is drawn per row.
Fit Tabs To View	Turns on/off that the tab items are fitted to the width of the widget's view.
Can Tab	Turns on/off that the gallery can be reached by tabbing.
Move Selected Row Down To View	Turns on/off that the row of the selected tab item is always moved down to the widget's view.

The Channels Section:

Enable

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

Select Condition Name of the selector sent to the application before a selection is performed.
It should return a Boolean instance.
If the selector ends with ':', the selector is performed with the index of the currently selected tab item as the passed argument.

Middle Button Pressed Name of the selector sent to the application when the middle button is pressed.
In the method of the selector, for example, a popup menu can be performed.

* = 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"