Condividi tramite


Struttura GESTURECONFIG (winuser.h)

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