Partager via


Receiving Mouse Messages

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

Applications on Windows® phones process touch events as a click of the left mouse button, so support for mouse input can be important to your OS design.

The mouse generates an input event when the user moves the mouse, or presses or releases a mouse button. The OS converts mouse input events into messages and posts these messages to the message queue for the appropriate thread. When the OS posts mouse messages faster than a thread can process the messages, the OS discards all but the most recent mouse message.

A window receives a mouse message when a mouse event occurs while the cursor is within the borders of the window or when the window has captured the mouse. The following table shows the messages that the system posts when the user moves the mouse, or presses or releases a mouse button while the cursor is within the client area of a window.

Message Description

WM_LBUTTONDBLCLK

The user double-clicked the left mouse button.

WM_LBUTTONDOWN

The user pressed the left mouse button.

WM_LBUTTONUP

The user released the left mouse button.

WM_MBUTTONDOWN

The user pressed the middle mouse button.

WM_MBUTTONUP

The user released the middle mouse button.

WM_MOUSEMOVE

The user moved the mouse cursor within the client area of the window.

WM_MOUSEWHEEL

The user rotated or pressed the mouse wheel.

WM_RBUTTONDOWN

The user pressed the right mouse button.

WM_RBUTTONUP

The user released the right mouse button.

The lParam parameter of a mouse message indicates the position of the hot spot of the cursor. The low-order word of lParam indicates the x-coordinate of the hot spot, and the high-order word indicates the y-coordinate. The coordinates are specified in client coordinates. In the client coordinate system, all points on the screen are specified relative to an origin at the upper-left corner of the client area.

The wParam parameter of a mouse message contains flags that indicate the status of the other mouse buttons and the CTRL and SHIFT keys at the time of the mouse event. You can check for these flags when the way that you want to process a mouse message depends on the state of another mouse button or of the CTRL or SHIFT key. The following table shows the possible values for wParam, which you can combine.

Value Description

MK_CONTROL

The user pressed the CTRL key.

MK_LBUTTON

The user pressed the left mouse button.

MK_MBUTTON

The user pressed the middle mouse button.

MK_RBUTTON

The user pressed the right mouse button.

MK_SHIFT

The user pressed the SHIFT key.

For more information, see Receiving Double-Click Messages.

See Also

Other Resources

Mouse Application Development
Mouse