WM_MENUSELECT message

Sent to a menu's owner window when the user selects a menu item.

#define WM_MENUSELECT                   0x011F

Parameters

wParam

The low-order word specifies the menu item or submenu index. If the selected item is a command item, this parameter contains the identifier of the menu item. If the selected item opens a drop-down menu or submenu, this parameter contains the index of the drop-down menu or submenu in the main menu, and the lParam parameter contains the handle to the main (clicked) menu; use the GetSubMenu function to get the menu handle to the drop-down menu or submenu.

The high-order word specifies one or more menu flags. This parameter can be one or more of the following values.

Value Meaning
MF_BITMAP
0x00000004L
Item displays a bitmap.
MF_CHECKED
0x00000008L
Item is checked.
MF_DISABLED
0x00000002L
Item is disabled.
MF_GRAYED
0x00000001L
Item is grayed.
MF_HILITE
0x00000080L
Item is highlighted.
MF_MOUSESELECT
0x00008000L
Item is selected with the mouse.
MF_OWNERDRAW
0x00000100L
Item is an owner-drawn item.
MF_POPUP
0x00000010L
Item opens a drop-down menu or submenu.
MF_SYSMENU
0x00002000L
Item is contained in the window menu. The lParam parameter contains a handle to the menu associated with the message.

lParam

A handle to the menu that was clicked.

Return value

If an application processes this message, it should return zero.

Remarks

If the high-order word of wParam contains 0xFFFF and the lParam parameter contains NULL, the system has closed the menu.

Do not use the value 1 for the high-order word of wParam, because this value is specified as (UINT) HIWORD(wParam). If the value is 0xFFFF, it would be interpreted as 0x0000FFFF, not 1, because of the cast to a UINT.

Requirements

Requirement Value
Minimum supported client
Windows 2000 Professional [desktop apps only]
Minimum supported server
Windows 2000 Server [desktop apps only]
Header
Winuser.h (include Windows.h)

See also

Reference

GetSubMenu

HIWORD

LOWORD

Conceptual

Keyboard Accelerators