Nodes in the Menu Tree
Description
The Menu Tree can contain different types of nodes, each representing a specific menu component. These node types are:
Menubar nodes, to define menubars,
Toolbar nodes, to define toolbars,
Popup menu nodes, to define popup menus,
Menu item nodes, to define menu or toolbar actions,
Page navigation nodes, to define a set of menu items at once that allow the end-user to navigate through pages, and
Separator nodes, to define separator lines (in popup menus) or separator spaces (on toolbars).
In addition to these nodes that are closely related to the components of a menu(bar) or toolbar, two other types of nodes are only used for structuring the Menu Tree itself. These structuring nodes are:
a project or library root node, and
Section nodes, to group the menubars, toolbars and popup menus that you create.
The following table shows the allowed parent-child relations in the Menu Tree.
Parent Child |
Root |
Section |
Menubar |
Toolbar |
Popup Menu |
Section |
✓ |
✓ |
|||
Menubar |
✓ |
✓ |
|||
Toolbar |
✓ |
✓ |
|||
Popup menu |
✓ |
✓ |
✓ |
✓ |
|
menu item |
✓ |
✓ |
|||
Navigator |
✓ |
||||
Separator |
✓ |
✓ |
Note
As follows from the table describing the parent-child relations, menu items, page navigation and separator nodes are always leaf nodes in the Menu Tree.
A menu item can be positioned as a child of a popup menu or as a child of a toolbar. As part of a popup menu, a menu item appears as a command in the menu. As part of a toolbar, a menu item appears as a button on the toolbar.
Usually, a toolbar button relates to a specific command in the menu. In the Menu Builder, you can easily achieve this by creating a duplicate of the menu item, and position this duplicate as child of the toolbar node. Using a duplicate instead of a copy improves the maintainability of the Menu Tree.
Learn more about