4D v16.3
RELEASE MENU
- 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 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
RELEASE MENU
| RELEASE MENU ( menu ) | ||||||||
| Parameter | Type | Description | ||||||
| menu | MenuRef |
|
Menu reference | |||||
The RELEASE MENU command removes the menu whose ID is passed in menu from memory. This menu must have been created by the menu Create menu command. The following rule applies: for each Create menu there must be a corresponding RELEASE MENU.
The command removes every instance of the menu menu from every menu bar and every process. If the menu belongs to a menu bar which is in use, it will continue to work but can no longer be modified. It will only be truly removed from the memory when the last menu bar where it appears is no longer in use.
This command can be used with menus that are used as menu bars.
Any sub-menus used by menu are not removed if they were created directly using the Create menu command. In this case, you must remove them individually (see the rule mentioned above). However, if the submenus come from the duplication of an existing menu, do not call RELEASE MENU with them because 4D will erase them automatically.
This example shows different ways to use this command:
newMenu:=Create menu
APPEND MENU ITEM(newMenu;"Test1")
subMenu:=Create menu
APPEND MENU ITEM(subMenu;"SubTest1")
APPEND MENU ITEM(subMenu;"SubTest2") // Creation of items in submenu
APPEND MENU ITEM(newMenu;"Test2";subMenu) // Attaching submenu to menu
//At this point, the submenu is attached to the menu and if we will not need it later on, this is right place to remove it.
//Removing it does not immediately delete subMenu since it is still used by newMenu. subMenu is only deleted when newMenu is.
//Removing the submenu here lets you save memory
RELEASE MENU(subMenu)
$result1:=Dynamic pop up menu(newMenu) //Use of menu
copyMenu:=Create menu(newMenu) // Creation of menu by copying newMenu (and thus copying subMenu as well)
RELEASE MENU(newMenu) // We no longer need newMenu.
$result2:=Dynamic pop up menu(copyMenu)
RELEASE MENU(copyMenu)
//You don't need to worry about deleting the submenus of copyMenu since it was not created directly using Create menu
//The rule to follow is: each Create menu must have a corresponding RELEASE MENU
Product: 4D
Theme: Menus
Number:
978
Created: 4D v11 SQL
4D Language Reference ( 4D v16)
4D Language Reference ( 4D v16.1)
4D Language Reference ( 4D v16.2)
4D Language Reference ( 4D v16.3)
