AppendMenu (Compact 2013)

  • Article

3/28/2014

This function appends a new item to the end of the specified menu. You can use AppendMenu to specify the content, appearance, and behavior of the menu item.

Syntax

BOOL AppendMenu(
  HMENU hMenu,
  UINT uFlags,
  UINT uIDNewItem,
  LPCTSTR lpNewItem
);

Parameters

  • hMenu
    [in] Handle to the menu bar, drop-down menu, submenu, or shortcut menu to be changed.

  • uFlags
    [in] Specifies flags to control the appearance and behavior of the new menu item. This parameter must be a combination of the values listed in Menus Constants.

    If this parameter includes the MF_SEPARATOR constant, AppendMenu ignores the values of the lpNewItem and uIDNewItem parameters. If this parameter includes the MF_STRING constant, the lpNewItem parameter points to the string. MF_OWNERDRAW cannot be used with the MF_STRING or MF_SEPARATOR constants.

  • uIDNewItem
    [in] Either the identifier of the new menu item or, if the uFlags parameter is set to MF_POPUP, the handle to the drop-down menu or submenu.
  • lpNewItem
    [in] Long pointer to the content of the new menu item. If uFlags includes the MF_STRING constant, lpNewItem points to a null-terminated string (the default). If uFlags includes the MF_OWNERDRAW constant, lpNewItem points to a 32-bit value that can be used to maintain additional data related to the menu item.

Return Value

Nonzero indicates success. Zero indicates failure. To get extended error information, call GetLastError.

Remarks

The application must call the DrawMenuBar function when a menu changes, whether or not the menu is in a displayed window.

To get keyboard accelerators to work with bitmap or owner-drawn menu items, the owner of the menu must process the WM_MENUCHAR message.

Requirements

Header

winuser.h

See Also

Reference

Menu Functions
CreateMenu
DeleteMenu
DestroyMenu
InsertMenu
RemoveMenu
WM_DRAWITEM
WM_MEASUREITEM
WM_MENUCHAR
Menu Constants