Expanding and collapsing items in the navigation bar

When you open a form with a vertical navigation bar field with traditional navigation bar items, all the items are initially collapsed. You can expand or collapse all the items of the navigation bar field simultaneously; that is, you do not have to click all the nodes individually to search for the required node. (This feature is supported for traditional navigation bar items only.)

To enable this, use the following parameter and syntax: 

PERFORM-ACTION-NAV-FIELD-SET-SELECTED-ITEM FieldID state

• FieldID is the field ID of the navigation bar or the navigation bar item.
• state (optional) is used to preserve backward compatibility. Its value can be one of the following:
  • 0—Collapse all items recursively
  • 1—Expand all items recursively
  • 2—Collapse single level
  • 3—Expand single level

Example 1: Expanding all items in the navigation bar field recursively

To expand all the items in the navigation bar field, execute the following command by providing the vertical navigation bar field ID:

PERFORM-ACTION-NAV-FIELD-SET-SELECTED-ITEM 536870978 1

Example 2: Expanding an item in the navigation bar field at a single level

To expand only a single item in the navigation bar field (non-recursively), execute the following command by providing the vertical navigation bar field ID:

PERFORM-ACTION-NAV-FIELD-SET-SELECTED-ITEM 536871021 2

If you specify a navigation bar field ID (as given in the following command), instead of the vertical navigation bar field ID, the first level in the navigation bar will be expanded.

PERFORM-ACTION-NAV-FIELD-SET-SELECTED-ITEM 536870978 2

Example 3: Selecting a navigation item with highlight

To select a navigation item with highlight, execute the following command by providing a leaf node with no options:

PERFORM-ACTION-NAV-FIELD-SET-SELECTED-ITEM 536870980