GESTURECONFIG 結構 (winuser.h)
取得並設定啟用手勢訊息和此組態類型的組態。
語法
typedef struct tagGESTURECONFIG {
DWORD dwID;
DWORD dwWant;
DWORD dwBlock;
} GESTURECONFIG, *PGESTURECONFIG;
成員
dwID
將啟用或停用訊息之組態類型的標識碼。 如需詳細資訊，請參閱＜備註＞。
dwWant
要啟用的訊息。
dwBlock
要停用的訊息。
備註
無法停用雙指移動流覽，並保留單指移動流覽。 您必須先設定GC_PAN的所需位，才能設定GC_PAN_WITH_SINGLE_FINGER_HORIZONTALLY或GC_PAN_WITH_SINGLE_FINGER_VERTICALLY。
慣性向量會包含在GID_PAN訊息中，如果慣性已由 SetGestureConfig 呼叫停用GF_END旗標。
當您傳遞此結構時， dwID 成員會包含一組手勢的資訊。 這會決定其他旗標的意義。 如果您設定行動瀏覽訊息的旗標，它們會與針對旋轉訊息設定的旗標不同。
下表指出 GESTURECONFIG 結構的 dwID 成員所支援的手勢各種標識碼。 請注意，將 dwID 設定為 0 表示已設定全域手勢設定旗標。
| 名稱 | 值 | Description |
|---|---|---|
| GID_ZOOM | 3 | 指出縮放手勢的組態設定。 |
| GID_PAN | 4 | 表示移動瀏覽手勢。 |
| GID_ROTATE | 5 | 表示旋轉手勢。 |
| GID_TWOFINGERTAP | 6 | 表示雙指點選手勢。 |
| GID_PRESSANDTAP | 7 | 表示按下並點選手勢。 |
當 dwID 設定為 0 時，會使用下列旗標。
| 名稱 | 值 | Description |
|---|---|---|
| GC_ALLGESTURES | 0x00000001 | 表示所有手勢。 |
當 dwID 設定為 GID_ZOOM時，會使用下列旗標。
| 名稱 | 值 | Description |
|---|---|---|
| GC_ZOOM | 0x00000001 | 表示縮放手勢。 |
當 dwID 設定為 GID_PAN時，會使用下列旗標。
| 名稱 | 值 | Description |
|---|---|---|
| GC_PAN | 0x00000001 | 表示所有移動瀏覽手勢。 |
| GC_PAN_WITH_SINGLE_FINGER_VERTICALLY | 0x00000002 | 表示具有一指的垂直移動流覽。 |
| GC_PAN_WITH_SINGLE_FINGER_HORIZONTALLY | 0x00000004 | 表示使用一指水平移動流覽。 |
| GC_PAN_WITH_GUTTER | 0x00000008 | 將垂直移動限制為主要方向，直到達到臨界值以中斷線為止。 |
| GC_PAN_WITH_INERTIA | 0x00000010 | 表示移動瀏覽手勢停止時，具有慣性移動流覽速度緩慢的移動流覽。 |
注意在 SetGestureConfig 中設定GID_PAN旗標會影響行動瀏覽的預設手勢處理程式。
您不應該同時為相同的旗標設定 dwWant 和 dwBlock ;這會導致非預期的行為。
如需移動流覽和舊版移動瀏覽支援的詳細資訊，請參閱 Windows Touch 手勢 ;如需啟用和封鎖手勢的範例，請參閱 SetGestureConfig 。
| 名稱 | 值 | Description |
|---|---|---|
| GC_ROTATE | 0x00000001 | 表示旋轉手勢。 |
當 dwID 設定為 GID_TWOFINGERTAP 時，會使用下列旗標。
| 名稱 | 值 | Description |
|---|---|---|
| GC_TWOFINGERTAP | 0x00000001 | 表示雙指點選手勢。 |
當 dwID 設定為 GID_PRESSANDTAP時，會使用下列旗標。
| 名稱 | 值 | Description |
|---|---|---|
| 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 [僅限桌面應用程式] |
| 標頭 | winuser.h (包含 Windows.h) |