Struttura GESTURECONFIG (winuser.h)

Articolo
03/15/2023

Ottiene e imposta la configurazione per abilitare i messaggi di movimento e il tipo di questa configurazione.

Sintassi

typedef struct tagGESTURECONFIG {
  DWORD dwID;
  DWORD dwWant;
  DWORD dwBlock;
} GESTURECONFIG, *PGESTURECONFIG;

Members

dwID

Identificatore per il tipo di configurazione che avrà messaggi abilitati o disabilitati. Per altre informazioni, vedere la sezione Osservazioni.

dwWant

Messaggi da abilitare.

dwBlock

Messaggi da disabilitare.

Commenti

Non è possibile disabilitare la panoramica a due dita e mantenere la panoramica a dito singolo. È necessario impostare i bit desiderati per GC_PAN prima di poterli impostare per GC_PAN_WITH_SINGLE_FINGER_HORIZONTALLY o GC_PAN_WITH_SINGLE_FINGER_VERTICALLY.

Un vettore inertia è incluso nel messaggio di GID_PAN con il flag di GF_END se l'inerzia è stata disabilitata da una chiamata a SetGestureConfig.

Quando si passa questa struttura, il membro dwID contiene informazioni per un set di movimenti. Ciò determina il significato degli altri flag. Se si impostano i flag per i messaggi di panoramica, saranno diversi da quelli impostati per i messaggi di rotazione.

La tabella seguente indica i vari identificatori per i movimenti supportati dal membro dwID della struttura GESTURECONFIG . Si noti che l'impostazione di dwID su 0 indica che i flag di configurazione dei movimenti globali sono impostati.

Nome	Valore	Descrizione
GID_ZOOM	3	Indica le impostazioni di configurazione per il movimento di zoom.
GID_PAN	4	Indica il movimento di panoramica.
GID_ROTATE	5	Indica il movimento di rotazione.
GID_TWOFINGERTAP	6	Indica il movimento di tocco a due dita.
GID_PRESSANDTAP	7	Indica il movimento di pressione e tocco.

I flag seguenti vengono usati quando dwID è impostato su 0.

Nome	Valore	Descrizione
GC_ALLGESTURES	0x00000001	Indica tutti i movimenti.

I flag seguenti vengono usati quando dwID è impostato su GID_ZOOM.

Nome	Valore	Descrizione
GC_ZOOM	0x00000001	Indica il movimento di zoom.

I flag seguenti vengono usati quando dwID è impostato su GID_PAN.

Nome	Valore	Descrizione
GC_PAN	0x00000001	Indica tutti i movimenti di panoramica.
GC_PAN_WITH_SINGLE_FINGER_VERTICALLY	0x00000002	Indica le pani verticali con un dito.
GC_PAN_WITH_SINGLE_FINGER_HORIZONTALLY	0x00000004	Indica le pani orizzontali con un dito.
GC_PAN_WITH_GUTTER	0x00000008	Limita lo spostamento perpendicolare alla direzione primaria fino a quando non viene raggiunta una soglia per uscire dalla gutter.
GC_PAN_WITH_INERTIA	0x00000010	Indica la panoramica con inertia per lentezza quando i movimenti di panoramica si arrestano.

Nota L'impostazione dei flag di GID_PAN in SetGestureConfig influisce sul gestore dei movimenti predefinito per la panoramica. Non dovrebbe essere impostato sia dwWant che dwBlock per gli stessi flag; ciò comporta un comportamento imprevisto. Per altre informazioni sul supporto di panoramica e panoramica legacy, vedere Movimenti touch di Windows ; vedere SetGestureConfig per esempi di abilitazione e blocco dei movimenti.

I flag seguenti vengono usati quando dwID è impostato su GID_ROTATE.

Nome	Valore	Descrizione
GC_ROTATE	0x00000001	Indica il movimento di rotazione.

I flag seguenti vengono usati quando dwID è impostato su GID_TWOFINGERTAP.

Nome	Valore	Descrizione
GC_TWOFINGERTAP	0x00000001	Indica il movimento di tocco a due dita.

I flag seguenti vengono usati quando dwID è impostato su GID_PRESSANDTAP.

Nome	Valore	Descrizione
GC_PRESSANDTAP	0x00000001	Indica il movimento di pressione e tocco.

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]
Intestazione	winuser.h (include Windows.h)

Vedi anche

GetGestureConfig

SetGestureConfig

Strutture

Condividi tramite