RemoveMenu
A version of this page is also available for
4/8/2010
This function deletes a menu item from the specified menu. If the menu item activates a pop-up menu, RemoveMenu does not destroy the pop-up menu or its handle, allowing the menu to be reused. Before RemoveMenu is called, the GetSubMenu function should retrieve the handle to the pop-up menu.
Syntax
BOOL RemoveMenu(
HMENU hMenu,
UINT uPosition,
UINT uFlags
);
Parameters
- hMenu
[in] Handle to the menu to be changed.
- uPosition
[in] The menu item to be deleted, as determined by the uFlags parameter.
- uFlags
[in] Constant specifying how the uPosition parameter is interpreted. This parameter must be either the MF_BYCOMMAND constant or the MF_BYPOSITION constant. For more information, see Menus Constants.
Return Value
Nonzero indicates success. Zero indicates failure. To get extended error information, call GetLastError.
Remarks
The application must call the DrawMenuBar function whenever a menu changes, whether or not the menu is in a displayed window.
Requirements
Header | winuser.h |
Library | Menu.lib |
Windows Embedded CE | Windows CE 1.0 and later |
Windows Mobile | Windows Mobile Version 5.0 and later |
See Also
Reference
CreatePopupMenu
DeleteMenu
GetSubMenu
Menus Functions
Menus Constants