Navigation items in the WMC are identified by Navigation Paths. These paths describe the hierarchy of how the item is arranged with respect to other nodes. The root node of the Navigation Path indicates the type of navigation item.
| Node | Description |
|---|---|
| NAVIGATIONTREE | A Navigation Path that identifies an item in the navigation tree |
| HELP | A Navigation Path that identifies a help pane item |
| TASKLIST | A Navigation Path that identifies an item in the task list that sits below the navigation tree in the WMC |
| MESSAGEBAR | A Navigation Path that identifies an item in the navigation bar at the top of the WMC |
e.g. NAVIGATIONTREE\ControlPanel\Events refers to the Events item that sits under the Control Panel node in the navigation tree.
NavInsertItem takes a Navigation Path and uses it to create an item for that path. The 4 separate types of navigation items have their own hierarchy and you cannot put one type into another hierarchy. The paths can be any path that you define (Apart from the root item) and have little bearing on each other apart from help items and navigation tree items which are discussed below.
Navigation Tree Items and Help
NAVIGATIONTREE and HELP items share a special relationship in the WMC. When a user navigates to an item in the navigation tree, the HELP item with that has a sub path that is the same as the Navigation Path of the item is queried and the resulting content is used to populate the help pane. Therefore, to get help working for your component you should register a HELP such that it has a Navigation Path that is the same as the one used for the NAVIGATIONTREE item. e.g.
Complete Navigation Path of navigation tree item: NAVIGATIONTREE\ControlPanel\MyComponent
Complete Navigation Path of help item: HELP\NAVIGATIONTREE\ControlPanel\MyComponent
In order to ensure the paths match, you can get the navigation path for the tree item with NavGetItem and use the strFQN field as the path passed to NavInsertItem for the help item. The following example inserts an item under the Control Panel item in the tree and associates dynamic help with it.
Aliases
Navigation Paths can have aliases that are used to quickly reference a path without having to know the entire underlying path. NavInsertItem allows you to specify an alias when you add the item. It must consist of a '{' character followed by the (case sensitive) alias name and a '}'. e.g {ControlPanel} references the Control Panel node in the navigation tree whose real Navigation Path is NAVIGATIONTREE\ControlPanel
Help
HELP\NAVIGATIONTREE\Header - All Header items are put into header of help, regardless of location in tree
HELP\NAVIGATIONTREE\Main