共用方式為


WM_GESTURE訊息

傳遞手勢的相關資訊。

參數

wParam

提供識別手勢命令和筆勢特定引數值的資訊。 這項資訊與在 GESTUREINFO結構的ullArguments成員中傳遞的資訊相同。

lParam

提供識別手勢命令和筆勢特定引數值之資訊的控制碼。 呼叫 GetGestureInfo即可擷取這項資訊。

傳回值

如果應用程式處理此訊息,它應該會傳回 0。

如果應用程式未處理訊息,則必須呼叫 DefWindowProc。 不這麼做會導致應用程式流失記憶體,因為不會關閉觸控輸入控制碼,而且不會釋放相關聯的進程記憶體。

備註

下表列出支援的手勢命令。

筆勢識別碼 值 (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_BEGINGID_END手勢命令的訊息。

下表指出 lParamwParam 參數中傳遞的筆勢引數。

筆勢識別碼 手勢 ullArgument GestureInfo結構中的ptsLocation
GID_ZOOM 放大/縮小 表示兩點之間的距離。 表示縮放的中心。
GID_PAN 移動瀏覽 表示兩點之間的距離。 表示移動流覽的目前位置。
GID_ROTATE 旋轉 (樞紐) 指出設定GF_BEGIN旗標時 旋轉 的角度。 否則,這是自旋轉開始後的角度變更。 這是帶正負號的,表示旋轉的方向。 使用 GID_ROTATE_ANGLE_FROM_ARGUMENTGID_ROTATE_ANGLE_TO_ARGUMENT 宏來取得和設定角度值。 這表示旋轉的中心,這是目標物件繞著旋轉的固定點。
GID_TWOFINGERTAP 雙指點選 表示兩指之間的距離。 表示兩指的中心。
GID_PRESSANDTAP 按下並點選 表示第一個手指與第二指之間的差異。 此值會儲存在POINT結構中ullArgument的較低 32 位中。 表示第一個手指下拉的位置。

注意

所有距離和位置都會以實體螢幕座標提供。

注意

dwIDullArgument參數應該只被視為隨附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);
    }
  }

規格需求

需求
最低支援的用戶端
Windows 7 [僅限傳統型應用程式]
最低支援的伺服器
Windows Server 2008 R2 [僅限桌面應用程式]
標頭
Winuser.h (包括 Windows.h)

另請參閱

通知

Windows Touch 手勢程式設計指南