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) 構造のサイズ。

戻り値

関数が成功すると、戻り値は 0 以外になります。

関数が失敗した場合は、0 を返します。 拡張エラー情報を取得するには、 GetLastError 関数を使用します。

注釈

cbSize パラメーターに sizeof(GESTURECONFIG) 以外の値を渡すと、この関数の呼び出しが失敗し、GetLastError は ERROR_INVALID_PARAMETER (10 進数で 87) を返します。

次の表に、ジェスチャの構成値を示します。

名前	値	説明
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 を含む)
Library	User32.lib
[DLL]	User32.dll
API セット	ext-ms-win-ntuser-misc-l1-2-0 (Windows 8.1 で導入)

関連項目

関数

GESTURECONFIG

ジェスチャのプログラミング ガイド