PLACEMENT (numeric)

Works in conjunction with PARENT to determine where new items are located in the hierarchy. The PLACEMENT value affects the location within a given sublevel (that is, the list of items that have the same parent). If PLACEMENT is set to a valid item ID (whose parent is PARENT), the new item is placed immediately after this item. Alternatively, you can use any one of the following special values (defined in acugui.def):

TVPLACE-FIRST     Item placed first in the list
TVPLACE-LAST Item placed last in the list
TVPLACE-SORT Item sorted alphabetically in the list

The default setting is TVPLACE-LAST.

In the following example, items are sorted alphabetically except at the top level:

77  ID-1        USAGE POINTER.
77  ID-2        USAGE POINTER.

MODIFY TREE-VIEW-1, ITEM-TO-ADD = "Ordinals", GIVING ID-1
    PARENT = ID-1, PLACEMENT = TVPLACE-SORT,
    ITEM-TO-ADD = ( "First", "Second", "Third", "Fourth" )
    PARENT = 0, PLACEMENT = TVPLACE-LAST,
    ITEM-TO-ADD = "Cardinals", GIVING ID-2,
    PARENT = ID-2, PLACEMENT = TVPLACE-SORT,
    ITEM-TO-ADD = ( "One", "Two", "Three", "Four" ).

The resulting tree looks like this:

BKININCTRL24-low.gif

Note: The Ordinals and Cardinals appear in the order added (TVPLACE-LAST), although the items under each are sorted alphabetically (TVPLACE-SORT).