RemoveMenu

A version of this page is also available for

Windows Embedded CE 6.0 R3

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