WM_CONTEXTMENU
A version of this page is also available for
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