Get menu item key

version 11 (Modified)

Get menu item key (menu; menuItem{; process}) Number

The Get menu item key command returns the code of the Ctrl (Windows) or Command (Macintosh) shortcut for the menu item whose menu number or reference is passed in menu and whose item number is passed in menuItem. You can pass -1 in menuItem in order to indicate the last item added to menu.

If you omit the process parameter, Get menu item key applies to the menu bar for the current process. Otherwise, Get menu item key applies to the menu bar for the process whose reference number is passed in process.

Note: If you pass a MenuRef in menu, the process parameter serves no purpose and will be ignored.

If the menu item has no associated shortcut or if the menuItem parameter designates a hierarchical submenu, Get menu item key returns 0 (zero).

To obtain the shortcut associated with a menu item, it is useful to implement a programming structure of the following type:

   If(Get menu item key(mymenu;1) # 0)
      $modifiers:=Get menu item modifiers(mymenu;1)
      Case of
         : ($modifiers=Option key mask)
            ...
         : ($modifiers=Shift key mask)
            ...
         : ($modifiers=Option key mask + Shift key mask)
            ...
      End case
   End if

Get menu item key, SET MENU ITEM SHORTCUT.