WM_MOUSEMOVE message (Windows)

Switch View :
ScriptFree
WM_MOUSEMOVE message

Applies to: desktop apps only

Posted to a window when the cursor moves. If the mouse is not captured, the message is posted to the window that contains the cursor. Otherwise, the message is posted to the window that has captured the mouse.

A window receives this message through its WindowProc function.

#define WM_MOUSEMOVE                    0x0200

Parameters

wParam

Indicates whether various virtual keys are down. This parameter can be one or more of the following values.

ValueMeaning
MK_CONTROL
0x0008

The CTRL key is down.

MK_LBUTTON
0x0001

The left mouse button is down.

MK_MBUTTON
0x0010

The middle mouse button is down.

MK_RBUTTON
0x0002

The right mouse button is down.

MK_SHIFT
0x0004

The SHIFT key is down.

MK_XBUTTON1
0x0020

The first X button is down.

MK_XBUTTON2
0x0040

The second X button is down.

 

lParam

The low-order word specifies the x-coordinate of the cursor. The coordinate is relative to the upper-left corner of the client area.

The high-order word specifies the y-coordinate of the cursor. The coordinate is relative to the upper-left corner of the client area.

Return value

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

Remarks

Use the following code to obtain the horizontal and vertical position:


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

You can also use the MAKEPOINTS macro to convert the lParam parameter to a POINTS structure.

Requirements

Minimum supported client

Windows 2000 Professional

Minimum supported server

Windows 2000 Server

Header

Winuser.h (include Windows.h)

See also

Reference
GET_X_LPARAM
GET_Y_LPARAM
GetCapture
SetCapture
Conceptual
Mouse Input
Other Resources
MAKEPOINTS
POINTS

 

 

Send comments about this topic to Microsoft

Build date: 3/6/2012

Community Content

Julian_Xiang
ghost!

增加一個WM_MOUSEMOVE消息給一個按鈕,響應函數是彈出一個非模態對話框,

然后執行 ,結果是 ,在鼠標在按鈕上的時候,創建的對話框就會不斷的閃爍,因為其在 不停的被創建和被銷毀的狀態


Kaenneth
Fired when the window underneath moves
I know that this message fires when a window opens under the cursor, or if the window underneath the cursor moves without the cursor itself moving.

However I'm looking for official documentation that this is the intended behavior (or not)

Joe-P
GET_X_LPARAM / GET_Y_LPARAM does indeed work
You just need to #include <windowsx.h>

This isn't specified in the article

stickboy
No, don't use LOWORD/HIWORD

As noted in the GetMessagePos documentation, using LOWORD/HIWORD is wrong since it will not sign-extend negative coordinates for multiple monitor systems. (All of the documentation for mouse messages (WM_MOUSEMOVE, WM_LBUTTONDOWN, etc.) should stress this, just like the GetMessagePos documentation.)

Edit: Actually, I guess since most mouse messages are in client coordinates (whereas GetMessagePos uses screen coordinates), it's not a big deal.


Cerasti
Correction
This code is no longer valid:
xPos = GET_X_LPARAM(lParam); 
yPos = GET_Y_LPARAM(lParam);

Use this instead:

xPos = LOWORD(lParam); 
yPos = HIWORD(lParam);



ctacke
See Also...
WM_LBUTTONDOWN at http://msdn.microsoft.com/en-us/library/ms645607(VS.85).aspx

WM_LBUTTONUP at http://msdn.microsoft.com/en-us/library/ms645608(VS.85).aspx



Đonny
Value
 WM_MOUSEMOVE = &H200
MK_CONTROL = &H8
MK_LBUTTON = &H1
MK_MBUTTON = &H10
MK_RBUTTON = &H2
MK_SHIFT = &H4
MK_XBUTTON1 = &H20
MK_XBUTTON2 = &H40