Legacy Document

Inside Macintosh: Macintosh Toolbox Essentials /

Chapter 3 - Menu Manager / Menu Manager Reference

Menu Manager Routines / Getting and Setting the Appearance of Menu Items

GetItemCmd

Use the GetItemCmd procedure to get the value of the keyboard equivalent field of a menu item.

PROCEDURE GetItemCmd (theMenu: MenuHandle; item: Integer;
                      VAR cmdChar: Char);

theMenu

A handle to the menu record of the menu containing the menu item whose keyboard equivalent field you wish to get.

item

The item number of the menu item. The GetItemCmd procedure returns the keyboard equivalent field of this item.

cmdChar

The value of the item's keyboard equivalent field. The Menu Manager uses this value to map keyboard equivalents to menu commands or to indicate special characteristics of the menu item.

If the cmdChar parameter contains $1B, the menu item has a submenu; a value of $1C indicates that the item has a script code; a value of $1D indicates that the Menu Manager reduces the item's 'ICON' resource; and a value of $1E indicates that the item has an 'SICN' resource.

DESCRIPTION

The GetItemCmd procedure returns the value in the keyboard equivalent field of the specified menu item in the cmdChar parameter (or 0 if the item doesn't have a keyboard equivalent, submenu, script code, reduced icon, or small icon).