Share via


WM_CONTEXTMENU

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

This message notifies a window that the user clicked the right mouse button (right-clicked) in the window.

Syntax

WM_CONTEXTMENU
    WPARAM wParam;
    LPARAM lParam;

Parameters

  • wParam
    Handle to the window in which the user right-clicked the mouse. This can be a child window of the window receiving the message. For more information about processing this message, see the Remarks section.
  • lParam
    The low-order word specifies the horizontal position of the cursor, in screen coordinates, at the time of the mouse click.

    The high-order word specifies the vertical position of the cursor, in screen coordinates, at the time of the mouse click.

Return Value

None.

Remarks

A window can process this message by displaying a shortcut menu using the TrackPopupMenu or TrackPopupMenuEx function. To obtain the horizontal and vertical positions, use the following code:

xPos = GET_X_LPARAM(lParam);
yPos = GET_Y_LPARAM(lParam);

If a window does not display a shortcut menu it should pass this message to the DefWindowProc function. For child windows, DefWindowProc sends the message to the parent. Otherwise, DefWindowProc displays a default shortcut menu if the specified position is in the window's caption.

DefWindowProc generates the WM_CONTEXTMENU message when it processes the WM_RBUTTONUP message or when the user presses and releases the VK_APPS key.

If the context menu is generated from the keyboard, then the x- and y-coordinates are –1 and the application should display the context menu at the location of the current selection rather than at (xPos, yPos).

Requirements

Header winuser.h
Windows Embedded CE Windows CE .NET 4.2 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also

Reference

DefWindowProc
TrackPopupMenu
TrackPopupMenuEx
WM_RBUTTONUP
Menus Messages

Other Resources