Événement InkEdit.Gesture
Se produit lorsqu’un mouvement d’application est reconnu.
Syntaxe
HRESULT Gesture(
[in] IInkCursor *Cursor,
[in] IInkStrokes *Strokes,
[in] VARIANT Gestures,
[in, out] VARIANT_BOOL *Cancel
);
Paramètres
-
Curseur [in]
-
Objet IInkCursor utilisé pour créer ce mouvement.
-
Traits [in]
-
Collection InkStrokes qui contient les objets IInkStrokeDisp qui composent ce mouvement.
-
Mouvements [in]
-
Tableau d’objets IInkGesture , par ordre de confiance.
Pour plus d’informations sur la structure VARIANT, consultez Utilisation de la bibliothèque COM.
-
Annuler [in, out]
-
Indique si la collection InkStrokes qui compose ce mouvement doit être annulée, afin de ne pas effacer l’encre et de déclencher l’événement Stroke .
Valeur retournée
Si cet événement réussit, il retourne S_OK. Sinon, il retourne un code d’erreur HRESULT .
Notes
Cette méthode d’événement est définie dans l’interface _IInkEditEvents . L’interface _IInkEditEvents implémente l’interface IDispatch avec un identificateur de DISPID_IeeGesture.
Un événement Gesture n’est déclenché que si le IInkStrokeDisp de l’objet IInkGesture est le premier objet IInkStrokeDisp depuis le dernier appel à la méthode Recognize ou le dernier déclenchement du délai d’expiration de la reconnaissance.
Si l’événement Gesture est annulé, l’événement Stroke est déclenché pour la collection InkStrokes qui a déclenché l’événement Gesture .
Pour que cet événement se produise, le contrôle InkEdit doit s’abonner à un ensemble de mouvements d’application. Pour définir l’intérêt du contrôle InkEdit pour un ensemble de mouvements, appelez la méthode SetGestureStatus .
Pour obtenir la liste des mouvements d’application, consultez le type d’énumération InkApplicationGesture .
Le contrôle InkEdit ne reconnaît pas plusieurs mouvements de trait.
Le contrôle InkEdit s’abonne aux mouvements suivants.
Mouvement | Action |
---|---|
En bas à gauche, en bas à gauche long |
Entrez |
Droit |
Espace |
Gauche |
Retour arrière |
Haut à droite, Haut à droite-long |
Onglet |
Pour modifier l’action par défaut d’un mouvement :
- Ajoutez des gestionnaires d’événements pour les événements Gesture et Stroke .
- Dans le gestionnaire d’événements Gesture , annulez l’événement Gesture pour le mouvement et effectuez l’autre action pour le mouvement.
- Dans le gestionnaire d’événements Stroke , annulez l’événement Stroke pour l’objet IInkStrokeDisp qui a déclenché l’événement Gesture annulé.
Spécifications
Condition requise | Valeur |
---|---|
Client minimal pris en charge |
Windows XP Édition Tablet PC [applications de bureau uniquement] |
Serveur minimal pris en charge |
Aucun pris en charge |
En-tête |
|
Bibliothèque |
|