共用方式為

getGestureConfig 函式 (winuser.h)

  • 發行項

擷取從視窗傳送 Windows Touch 手勢訊息的組態。

語法

BOOL GetGestureConfig(
  [in]      HWND           hwnd,
  [in]      DWORD          dwReserved,
  [in]      DWORD          dwFlags,
  [in]      PUINT          pcIDs,
  [in, out] PGESTURECONFIG pGestureConfig,
  [in]      UINT           cbSize
);

參數

[in] hwnd

視窗的句柄，可從中取得手勢設定。

[in] dwReserved

這個值是保留的，而且必須設定為 0。

[in] dwFlags

手勢命令旗標值，指出擷取手勢設定的選項。 如需其他資訊和支援的值，請參閱。

[in] pcIDs

pGestureConfig 緩衝區中的筆勢設定結構數目大小。

[in, out] pGestureConfig

指定手勢設定的手勢組態結構陣列。

[in] cbSize

手勢設定的大小 (GESTURECONFIG) 結構。

傳回值

如果函式成功，則傳回非零的值。

如果此函式失敗，則傳回值為零。 若要取得擴充的錯誤資訊，請使用 GetLastError 函式。

備註

傳遞 cbSize 參數以外的sizeof(GESTURECONFIG)值會導致呼叫此函式失敗，而且 GetLastError 會以十進位) 傳回ERROR_INVALID_PARAMETER (87。

下表列出手勢組態值：

名稱 值 Description
GCF_INCLUDE_ANCESTORS 0x00000001 如果指定， GetGestureConfig 會傳回指定視窗及其父視窗鏈結的合併組態。
 

範例

    GESTURECONFIG gc[3];    
    UINT uiGcs = 3;

    ZeroMemory(&gc, sizeof(gc));
    gc[0].dwID  = GID_ZOOM;
    gc[1].dwID  = GID_ROTATE;
    gc[2].dwID  = GID_PAN;
    BOOL bResult = GetGestureConfig(hWnd, 0, 0, &uiGcs, gc, sizeof(GESTURECONFIG));        
    if (!bResult){                
        DWORD err = GetLastError();                                       
    }

規格需求

需求 值
最低支援的用戶端 Windows 7 [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2008 R2 [僅限傳統型應用程式]
目標平台 Windows
標頭 winuser.h (包括 Windows.h)
程式庫 User32.lib
Dll User32.dll
API 集合 ext-ms-win-ntuser-misc-l1-2-0 (於 Windows 8.1)

請參閱

函式

GESTURECONFIG

手勢的程序設計指南