Table of the Widgets The Table Wigdet
 

The Hierarchical List Widget

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


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 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.
 
 

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.
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.
 
 

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.
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).
 * = 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