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_BEGIN和GID_END手勢命令的訊息。

下表指出 lParam 和 wParam 參數中傳遞的筆勢引數。

筆勢識別碼	手勢	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);
    }
  }

規格需求

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

另請參閱

通知

Windows Touch 手勢程式設計指南