Structure GESTURECONFIG (winuser.h)

Article
08/28/2023

Obtient et définit la configuration pour l’activation des messages de mouvement et le type de cette configuration.

Syntaxe

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

Membres

dwID

Identificateur du type de configuration pour lequel les messages seront activés ou désactivés. Pour plus d'informations, consultez la section Notes.

dwWant

Messages à activer.

dwBlock

Messages à désactiver.

Remarques

Il est impossible de désactiver le panoramique à deux doigts et de conserver le panoramique d’un seul doigt. Vous devez définir les bits souhaités pour GC_PAN avant de pouvoir les définir pour GC_PAN_WITH_SINGLE_FINGER_HORIZONTALLY ou GC_PAN_WITH_SINGLE_FINGER_VERTICALLY.

Un vecteur d’inertie est inclus dans le message GID_PAN avec l’indicateur GF_END si l’inertie a été désactivée par un appel à SetGestureConfig.

Lorsque vous passez cette structure, le membre dwID contient des informations pour un ensemble de mouvements. Cela détermine ce que signifieront les autres indicateurs. Si vous définissez des indicateurs pour les messages panoramiques, ils seront différents de ceux définis pour les messages de rotation.

Le tableau suivant indique les différents identificateurs des mouvements pris en charge par le membre dwID de la structure GESTURECONFIG . Notez que la définition de dwID sur 0 indique que les indicateurs de configuration des mouvements globaux sont définis.

Nom	Valeur	Description
GID_ZOOM	3	Indique les paramètres de configuration du mouvement de zoom.
GID_PAN	4	Indique le mouvement panoramique.
GID_ROTATE	5	Indique le mouvement de rotation.
GID_TWOFINGERTAP	6	Indique le mouvement d’appui à deux doigts.
GID_PRESSANDTAP	7	Indique le mouvement d’appui et d’appui.

Les indicateurs suivants sont utilisés lorsque dwID est défini sur 0.

Nom	Valeur	Description
GC_ALLGESTURES	0x00000001	Indique tous les mouvements.

Les indicateurs suivants sont utilisés lorsque dwID est défini sur GID_ZOOM.

Nom	Valeur	Description
GC_ZOOM	0x00000001	Indique le mouvement de zoom.

Les indicateurs suivants sont utilisés lorsque dwID est défini sur GID_PAN.

Nom	Valeur	Description
GC_PAN	0x00000001	Indique tous les mouvements panoramiques.
GC_PAN_WITH_SINGLE_FINGER_VERTICALLY	0x00000002	Indique les panoramiques verticaux avec un doigt.
GC_PAN_WITH_SINGLE_FINGER_HORIZONTALLY	0x00000004	Indique les panoramiques horizontaux avec un doigt.
GC_PAN_WITH_GUTTER	0x00000008	Limite le mouvement perpendiculaire à la direction primaire jusqu’à ce qu’un seuil soit atteint pour sortir de la gouttière.
GC_PAN_WITH_INERTIA	0x00000010	Indique un panoramique avec inertie pour ralentir en douceur lorsque les mouvements de panoramique s’arrêtent.

Note La définition des indicateurs GID_PAN dans SetGestureConfig affecte le gestionnaire de mouvements par défaut pour le panoramique. Vous ne devez pas avoir défini dwWant et dwBlock pour les mêmes indicateurs ; cela entraîne un comportement inattendu. Pour plus d’informations sur la prise en charge des mouvements panoramiques et des panoramiques hérités, consultez Mouvements tactiles Windows . Consultez SetGestureConfig pour obtenir des exemples d’activation et de blocage des mouvements.

Les indicateurs suivants sont utilisés lorsque dwID est défini sur GID_ROTATE.

Nom	Valeur	Description
GC_ROTATE	0x00000001	Indique le mouvement de rotation.

Les indicateurs suivants sont utilisés lorsque dwID est défini sur GID_TWOFINGERTAP.

Nom	Valeur	Description
GC_TWOFINGERTAP	0x00000001	Indique le mouvement d’appui à deux doigts.

Les indicateurs suivants sont utilisés lorsque dwID est défini sur GID_PRESSANDTAP.

Nom	Valeur	Description
GC_PRESSANDTAP	0x00000001	Indique le mouvement d’appui et d’appui.

Exemples

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

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 7 [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 R2 [applications de bureau uniquement]
En-tête	winuser.h (inclure Windows.h)

Voir aussi

GetGestureConfig

SetGestureConfig

Structures

Partager via