GEOS SDK TechDocs
|
| 
The List Objects
| 
2 Common Behavior
The list objects provide a highly flexible way to display and manage user-selectable options. Depending on the Specific UI and the type of list, these objects may be built out in a variety of fashions. In some UIs, BooleanGroups may appear as checkboxes, GenItemGroups may appear as radio buttons, etc.
You may manipulate the grouping objects in much the same way as a GIV_SUB_GROUP GenInteraction. For example, hints may alter the placement and dimensions of the grouping object's children or the list may appear with special dimensions. The items themselves are simple generic objects that can be easily added to your grouping object. The grouping object will manage the geometry and selection state of these children; it will also perform any required actions based on the state of these children.
There are three list management objects.
GenItemGroup
An all-purpose grouping object, this list may be exclusive (only one item may be selected at a time) or non-exclusive and may also have scroll bars. A GenItemGroup may only contain
GenItemClass
objects as its children.
GenBooleanGroup
This list is designed for entries that are either true of false ("on" or "off") independent of other entries. The BooleanGroup keeps track of its selections with a bitfield representing the boolean state of each of its children. A GenBooleanGroup object may only contain
GenBooleanClass
objects.
GenDynamicList
This list is designed for very long or changing length lists. In many respects it is similar to a GenItemGroup but also allows efficient dynamic lists. A GenDynamicList does not specify any explicit "children"; instead it contains a list of monikers to display to the user within a scrolling list.These are the following main list item objects:
GenItem
Objects used as entries in a GenItemGroup. In OSF/Motif, these objects appear in most cases as "diamond" settings.
GenBoolean
Objects used as entries in a GenBooleanGroup representing true or false states. In OSF/Motif, these items appear most often as selectable "boxes."The GenDynamicList does not specify any generic children, but instead will contain a list of visual monikers to cycle through a scrolling list.
GEOS SDK TechDocs
|
| The List Objects
| 2 Common Behavior