Événement InkEdit.Gesture

  • Article

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 :

  1. Ajoutez des gestionnaires d’événements pour les événements Gesture et Stroke .
  2. Dans le gestionnaire d’événements Gesture , annulez l’événement Gesture pour le mouvement et effectuez l’autre action pour le mouvement.
  3. 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
Inked.h (nécessite également inked_i.c)
Bibliothèque
InkEd.dll

Voir aussi

Inkedit

InkApplicationGesture, énumération

SetGestureStatus, méthode [Contrôle InkEdit]

RecoTimeout, propriété

Événement stroke [Contrôle InkEdit]

Utilisation de mouvements