Table of the Widgets The Table Wigdet
 

The Selection List Widget

View Class: SelectionInListModelView
Spec Class: SelectionInListModelViewSpec

The Selection List Widget is used to display any list derived from List. The widget supports different heights of labeled strings or icons and different types of items (not only Strings ..).
The widget doesn't keep its own list of items, it works directly on the model.


The Basics Section:

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 a ValueModel* instance.
List Aspect selector or binding for the lists.
Typically, the name of a method implemented in the application, which returns the list or the model, a ValueModel* instance, which keeps the list.
The list must derive from List.
Index Defines the selection value
the index(indices) into the list or the selected item(s)
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.
 
 

The Details1 Section:

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.
Highligt Mode Highligting the Selection 
- line: the whole line is highlighted.
- label: only the label is highlighted.
Multiple Selections allow / disallow multiple selections. If enabled, the user may select multiple items in the list, and the program always gets a collection of selected items or indices.
 
 

The Details2 Section:

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.
 
 

The Channels Section:

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.

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

 

The Drag & Drop Section:

see document "Implementing Drag and Drop"
 
 

The Help Section:

see document "Using the Help Tool"
 
 

The Layout Section:

see document "The Layout of the Widgets"
 
 


[stx-logo]
Copyright © 1998 eXept Software AG, all rights reserved