WM_GESTURE メッセージ

ジェスチャに関する情報を渡します。

パラメーター

wParam

ジェスチャ コマンドとジェスチャ固有の引数値を識別する情報を提供します。 この情報は、GESTUREINFO 構造体の ullArguments メンバーに渡される情報と同じです。

lParam

ジェスチャ コマンドとジェスチャ固有の引数値を識別する情報へのハンドルを提供します。 この情報は、 GetGestureInfo を呼び出すことによって取得されます。

戻り値

アプリケーションがこのメッセージを処理すると、0 が返されます。

アプリケーションがメッセージを処理しない場合は、 DefWindowProc を呼び出す必要があります。 これを行わないと、タッチ入力ハンドルが閉じず、関連付けられているプロセス メモリが解放されないため、アプリケーションはメモリリークを引き起こします。

解説

次の表に、サポートされているジェスチャ コマンドの一覧を示します。

次の表は、 lParam パラメーターと wParam パラメーターで渡されるジェスチャ引数を示しています。

例

次のコードは、このメッセージに関連付けられているジェスチャ固有の情報を取得する方法を示しています。

  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 タッチ ジェスチャ プログラミング ガイド