GESTURECONFIG-Struktur (winuser.h)

Artikel
03/04/2024

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.

Hinweis Das Festlegen der GID_PAN Flags in SetGestureConfig wirkt sich auf den Standardgestenhandler für das Schwenken aus. DwWant und dwBlock sollten nicht für die gleichen Flags festgelegt sein. Dies führt zu unerwartetem Verhalten. Weitere Informationen zur Unterstützung von Verschiebungen und legacy-Verschiebungen finden Sie unter Windows-Touchgesten . Beispiele für das Aktivieren und Blockieren von Gesten finden Sie unter SetGestureConfig .

Die folgenden Flags werden verwendet, wenn dwID auf GID_ROTATE festgelegt ist.

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)

Weitere Informationen

GetGestureConfig

SetGestureConfig

Strukturen

Freigeben über