4D v20.1
Get menu bar reference
- 4D Language Reference
-
- Menus
-
- Managing Menus
- APPEND MENU ITEM
- Count menu items
- Count menus
- Create menu
- DELETE MENU ITEM
- DISABLE MENU ITEM
- Dynamic pop up menu
- ENABLE MENU ITEM
- Get menu bar reference
- Get menu item
- GET MENU ITEM ICON
- Get menu item key
- Get menu item mark
- Get menu item method
- Get menu item modifiers
- Get menu item parameter
- GET MENU ITEM PROPERTY
- Get menu item style
- GET MENU ITEMS
- Get menu title
- Get selected menu item parameter
- INSERT MENU ITEM
- Menu selected
- RELEASE MENU
- SET HELP MENUNew
- SET MENU BAR
- SET MENU ITEM
- SET MENU ITEM ICON
- SET MENU ITEM MARK
- SET MENU ITEM METHOD
- SET MENU ITEM PARAMETER
- SET MENU ITEM PROPERTY
- SET MENU ITEM SHORTCUT
- SET MENU ITEM STYLE
Get menu bar reference
| Get menu bar reference {( process )} -> Function result | ||||||||
| Parameter | Type | Description | ||||||
| process | Longint |
|
Reference number of process | |||||
| Function result | MenuRef |
|
Menu bar ID | |||||
The Get menu bar reference command returns the ID of the current menu bar or the menu bar of a specific process.
If the menu bar was created by the Create menu command, this ID corresponds to the reference ID of the menu created. Otherwise, the command returns a specific internal ID(*). In all cases, this MenuRef ID may be used to reference the menu bar by all the other commands of the theme.
(*)This specific ID is temporary and becomes invalid as soon as another menu bar is called with SET MENU BAR. If you want to keep the reference of a menu created in the menu editor, you need to copy it in memory using Create menu. For example:
$vEditorRef:=Get menu bar reference(Frontmost process) //menu from the menu bar editor
$vMenuRef:=Create menu($vEditorRef) //copy the menu in memory
SET MENU BAR(2) //install another menu bar
... // execute code
SET MENU BAR($vMenuRef) //back to the initial menu barThe process parameter can be used to designate the process where you want to get the current menu bar ID. If you omit this parameter, the command returns the menu bar ID of the current process.
Refer to the example of the GET MENU ITEMS command.
Product: 4D
Theme: Menus
Number:
979
Created: 4D v11 SQL
4D Language Reference ( 4D v20)
4D Language Reference ( 4D v20.1)
