Compartilhar via


Introdução com gestos de toque do Windows

Esta seção descreve as etapas básicas para usar gestos multitouch.

As etapas a seguir normalmente são executadas ao usar gestos do Windows Touch:

  1. Configure uma janela para receber gestos.
  2. Manipule as mensagens de gesto.
  3. Interpretar as mensagens de gesto.

Configurando uma janela para receber gestos

Por padrão, você recebe WM_GESTURE mensagens.

Observação

Se você chamar RegisterTouchWindow, deixará de receber WM_GESTURE mensagens. Se você não estiver recebendo mensagens WM_GESTURE , verifique se não chamou RegisterTouchWindow.

 

O código a seguir mostra uma implementação simples de 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;
}

Manipulando mensagens de gesto

Semelhante ao tratamento de mensagens de entrada do Windows Touch, você pode lidar com mensagens de gesto de várias maneiras. Se você estiver usando o Win32, poderá marcar para a mensagem WM_GESTURE no WndProc. Se você estiver criando outro tipo de aplicativo, poderá adicionar a mensagem WM_GESTURE ao mapa de mensagens e, em seguida, implementar um manipulador personalizado.

O código a seguir mostra como as mensagens de gesto podem ser tratadas.

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

Interpretando as mensagens de gesto

A função GetGestureInfo é usada para interpretar uma mensagem de gesto em uma estrutura que descreve o gesto. A estrutura, GESTUREINFO, tem informações sobre o gesto, como o local em que o gesto foi executado e o tipo de gesto. O código a seguir mostra como você pode recuperar e interpretar uma mensagem de gesto.

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

Gestos de Toque do Windows