Export (0) Print
Expand All

CreateMenu function

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

Syntax


HMENU WINAPI CreateMenu(void);

Parameters

This function has no parameters.

Return value

Type: HMENU

If the function succeeds, the return value is a handle to the newly created menu.

If the function fails, the return value is NULL. To get extended error information, call GetLastError.

Remarks

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.

Requirements

Minimum supported client

Windows 2000 Professional [desktop apps only]

Minimum supported server

Windows 2000 Server [desktop apps only]

Header

Winuser.h (include Windows.h)

Library

User32.lib

DLL

User32.dll

See also

Reference
AppendMenu
CreatePopupMenu
DestroyMenu
InsertMenu
SetMenu
InsertMenuItem
Conceptual
Menus

 

 

Community Additions

ADD
Show:
© 2014 Microsoft