GetMenu function

Retrieves a handle to the menu assigned to the specified window.

Syntax

HMENU GetMenu(
  HWND hWnd
);

Parameters

hWnd

Type: HWND

A handle to the window whose menu handle is to be retrieved.

Return Value

Type: HMENU

The return value is a handle to the menu. If the specified window has no menu, the return value is NULL. If the window is a child window, the return value is undefined.

Remarks

GetMenu does not work on floating menu bars. Floating menu bars are custom controls that mimic standard menus; they are not menus. To get the handle on a floating menu bar, use the Active Accessibility APIs.

Examples

For an example, see Adding Lines and Graphs to a Menu.

Requirements

   
Minimum supported client Windows 2000 Professional [desktop apps only]
Minimum supported server Windows 2000 Server [desktop apps only]
Target Platform Windows
Header winuser.h (include Windows.h)
Library User32.lib
DLL User32.dll

See Also

Conceptual

GetSubMenu

Menus

Reference

SetMenu