GetGestureConfig-Funktion (winuser.h)

Ruft die Konfiguration ab, für die Windows Touch-Gestenmeldungen aus einem Fenster gesendet werden.

Syntax

BOOL GetGestureConfig(
  [in]      HWND           hwnd,
  [in]      DWORD          dwReserved,
  [in]      DWORD          dwFlags,
  [in]      PUINT          pcIDs,
  [in, out] PGESTURECONFIG pGestureConfig,
  [in]      UINT           cbSize
);

Parameter

[in] hwnd

Ein Handle für das Fenster, aus dem die Gestenkonfiguration abgerufen werden soll.

[in] dwReserved

Dieser Wert ist reserviert und muss auf 0 festgelegt werden.

[in] dwFlags

Ein Gestenbefehlsflagwert, der Optionen zum Abrufen der Gestenkonfiguration angibt. Weitere Informationen und unterstützte Werte finden Sie unter Hinweise.

[in] pcIDs

Die Größe in Anzahl der Gestenkonfigurationsstrukturen, die sich im pGestureConfig-Puffer befindet.

[in, out] pGestureConfig

Ein Array von Gestenkonfigurationsstrukturen, die die Gestenkonfiguration angeben.

[in] cbSize

Die Größe der Gestenkonfigurationsstruktur (GESTURECONFIG).

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null.

Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null. Verwenden Sie die GetLastError-Funktion , um erweiterte Fehlerinformationen abzurufen.

Hinweise

Das Übergeben eines anderen Werts als sizeof(GESTURECONFIG) für den cbSize-Parameter führt dazu, dass Aufrufe dieser Funktion fehlschlagen, und GetLastError gibt ERROR_INVALID_PARAMETER zurück (87 im Dezimalwert).

In der folgenden Tabelle sind die Gestenkonfigurationswerte aufgeführt:

Name	Wert	BESCHREIBUNG
GCF_INCLUDE_ANCESTORS	0x00000001	Falls angegeben, gibt GetGestureConfig eine konsolidierte Konfiguration für das angegebene Fenster und die zugehörige übergeordnete Fensterkette zurück.

 

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]
Zielplattform	Windows
Kopfzeile	winuser.h (windows.h einschließen)
Bibliothek	User32.lib
DLL	User32.dll
APIs	ext-ms-win-ntuser-misc-l1-2-0 (eingeführt in Windows 8.1)

Siehe auch

Funktionen

GESTURECONFIG

Programmierhandbuch für Gesten