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) |