WM_MOUSEWHEEL 消息

小甲鱼

注：本文档由 百日维新 翻译，小甲鱼校对。

原文链接 -> 传送门

消息含义：

当滑动鼠标滚轮，WM_MOUSEWHEEL 消息被发送到焦点窗口。DefWindowProc 函数传送该消息给父窗口。从 DefWindowProc 函数开始传送消息到它的父窗口过程中，不应该有内部的消息转发，直到找到一个处理消息的窗口。

窗口通过它的 WindowProc 函数接收消息。


消息定义：

#define WM_MOUSEWHEEL                   0x020A

参数解析：

wParam：高位字节表示鼠标滚轮滑动的距离。距离值以 WHEEL_DELTA（它的值别定义为 120）的倍数或部分的形式表达。正数表明向前滚动，离开用户，负数表明往回滚动，向着用户。

低位字节表示各个虚拟键是否被按下，该参数可以是下表中一个或者多个值：

值	含义
MK_CONTROL (0x0008)	CTRL 键被按下
MK_LBUTTON (0x0001)	鼠标左键被按下
MK_MBUTTON (0x0010)	鼠标中键被按下
MK_RBUTTON (0x0002)	鼠标右键被按下
MK_SHIFT (0x0004)	SHIFT 键被按下
MK_XBUTTON1 (0x0020)	第一个 X 按钮被按下
MK_XBUTTON2 (0x0040)	第二个 X 按钮被按下

lParam：表示鼠标的位置，低位字节表示相对于屏幕左上角的 X 坐标；高位字节表示相对于屏幕左上角的 Y 坐标。


返回值：

如果应用程序处理这个消息，它应该返回 0。


备注：

1. 使用下面的代码获取 wParam 参数中的信息。

fwKeys = GET_KEYSTATE_WPARAM(wParam);
zDelta = GET_WHEEL_DELTA_WPARAM(wParam);

2. 使用下面的代码获取鼠标的水平和垂直位置：        

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

3. 如上面所看到的那样，X 坐标在 lParam 参数的低位字节；Y 坐标在 lParam 参数的高位字节（两个都是有符号值，因为在多屏幕系统上它们可以为负值）。如果 lParam 参数赋值给一个变量，您可以使用 MAKEPOINTS 宏把 lParam 参数转成 POINTS 结构。您也可以使用 GET_X_LPARAM 宏或者 GET_Y_LPARAM 宏提取 X 坐标或者 Y 坐标。

重要：不要使用 LOWORD 宏或者 HIWORD 宏提取鼠标位置的 X 和 Y 坐标，因为在多萤幕系统上这些宏返回错误的结果。多萤幕系统的 X ，Y 坐标可以为负值，而 LOWORD 宏和 HIWORD 宏把坐标认为是无符号数值。

4. 鼠标滚轮滑动距离是 WHEEL_DELTA 的整数倍，WHEEL_DELTA 默认设置为 120。这个值是要采取的响应的开端，这一类响应（比如向前滑动到下一个刻度）必须为每一个 delta 对应。

5. delta 被设为 120，允许将来使用更高精度的滚轮（例如没有刻度的自由旋转滚轮），这种设备在每次滑动可能会发送多个消息，但是每次消息中的值更小。要支持这个可能性，或者可以累计输入的 delta 值，直到达到一个 WHEEL_DELTA （因此您达到与给定 delta 的滑动相同的响应），或者滚动部分行以响应更频繁的消息。您也可以选择您的滚动精度并累计 delta 值直到达到 WHEEL_DELTA。

6. 注意，MSH_MOUSEWHEEL 消息没有 fwKeys 值。否则，该参数和 WM_MOUSEWHEEL 消息一样。

7. 应用程序向上转发 MSH_MOUSEWHEEL 消息给嵌入对象或者控件。应用程序需发送该消息给活动的嵌入对象的链接与嵌入程序。程序是否发送消息到当前聚焦的允许鼠标滑轮操作的控件是可选的。如果应用程序发送消息给控件，应该检查返回值查看消息是否被处理。如果控件处理该消息则返回 TRUE。


需求：

Minimum supported client	Windows 2000 专业版 [仅桌面应用程序]
Minimum supported server	Windows 2000 服务器版 [仅桌面应用程序]
Header	Winuser.h (包含于 Windows.h)

【API档案】版权归鱼C工作室（www.fishc.com）所有，转载请注明来源。