GESTURECONFIG-Struktur (winuser.h)
Ruft die Konfiguration zum Aktivieren von Gestenmeldungen und den Typ dieser Konfiguration ab und legt sie fest.
Syntax
typedef struct tagGESTURECONFIG {
DWORD dwID;
DWORD dwWant;
DWORD dwBlock;
} GESTURECONFIG, *PGESTURECONFIG;
Member
dwID
Der Bezeichner für den Konfigurationstyp, für den Nachrichten aktiviert oder deaktiviert sind. Weitere Informationen finden Sie in den Hinweisen.
dwWant
Die zu aktivierenden Nachrichten.
dwBlock
Die zu deaktivierenden Nachrichten.
Hinweise
Es ist unmöglich, das Schwenken mit zwei Fingern zu deaktivieren und das Schwenken mit nur einem Finger zu halten. Sie müssen die gewünschten Bits für GC_PAN festlegen, bevor Sie sie für GC_PAN_WITH_SINGLE_FINGER_HORIZONTALLY oder GC_PAN_WITH_SINGLE_FINGER_VERTICALLY festlegen können.
Ein Inertia-Vektor ist in der GID_PAN-Nachricht mit dem GF_END-Flag enthalten, wenn die Inertia durch einen Aufruf von SetGestureConfig deaktiviert wurde.
Wenn Sie diese Struktur übergeben, enthält das dwID-Element Informationen für eine Reihe von Gesten. Dadurch wird bestimmt, was die anderen Flags bedeuten. Wenn Sie Flags für Schwenknachrichten festlegen, unterscheiden sie sich von den Flags, die für Rotationsmeldungen festgelegt sind.
In der folgenden Tabelle sind die verschiedenen Bezeichner für Gesten angegeben, die vom dwID-Element der GESTURECONFIG-Struktur unterstützt werden. Beachten Sie, dass das Festlegen von dwID auf 0 angibt, dass globale Gestenkonfigurationsflags festgelegt sind.
| Name | Wert | BESCHREIBUNG |
|---|---|---|
| GID_ZOOM | 3 | Gibt Konfigurationseinstellungen für die Zoomgeste an. |
| GID_PAN | 4 | Gibt die Schwenkbewegung an. |
| GID_ROTATE | 5 | Gibt die Drehbewegung an. |
| GID_TWOFINGERTAP | 6 | Gibt die Tippbewegung mit zwei Fingern an. |
| GID_PRESSANDTAP | 7 | Gibt die Drücken-und-Tippen-Geste an. |
Die folgenden Flags werden verwendet, wenn dwID auf 0 festgelegt ist.
| Name | Wert | BESCHREIBUNG |
|---|---|---|
| GC_ALLGESTURES | 0x00000001 | Gibt alle Gesten an. |
Die folgenden Flags werden verwendet, wenn dwID auf GID_ZOOM festgelegt ist.
| Name | Wert | BESCHREIBUNG |
|---|---|---|
| GC_ZOOM | 0x00000001 | Gibt die Zoomgeste an. |
Die folgenden Flags werden verwendet, wenn dwID auf GID_PAN festgelegt ist.
| Name | Wert | BESCHREIBUNG |
|---|---|---|
| GC_PAN | 0x00000001 | Gibt alle Schwenkgesten an. |
| GC_PAN_WITH_SINGLE_FINGER_VERTICALLY | 0x00000002 | Gibt vertikale Schwenks mit einem Finger an. |
| GC_PAN_WITH_SINGLE_FINGER_HORIZONTALLY | 0x00000004 | Gibt horizontale Schwenkvorgänge mit einem Finger an. |
| GC_PAN_WITH_GUTTER | 0x00000008 | Begrenzt die senkrechte Bewegung in primärer Richtung, bis ein Schwellenwert erreicht ist, um aus der Rinne auszubrechen. |
| GC_PAN_WITH_INERTIA | 0x00000010 | Gibt an, dass die Verschiebung mit Der Verschiebung sanft verlangsamt wird, wenn schwenkende Gesten angehalten werden. |
| Name | Wert | BESCHREIBUNG |
|---|---|---|
| GC_ROTATE | 0x00000001 | Gibt die Drehbewegung an. |
Die folgenden Flags werden verwendet, wenn dwID auf GID_TWOFINGERTAP festgelegt ist.
| Name | Wert | BESCHREIBUNG |
|---|---|---|
| GC_TWOFINGERTAP | 0x00000001 | Gibt die Tippbewegung mit zwei Fingern an. |
Die folgenden Flags werden verwendet, wenn dwID auf GID_PRESSANDTAP festgelegt ist.
| Name | Wert | BESCHREIBUNG |
|---|---|---|
| GC_PRESSANDTAP | 0x00000001 | Gibt die Drücken-und-Tippen-Geste an. |
Beispiele
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();
}
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 7 [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2008 R2 [nur Desktop-Apps] |
| Kopfzeile | winuser.h (einschließlich Windows.h) |