windows_programming_notes.nbk: Home | Index | Next Page: WM_MOUSEACTIVATE | Previous Page: WM_MENUCOMMAND

 WM_MENUSELECT

The WM_MENUSELECT message is sent to a menu's owner window when the user selects a menu item.

A window receives this message through its WindowProc function.

    LRESULT CALLBACK WindowProc(
      HWND hwnd,       // handle to window
      UINT uMsg,       // WM_MENUSELECT
      WPARAM wParam,   // menu item (UINT) and flags (UINT)
      LPARAM lParam    // handle to menu (HMENU)
    );

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 Description MF_BITMAP Item displays a bitmap. MF_CHECKED Item is checked. MF_DISABLED Item is disabled. MF_GRAYED Item is grayed. MF_HILITE Item is highlighted. MF_MOUSESELECT Item is selected with the mouse. MF_OWNERDRAW Item is an owner-drawn item. MF_POPUP Item opens a drop-down menu or submenu. MF_SYSMENU Item is contained in the window menu. The lParam parameter contains a handle to the menu associated with the message.
• lParam Handle to the menu that was clicked.

Return Values

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

  Windows NT/2000 or later: Requires Windows NT 3.1 or later.
  Windows 95/98/Me: Requires Windows 95 or later.
  Header: Declared in Winuser.h; include Windows.h.

windows_programming_notes.nbk: Home | Index | Next Page: WM_MOUSEACTIVATE | Previous Page: WM_MENUCOMMAND

Notebook exported on Monday, 7 July 2008, 18:56:50 PM Eastern Daylight Time