Menu Items

 

A menu item defines an individual choice on a menu. There are four different forms of menu item definition:

 

MenuItem "item name" {options} menu "menu name"

MenuItem "item name" {options} macro "macro name"

MenuItem "item name" {options} dbox "dbox name"

MenuItem "item name" {options} do

     <statements go here>

     endItem

 

If a menu item is defined with the menu keyword, it indicates a popup menu. The top-level menu in a menu system, which is displayed horizontally as the menu bar instead of vertically, typically contains only this type of menu item.

 

If a menu item is defined with the macro keyword, the named GISDK macro is run when the user chooses the menu item. If a menu item is defined with the dbox keyword, the named dialog box is run when the user chooses the item. If a menu item is defined with the do ... endItem section, the statements are executed when the user chooses the menu item.

 

Menu Item Options	Description
Key: hotkey,shortcutkey	The hotkey and shortcut keyboard combinations the user can press to activate the menu item instead of using the mouse. For more information, see Keyboard Combinations for Menu Items.
Disabled	The menu item is initially disabled.
Checked	The menu item is initially checked.
Help: help_specs	Help information used to index the Maptitude Help system and display in the status bar. The help information is one or two quoted strings separated by a comma. The first is a topic in the Maptitude Help system. The second is displayed in the status bar. Help strings can be string expressions.
Text: string	The text of the menu item. If this option is omitted, the name of the menu item is used instead.
MRU	The list of most recently used files, specified by SetMRUFiles(), is placed in the menu before the item given the MRU option. Only one menu item can be given the MRU option.

 

Some examples of menu items are:

 

MenuItem "Options" menu "options menu"

MenuItem "Configure..." Disabled Dbox "configuration setup"

MenuItem "autoconfig" Text: "Auto Configure" Macro "auto config"

MenuItem "Exit" key: alt_x do

     Exit()

     endItem