View Class: HierarchicalListView
Spec Class: HierarchicalListViewSpec
The Hierarchical List Widget is used to display a hierarchical
list of class HierarchicalList. The widget supports different heights of
labeled strings or icons. The item class is user defined but
has to derive from HierarchicalItem. All services required by the
item class are defined in the category protocol ....
The widget doesn't keep its own list of items, it works directly on the model.
see also: HierarchicalList, HierarchicalItem
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 HierarchicalList. |
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. |
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. |
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. |
Show Lines | Turns on/off drawing of horizontal and vertical lines |
Show Indicator For Root |
Turns on/off drawing the indicator (+/-) for the root item; the first item into the list. |
Enable | Aspect selector or binding for en-/disabling
the widget.
It should return a - Boolean instance** (only for static behavior)
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. |
Indicator | Method invoked when clicking on the indicator (+/-).
This defines the name of a method in the application, which will be invoked whenever the user clicks on an indicator. |
Resource | Fetch Icons and Images
The name of the optional method provided by the application to retrieve icons identified by an unique key during startup of the widget. The result of the service must derive from Dictionary (key->icon). |
Copyright © 1998 eXept Software AG, all rights reserved