CreatePopupMenu
The CreatePopupMenu
function creates a drop-down menu, submenu, or shortcut menu. The menu is
initially empty. You can insert or append menu items by using the InsertMenuItem function. You can also use
the InsertMenu
function to insert menu items and the AppendMenu function to append menu
items.
HMENU CreatePopupMenu(VOID)
Parameters
This function
has no parameters.
Return Values
If the
function succeeds, the return value is the handle to the newly created menu.
If the
function fails, the return value is NULL.
Remarks
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.
Windows
95: The system can support a maximum
of 16,364 menu handles.
See Also