CreateMenu

This function creates a menu. The menu is initially empty, but it can be filled with menu items by using the AppendMenu and InsertMenu functions.

At a Glance

Header file: Winuser.h
Windows CE versions: 1.0 and later

Syntax

HMENU CreateMenu(void);

Return Values

The handle to the newly created menu indicates success. NULL indicates failure. To get extended error information, call GetLastError.

Remarks

To add submenus to a menu bar, use the CreatePopupMenu function.

Resources associated with a menu that is assigned to a window are freed automatically. If the menu is not assigned to a window, an application must free system resources associated with the menu before closing. An application frees menu resources by calling the DestroyMenu function.

See Also

AppendMenu, DestroyMenu, InsertMenu