4D v14.3

Get menu item key

Home

 
4D v14.3
Get menu item key

Get menu item key 


 

Get menu item key ( menu ; menuItem {; process} ) -> Function result 
Parameter Type   Description
menu  Longint, MenuRef in Menu number or Menu reference
menuItem  Longint in Menu item number or -1 for the last item added
process  Longint in Process reference number
Function result  Longint in Character code of standard shortcut key associated with the menu item

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).

Example  

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

 
PROPERTIES 

Product: 4D
Theme: Menus
Number: 424

Not for server

 
HISTORY 

Modified: 4D v11 SQL

 
SEE ALSO 

Get menu item key
SET MENU ITEM SHORTCUT

 
ARTICLE USAGE

4D Language Reference ( 4D v12.4)
4D Language Reference ( 4D v11 SQL Release 6)
4D Language Reference ( 4D v14 R3)
4D Language Reference ( 4D v14 R2)
4D Language Reference ( 4D v13.5)
4D Language Reference ( 4D v14.3)
4D Language Reference ( 4D v14 R4)