Funzione GetGestureConfig (winuser.h)

Articolo
03/15/2023

Recupera la configurazione per cui vengono inviati messaggi di movimento tocco di Windows da una finestra.

Sintassi

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

Parametri

[in] hwnd

Handle nella finestra da cui ottenere la configurazione dei movimenti.

[in] dwReserved

Questo valore è riservato e deve essere impostato su 0.

[in] dwFlags

Valore del flag di comando di movimento che indica le opzioni per il recupero della configurazione dei movimenti. Per altre informazioni e valori supportati, vedere Osservazioni.

[in] pcIDs

Dimensioni, in numero di strutture di configurazione dei movimenti, ovvero nel buffer pGestureConfig .

[in, out] pGestureConfig

Matrice di strutture di configurazione dei movimenti che specificano la configurazione dei movimenti.

[in] cbSize

Dimensioni della struttura di configurazione dei movimenti (GESTURECONFIG).

Valore restituito

Se la funzione ha esito positivo, il valore restituito è diverso da zero.

Se la funzione ha esito negativo, il valore restituito è zero. Per ottenere informazioni sull'errore estese, usare la funzione GetLastError .

Commenti

Passando un valore diverso sizeof(GESTURECONFIG) da per il parametro cbSize , le chiamate a questa funzione avranno esito negativo e GetLastError restituirà ERROR_INVALID_PARAMETER (87 in decimale).

Nella tabella seguente sono elencati i valori di configurazione dei movimenti:

Nome	Valore	Descrizione
GCF_INCLUDE_ANCESTORS	0x00000001	Se specificato, GetGestureConfig restituisce la configurazione consolidata per la finestra specificata e la relativa catena di finestre padre.

Esempio

    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();                                       
    }

Requisiti

Requisito	Valore
Client minimo supportato	Windows 7 [solo app desktop]
Server minimo supportato	Windows Server 2008 R2 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	winuser.h (include Windows.h)
Libreria	User32.lib
DLL	User32.dll
Set di API	ext-ms-win-ntuser-misc-l1-2-0 (introdotto in Windows 8.1)

Vedi anche

Funzioni

GESTURECONFIG

Guida alla programmazione per i movimenti

Condividi tramite