通过

使用 Windows 触控手势入门

  • 项目

本部分介绍使用多点触控手势的基本步骤。

使用 Windows 触控手势时，通常执行以下步骤：

  1. 设置用于接收手势的窗口。
  2. 处理手势消息。
  3. 解释手势消息。

设置用于接收手势的窗口

默认情况下，会收到 WM_GESTURE 消息。

注意

如果调用 RegisterTouchWindow，将停止接收 WM_GESTURE 消息。 如果未收到 WM_GESTURE 消息，请确保尚未调用 RegisterTouchWindow。

 

以下代码演示了一个简单的 InitInstance 实现。

#include <windows.h>


BOOL InitInstance(HINSTANCE hInstance, int nCmdShow)
{
   HWND hWnd;

   hInst = hInstance; // Store instance handle in our global variable

   hWnd = CreateWindow(szWindowClass, szTitle, WS_OVERLAPPEDWINDOW,
      CW_USEDEFAULT, 0, CW_USEDEFAULT, 0, NULL, NULL, hInstance, NULL);

   if (!hWnd)
   {
      return FALSE;
   }

   ShowWindow(hWnd, nCmdShow);
   UpdateWindow(hWnd);

   return TRUE;
}

处理手势消息

与处理 Windows Touch 输入消息类似，你可以通过多种方式处理手势消息。 如果使用 Win32，可以在 WndProc 中检查WM_GESTURE消息。 如果要创建另一种类型的应用程序，可以将 WM_GESTURE 消息添加到消息映射，然后实现自定义处理程序。

以下代码演示如何处理手势消息。

LRESULT CALLBACK WndProc(HWND hWnd, UINT message, WPARAM wParam, LPARAM lParam)
{
    int wmId, wmEvent;
    PAINTSTRUCT ps;
    HDC hdc;

    switch (message)
    {    
    case WM_GESTURE:
            // Insert handler code here to interpret the gesture.            
            return DecodeGesture(hWnd, message, wParam, lParam);

解释手势消息

GetGestureInfo 函数用于将手势消息解释为描述手势的结构。 结构 GESTUREINFO 包含有关手势的信息，例如执行手势的位置和手势的类型。 以下代码演示如何检索和解释手势消息。

  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);
    }
  }

Windows 触控手势