WM_POINTERUPDATE 消息
当指针在窗口的工作区上产生接触,或将未捕获的指针悬停在窗口的工作区上方时,发布以提供更新。 指针悬停时,消息将针对指针恰好在其之上的窗口。 当指针与图面接触时,指针会被隐式捕获到指针产生接触时下方的窗口,该窗口会继续接收指针的输入,直到它中断接触为止。
![重要提示]
桌面应用应能识别 DPI。 如果应用无法识别 DPI,则指针消息中包含的屏幕坐标和相关结构可能会由于 DPI 虚拟化而显示不准确。 DPI 虚拟化会为不识别 DPI 且默认处于活动状态的应用程序提供自动缩放支持(用户可以将其关闭)。 有关详细信息,请参阅编写高 DPI Win32 应用程序。
#define WM_POINTERUPDATE 0x0245
参数
-
wParam
-
包含有关指针的信息。 使用以下宏从 wParam 参数中检索信息。
GET_POINTERID_WPARAM(wParam):指针标识符。
IS_POINTER_NEW_WPARAM(wParam):该标志指示此消息是否表示新指针生成的第一个输入。
IS_POINTER_INRANGE_WPARAM(wParam):该标志指示此消息是否在其生存期内由指针生成。 在指示指针已离开检测范围的消息上,未设置此标志
IS_POINTER_INCONTACT_WPARAM(wParam):该标志指示此消息是否由与窗口表面接触的指针生成。 在指示悬停指针的消息上,未设置此标志。
IS_POINTER_PRIMARY_WPARAM(wParam):指示此指针已指定为主指针。
IS_POINTER_FIRSTBUTTON_WPARAM(wParam):指示是否存在主操作的标志。
- 这类似于按下鼠标左键。
- 在与数字化器表面接触时,触摸屏指针将具有此设置。
- 当笔指针与数字化器表面接触且没有按下按钮时,笔指针将具有此设置。
IS_POINTER_SECONDBUTTON_WPARAM(wParam):指示是否存在辅助操作的标志。
- 这类似于按下鼠标右键。
- 当笔指针与数字化器表面接触且按下笔桶按钮时,笔指针将具有此设置。
IS_POINTER_THIRDBUTTON_WPARAM(wParam):该标志指示是否存在基于指针类型的一个或多个第三级操作;希望响应第三级操作的应用程序必须检索特定于指针类型的信息,以确定按下了哪些第三级按钮。 例如,应用程序可以通过调用 GetPointerPenInfo 并检查指定按钮状态的标志来确定笔的按钮状态。
IS_POINTER_FOURTHBUTTON_WPARAM(wParam):指示指定指针是否执行第四个操作的标志。 希望响应第四个操作的应用程序必须检索特定于指针类型的信息,以确定是否按下了第一个扩展鼠标 (XButton1) 按钮。
IS_POINTER_FIFTHBUTTON_WPARAM(wParam):该标志指示指定指针是否执行第五个操作。 希望响应第五个操作的应用程序必须检索特定于指针类型的信息,以确定是否按下第二个扩展鼠标 (XButton2) 按钮。
有关更多详细信息,请参阅指针标志。
注意
悬停指针没有设置任何按钮标志。 这类似于没有按下鼠标按钮的鼠标移动。 应用程序可以通过调用 GetPointerPenInfo 并检查指定按钮状态的标志,来确定悬停笔的按钮状态。
-
lParam
-
包含指针的点位置。
注意
由于指针可能通过非普通区域与设备联系,因此,此点位置可能是更复杂的指针区域的简化。 尽可能使用完整的指针区域信息,而不是点位置。
使用以下宏检索点的物理屏幕坐标。
- GET_X_LPARAM(lParam):x(水平点)坐标。
- GET_Y_LPARAM(lParam):y(垂直点)坐标。
返回值
如果应用程序处理此消息,它应返回零。
如果应用程序未处理此消息,则应调用 DefWindowProc。
注解
每个指针在其生存期内都有一个唯一的指针标识符。 指针的生存期从第一次检测到指针时开始。
如果检测到悬停指针,则会生成 WM_POINTERENTER 消息。 如果检测到非悬停指针,则将生成 WM_POINTERDOWN 消息,后跟 WM_POINTERENTER 消息。
在其生存期内,指针可能会在悬停或接触时生成一系列 WM_POINTERUPDATE 消息。
指针的生存期在不再被检测到时结束。 这会生成 WM_POINTERLEAVE 消息。
当指针中止时,将设置 POINTER_FLAG_CANCELED。
当未捕获的指针在窗口边界外移动时,也可能生成 WM_POINTERLEAVE 消息。
若要获得指针的水平和垂直位置,请使用以下内容:
xPos = GET_X_LPARAM(lParam);
yPos = GET_Y_LPARAM(lParam);
还可以使用 MAKEPOINTS 宏将 lParam 参数转换为 POINTS 结构。
可以使用 GetKeyState 函数确定与此消息关联的键盘修改键状态。 例如,若要检测是否已按下 Alt 键,请检查是否 GetKeyState (VK_MENU) < 0。
如果应用程序不处理此消息,而来自此指针以及可能的其他指针的输入序列被识别为手势,则 DefWindowProc 可能会生成一条或多条 WM_GESTURE 消息。 如果无法识别手势,则 DefWindowProc 可能会生成鼠标输入。
如果应用程序有选择地使用某些指针输入并将其余内容传递给 DefWindowProc,则生成的行为是未定义的。
使用 GetPointerInfo 函数检索与此消息相关的进一步信息。
如果应用程序处理这些消息的速度不如生成消息的速度快,则可能会合并一些移动。 可使用 GetPointerInfoHistory 函数检索合并到此消息中的输入的历史记录。
示例
下面的代码示例演示了如何使用 GET_X_LPARAM、GET_Y_LPARAM、IS_POINTER_FIRSTBUTTON_WPARAM 和 IS_POINTER_SECONDBUTTON_WPARAM 从WM_POINTERUPDATE 消息的 wParam 和 lParam 参数中检索相关信息。
int xPos = GET_X_LPARAM(lParam);
int yPos = GET_Y_LPARAM(lParam);
if (IS_POINTER_PRIMARYBUTTON_WPARAM(wParam))
{
// process pointer move while down, similar to mouse move with left button down
}
else if (IS_POINTER_SECONDARYBUTTON_WPARAM(wParam))
{
// process pointer move while down, similar to mouse move with right button down
}
下面的代码示例演示了如何使用 GET_POINTERID_WPARAM 从 WM_POINTERUPDATE 消息的 wParam 参数检索指针 ID。
POINTER_INFO pointerInfo;
UINT32 pointerId = GET_POINTERID_WPARAM(wParam);
// Retrieve common pointer information
if (!GetPointerInfo(pointerId, &pointerInfo))
{
// failure, call GetLastError()
}
else
{
// success, process pointerInfo
}
下面的代码示例演示了如何处理不同的指针类型。
POINTER_TOUCH_INFO touchInfo;
POINTER_PEN_INFO penInfo;
POINTER_INFO pointerInfo;
UINT32 pointerId = GET_POINTERID_WPARAM(wParam);
POINTER_INPUT_TYPE pointerType = PT_POINTER;
// default to unhandled to enable call to DefWindowProc
fHandled = FALSE;
if (!GetPointerType(pointerId, &pointerType))
{
// failure, call GetLastError()
// set PT_POINTER to fall to default case below
pointerType = PT_POINTER;
}
switch (pointerType)
{
case PT_TOUCH:
// Retrieve touch information
if (!GetPointerTouchInfo(pointerId, &touchInfo))
{
// failure, call GetLastError()
}
else
{
// success, process touchInfo
// mark as handled to skip call to DefWindowProc
fHandled = TRUE;
}
break;
case PT_PEN:
// Retrieve pen information
if (!GetPointerPenInfo(pointerId, &penInfo))
{
// failure, call GetLastError()
}
else
{
// success, process penInfo
// mark as handled to skip call to DefWindowProc
fHandled = TRUE;
}
break;
default:
if (!GetPointerInfo(pointerId, &pointerInfo))
{
// failure.
}
else
{
// success, proceed with pointerInfo.
fHandled = HandleGenericPointerInfo(&pointerInfo);
}
break;
}
要求
要求 | 值 |
---|---|
最低受支持的客户端 |
Windows 8 [仅限桌面应用] |
最低受支持的服务器 |
Windows Server 2012 [仅限桌面应用] |
标头 |
|