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_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

包含指针的点位置。

注意

由于指针可能会通过非平凡区域与设备接触，因此此点位置可能简化了更复杂的指针区域。 应用程序应尽可能使用完整的指针区域信息，而不是点位置。

使用以下宏检索点的物理屏幕坐标。

返回值

如果应用程序处理此消息，则它应返回零。

如果应用程序不处理此消息，则应调用 DefWindowProc。

备注

![重要提示]
当窗口丢失指针的捕获并接收 WM_POINTERCAPTURECHANGED 通知时，它通常不会再收到任何通知。 因此，请务必不要基于均匀配对WM_POINTERDOWN WM_POINTERUP/或WM_POINTERENTER/WM_POINTERLEAVE通知做出任何假设。

每个指针在其生存期内都有一个唯一的指针标识符。 指针的生存期从首次检测到它时开始。

如果检测到悬停指针，则会生成 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);

若要将 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 [仅限桌面应用]
标头
Winuser.h（包括 Windows.h）

另请参阅

消息

引用

指针标志

GET_POINTERID_WPARAM

IS_POINTER_NEW_WPARAM

IS_POINTER_INRANGE_WPARAM

IS_POINTER_INCONTACT_WPARAM

IS_POINTER_PRIMARY_WPARAM

IS_POINTER_FIRSTBUTTON_WPARAM

IS_POINTER_SECONDBUTTON_WPARAM

IS_POINTER_THIRDBUTTON_WPARAM

IS_POINTER_FOURTHBUTTON_WPARAM

IS_POINTER_FIFTHBUTTON_WPARAM