GESTURECONFIG 構造体 (winuser.h)
ジェスチャ メッセージを有効にするための構成と、この構成の種類を取得および設定します。
構文
typedef struct tagGESTURECONFIG {
DWORD dwID;
DWORD dwWant;
DWORD dwBlock;
} GESTURECONFIG, *PGESTURECONFIG;
メンバー
dwID
メッセージが有効または無効になる構成の種類の識別子。 詳細については、「解説」を参照してください。
dwWant
有効にするメッセージ。
dwBlock
無効にするメッセージ。
注釈
2 本指でのパンを無効にして、1 本の指でパンを維持することは不可能です。 GC_PAN_WITH_SINGLE_FINGER_HORIZONTALLYまたはGC_PAN_WITH_SINGLE_FINGER_VERTICALLYに設定する前に、GC_PANの必要なビットを設定する必要があります。
慣性ベクトルは、 SetGestureConfig の呼び出しによって慣性が無効にされた場合、GF_END フラグを持つGID_PAN メッセージに含まれます。
この構造体を渡すと、 dwID メンバーには一連のジェスチャの情報が含まれます。 これにより、他のフラグの意味が決まります。 パン メッセージのフラグを設定すると、回転メッセージに設定されているフラグとは異なります。
次の表は、GESTURECONFIG 構造体の dwID メンバーによってサポートされているジェスチャのさまざまな識別子を示しています。 dwID を 0 に設定すると、グローバル ジェスチャ構成フラグが設定されることを示します。
| 名前 | 値 | 説明 |
|---|---|---|
| GID_ZOOM | 3 | ズーム ジェスチャの構成設定を示します。 |
| GID_PAN | 4 | パン ジェスチャを示します。 |
| GID_ROTATE | 5 | 回転ジェスチャを示します。 |
| GID_TWOFINGERTAP | 6 | 2 本指のタップ ジェスチャを示します。 |
| GID_PRESSANDTAP | 7 | 押しジェスチャとタップ ジェスチャを示します。 |
dwID が 0 に設定されている場合は、次のフラグが使用されます。
| 名前 | 値 | 説明 |
|---|---|---|
| GC_ALLGESTURES | 0x00000001 | すべてのジェスチャを示します。 |
dwID が GID_ZOOM に設定されている場合は、次のフラグが使用されます。
| 名前 | 値 | 説明 |
|---|---|---|
| GC_ZOOM | 0x00000001 | ズーム ジェスチャを示します。 |
dwID が GID_PAN に設定されている場合は、次のフラグが使用されます。
| 名前 | 値 | 説明 |
|---|---|---|
| GC_PAN | 0x00000001 | すべてのパン ジェスチャを示します。 |
| GC_PAN_WITH_SINGLE_FINGER_VERTICALLY | 0x00000002 | 1 本の指で垂直パンを示します。 |
| GC_PAN_WITH_SINGLE_FINGER_HORIZONTALLY | 0x00000004 | 1 本の指で水平パンを示します。 |
| GC_PAN_WITH_GUTTER | 0x00000008 | 余白から抜け出すためにしきい値に達するまで、垂直な移動を主方向に制限します。 |
| GC_PAN_WITH_INERTIA | 0x00000010 | パン ジェスチャが停止したときにスムーズに遅くなる慣性を持つパンを示します。 |
| 名前 | 値 | 説明 |
|---|---|---|
| GC_ROTATE | 0x00000001 | 回転ジェスチャを示します。 |
dwID が GID_TWOFINGERTAP に設定されている場合は、次のフラグが使用されます。
| 名前 | 値 | 説明 |
|---|---|---|
| GC_TWOFINGERTAP | 0x00000001 | 2 本指のタップ ジェスチャを示します。 |
dwID が GID_PRESSANDTAP に設定されている場合は、次のフラグが使用されます。
| 名前 | 値 | 説明 |
|---|---|---|
| GC_PRESSANDTAP | 0x00000001 | 押しジェスチャとタップ ジェスチャを示します。 |
例
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 [デスクトップ アプリのみ] |
| Header | winuser.h (Windows.h を含む) |