This function creates a pop-up menu. The menu is initially empty. You can fill it with menu items by using the InsertMenu and AppendMenu functions.
At a Glance
Header file: | Winuser.h |
Windows CE versions: | 1.0 and later |
Syntax
HMENU CreatePopupMenu(void);
Return Values
The handle to the newly created menu indicates success. NULL indicates failure. To get extended error information, call GetLastError.
Remarks
To create a menu bar, use the CreateMenu function.
The application can add the new menu to an existing menu, or it can display a shortcut menu by calling the TrackPopupMenuEx or TrackPopupMenu functions.
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