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:

Types of Menu Items
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.

Related Topics