Windows Touch的WM_GESTURE与WM_GESTURENOTIGY消息-中文整理

节包含有关 Windows Touch 笔势的通知。

本节中指定了以下通知。

通知	说明
WM_GESTURE	发送到窗口过程以传递有关笔势的信息。
WM_GESTURENOTIFY	为您提供设置笔势配置的机会。

WM_GESTURE 消息

传递有关笔势的信息。MFC的CWnd类已经加载了这个消息，以虚函数的方式供集成的类使用，函数声明为LRESULT OnGesture(WPARAM wParam, LPARAM lParam);然后分配指派手势的不同虚函数执行相应的手势代码。

参数

wParam

提供标识笔势命令和特定于笔势的参数值的信息。此信息是在 GESTUREINFO 结构中的 ullArguments 成员中传递的相同信息。

lParam

提供标识笔势命令和特定于笔势的参数值的信息的句柄。可通过调用 GetGestureInfo 检索此信息。

返回值

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

如果应用程序不处理此消息，则它必须调用 DefWindowProc。不执行此操作将导致应用程序泄露内存，因为将不会关闭触控输入句柄，并且将不会释放关联的进程内存。

评论

下表列出了支持的笔势命令。

笔势 ID	值 (dwID)	说明
GID_BEGIN	1	指示泛型笔势已开始。
GID_END	2	指示泛型笔势已结束。
GID_ZOOM	3	指示缩放开始、缩放移动或缩放停止。第一条 GID_ZOOM 命令消息开始缩放但不会导致任何缩放。第二条 GID_ZOOM 命令触发与第一条 GID_ZOOM 中包含的状态相关的缩放。
GID_PAN	4	指示平移移动或平移开始。第一条 GID_PAN 命令指示平移开始但不会执行任何平移。在出现第二条 GID_PAN 命令消息时，应用程序将开始平移。
GID_ROTATE	5	指示旋转移动或旋转开始。第一条 GID_ROTATE 命令消息指示旋转移动或旋转开始但不会进行旋转。第二条 GID_ROTATE 命令消息将触发与第一条 GID_ROTATE 中包含的状态相关的旋转操作。
GID_TWOFINGERTAP	6	指示双指点击笔势。
GID_PRESSANDTAP	7	指示按住并点击笔势。可以用来表示鼠标的右键动作。

 

注意   若要启用旧版支持，必须使用 DefWindowProc 转发带有 GID_BEGIN 和 GID_END 笔势命令的消息。

下表指示在 lParam 和 wParam 参数中传递的笔势参数。

笔势 ID	笔势	ullArgument	GestureInfo 结构中的 ptsLocation
GID_ZOOM	放大/缩小	指示两个点之间的距离。	指示缩放中心。
GID_PAN	平移	指示两个点之间的距离。	指示平移的当前位置。
GID_ROTATE	旋转（支点）	指示旋转角度（如果设置了 GF_BEGIN 标志）。否则，它是自旋转开始后的角度更改。此值将使用正负符号指示旋转的方向。使用 GID_ROTATE_ANGLE_FROM_ARGUMENT 和GID_ROTATE_ANGLE_TO_ARGUMENT 宏获取和设置角度值。	这将指示旋转的中心，即目标对象绕其旋转的固定点。
GID_TWOFINGERTAP	双指点击	指示两个手指之间的距离。	指示两个手指的中心。
GID_PRESSANDTAP	按住并点击	指示第一个手指和第二个手指之间的增量。此值将存储在 POINT 结构中的 ullArgument 的低 32 位中。	指示第一个手指按住的位置。

 

注意  所有距离和位置都以物理屏幕坐标形式提供。

注意  只应将 dwID 和 ullArgument 参数视为随 GID_* 命令附带，并且应用程序不应更改这些参数。

示例

以下代码演示如何获取与此消息关联的特定于笔势的信息。

注意   应始终将未处理的消息转发给 DefWindowProc，并应关闭已通过调用 CloseGestureInfoHandle 处理的消息的笔势输入句柄。在此示例中，将禁止显示默认的笔势处理程序行为，因为每个笔势用例中已关闭 TOUCHINPUT 句柄。如果在上面的代码中删除未处理的消息的用例，则默认笔势处理程序会通过在默认用例中将消息转发给 DefWindowProc 来处理消息。

  LRESULT DecodeGesture(HWND hWnd, UINT message, WPARAM wParam, LPARAM lParam){
    // Create a structure to populate and retrieve the extra message info.
    GESTUREINFO gi;  
    
    ZeroMemory(&gi, sizeof(GESTUREINFO));
    
    gi.cbSize = sizeof(GESTUREINFO);

    BOOL bResult  = GetGestureInfo((HGESTUREINFO)lParam, &gi);
    BOOL bHandled = FALSE;

    if (bResult){
        // now interpret the gesture
        switch (gi.dwID){
           case GID_ZOOM:
               // Code for zooming goes here     
               bHandled = TRUE;
               break;
           case GID_PAN:
               // Code for panning goes here
               bHandled = TRUE;
               break;
           case GID_ROTATE:
               // Code for rotation goes here
               bHandled = TRUE;
               break;
           case GID_TWOFINGERTAP:
               // Code for two-finger tap goes here
               bHandled = TRUE;
               break;
           case GID_PRESSANDTAP:
               // Code for roll over goes here
               bHandled = TRUE;
               break;
           default:
               // A gesture was not recognized
               break;
        }
    }else{
        DWORD dwErr = GetLastError();
        if (dwErr > 0){
            //MessageBoxW(hWnd, L"Error!", L"Could not retrieve a GESTUREINFO structure.", MB_OK);
        }
    }
    if (bHandled){
        return 0;
    }else{
        return DefWindowProc(hWnd, message, wParam, lParam);
    }
  }

WM_GESTURENOTIFY 消息

为您提供设置笔势配置的机会。

参数

wParam

未使用。

lParam

一个指向 GESTURENOTIFYSTRUCT 的指针。

返回值

应从 DefWindowProc 返回一个值。

评论

当接收到 WM_GESTURENOTIFY 消息时，应用程序可使用 SetGestureConfig 指定要接收的笔势。始终应使用 DefWindowProc 函数向上冒泡传递此消息。

注意   处理 WM_GESTURENOTIFY 消息将更改窗口生存期内（而不仅仅是下一个笔势）的笔势配置。

示例

以下示例演示了如何启用所有笔势。有关更多示例，请参见 SetGestureConfig。

    switch (message)
    {
    case WM_GESTURENOTIFY:
        GESTURECONFIG gc = {0,GC_ALLGESTURES,0};
        BOOL bResult = SetGestureConfig(hWnd,0,1,&gc,sizeof(GESTURECONFIG));
            
        if(!bResult)
        {
            // an error
        }
        return DefWindowProc(hWnd, WM_GESTURENOTIFY, wParam, lParam);
    }