Menu Items
A menu item can be a menu option that results in an action, a reference to another menu, such as a cascaded menu or included menu, or a separator for grouping items. Menu items have associated triggers in which to program the conditions under which they are displayed and the action they perform.
You can define the following types of menu item:
Item type | Available In | Triggers | Description |
---|---|---|---|
Menu Option | Drop-down Pop-up |
preDisplay
select |
Performs an action, such as activating a form or structure editor function. |
Dynamic Menu | Drop-down Pop-up |
preDisplay
select |
Placeholder where additional menu items can be inserted at runtime by $inlinemenu ProcScript statements in the preDisplay trigger. |
Cascaded Menu | Drop-down Pop-up |
preDisplay | References a drop-down menu, displaying
its contents as a separate menu cascading from the current menu. Use a cascading menu to include additional items in a menu that would otherwise cause the menu to be too long. For usability, don't define more than three levels of cascading menus. |
Included Menu | Drop-down Pop-up |
None |
References a drop-down menu, copying its contents into the current menu during compilation. Use included menus to avoid duplicating menu item definitions. |
Separator | Drop-down Pop-up |
preDisplay | Horizontal dividing line used to separate groups of related items. |
Drop-down Menu | Menu Bar | preDisplay | References a drop-down menu. |
Right Align Marker | Menu Bar | preDisplay | Causes subsequent items to be displayed on
the right side of the application window. Only one of these should or needs to be present in a menu bar. |
Caution: Do not specify a cascading menu item or an included menu item to refer to the menu itself or to a menu above this menu in the menu structure. Doing so creates a circular definition that can result in application errors.
Icons in Menus
The text of menu items in cascading and dynamic menus can be preceded by an icon. To add an icon to a menu item, specify the item as a gold-separated string consisting of an image or glyph name and the text. For more information, see Define and Use Menus.