AppendMenu (Windows CE 5.0)

  • Article

Send Feedback

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.

BOOLAppendMenu(HMENUhMenu, UINTuFlags, UINTuIDNewItem, LPCTSTRlpNewItem );

Parameters

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

  • uFlags
    [in] Constants to control the appearance and behavior of the new menu item. This parameter can 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.

  • 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 Values

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.

Windows CE 1.0 does not support cascading menus. If you are using Windows CE 1.0, you cannot insert an MF_POPUP menu into another pop-up menu. In Windows CE 2.0 and later, cascading menus are supported.

Requirements

OS Versions: Windows CE 1.0 and later.
Header: Winuser.h.

See Also

CreateMenu | DeleteMenu | DestroyMenu | InsertMenu | RemoveMenu | WM_DRAWITEM | WM_MEASUREITEM | WM_MENUCHAR | Menus Functions | Menus Constants

Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.