WM_POINTERDOWN 消息
当指针在窗口的工作区上联系时发布。 此输入消息针对指针进行接触的窗口，并将指针隐式捕获到窗口，以便窗口继续接收指针的输入，直到中断联系人。
窗口通过其 WindowProc 函数接收此消息。
[!重要提示]
桌面应用应注意 DPI。 如果应用无法识别 DPI，则指针消息中包含的屏幕坐标和相关结构可能会由于 DPI 虚拟化而显示不准确。 DPI 虚拟化为非 DPI 感知的应用程序提供自动缩放支持，默认情况下 (用户可以将其关闭) 。 有关详细信息，请参阅 编写高 DPI Win32 应用程序。
#define WM_POINTERDOWN 0x0246
参数
-
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_PRIMARY_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_POINTERCAPTURECHANGED 通知时，它通常不会收到任何进一步的通知。 因此，请务必不要根据均匀配对的WM_POINTERDOWN/WM_POINTERUP或WM_POINTERENTER/WM_POINTERLEAVE通知做出任何假设。
每个指针在其生存期内都有唯一的指针标识符。 指针的生存期在首次检测到指针时开始。
如果检测到悬停指针，则会生成 WM_POINTERENTER 消息。 检测到非悬停指针时，将生成 后 跟WM_POINTERENTER消息的 WM_POINTERDOWN 消息。
在其生存期内，指针可能会在将鼠标悬停或联系时生成一系列 WM_POINTERUPDATE 消息。
指针的生存期在不再检测到时结束。 这会生成 WM_POINTERLEAVE 消息。
当指针中止时， 将设置POINTER_FLAG_CANCELED 。
当未捕获的指针在窗口边界外移动时，也可能生成 WM_POINTERLEAVE 消息。
若要获取指针的水平和垂直位置，请使用以下内容：
xPos = GET_X_LPARAM(lParam);
yPos = GET_Y_LPARAM(lParam);
若要将 lParam 参数转换为 POINTS) 结构，请使用 MAKEPOINTS 宏。
若要检索与消息关联的进一步信息，请使用 GetPointerInfo 函数。
若要确定与此消息关联的键盘修饰键状态，请使用 GetKeyState 函数。 例如，若要检测按下 ALT 键，请检查 GetKeyState 是否 (VK_MENU) < 0。
请注意，如果应用程序未处理此消息，如果来自此消息的输入序列， DefWindowProc 可能会生成一个或多个 WM_GESTURE 消息，并且可能还会识别其他指针作为手势。 如果无法识别手势， DefWindowProc 可能会生成鼠标输入。
如果应用程序有选择地使用一些指针输入并将其余项传递给 DefWindowProc，则生成的行为是未定义的。
当窗口失去指针捕获并接收 WM_POINTERCAPTURECHANGED 通知时，它通常不会收到任何进一步通知。 因此，无论窗口是否接收均匀配对的 DOWN/UP 或 ENTER/LEAVE 通知，窗口都不会对其指针状态进行任何假设，这一点很重要。
示例
下面的代码示例演示如何使用 IS_POINTER_FIRSTBUTTON_WPARAM、 GET_X_LPARAM、 GET_Y_LPARAM和 IS_POINTER_SECONDBUTTON_WPARAM检索与 WM_POINTERDOWN 消息关联的相关信息。
int xPos = GET_X_LPARAM(lParam);
int yPos = GET_Y_LPARAM(lParam);
if (IS_POINTER_PRIMARYBUTTON_WPARAM(wParam))
{
// process pointer down, similar to mouse left button down
}
else if (IS_POINTER_SECONDARYBUTTON_WPARAM(wParam))
{
// process pointer down, similar to mouse right button down
}
下面的代码示例演示如何使用 GET_POINTERID_WPARAM 从 WM_POINTERDOWN 消息中检索指针 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_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 = HandleGenericPointerMessage(&pointerInfo);
}
break;
}
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 |
Windows 8 [仅限桌面应用] |
| 最低受支持的服务器 |
Windows Server 2012 [仅限桌面应用] |
| 标头 |
|