Événement InkPicture.Gesture

  • Article

Se produit lorsqu’un mouvement spécifique à l’application est reconnu.

Syntaxe

void Gesture(
  [in]      IInkCursor   *Cursor,
  [in]      IInkStrokes  *Strokes,
  [in]      VARIANT      Gestures,
  [in, out] VARIANT_BOOL *Cancel
);

Paramètres

Curseur [in]

Objet IInkCursor qui a généré l’événement Gesture .

Traits [in]

Collection IInkStrokes que le module de reconnaissance a retournée en tant que mouvement.

Mouvements [in]

Tableau d’objets IInkGesture , par ordre de confiance, à partir du module de reconnaissance.

Pour plus d’informations sur la structure VARIANT, consultez Utilisation de la bibliothèque COM.

Annuler [in, out]

VARIANT_TRUE si cet événement doit être annulé, par exemple pour ne pas effacer l’entrée manuscrite et déclencher l’événement Stroke . Sinon, VARIANT_FALSE.

Valeur retournée

Cet événement ne retourne pas de valeur.

Notes

Cette méthode d’événement est définie dans les interfaces _IInkCollectorEvents, _IInkOverlayEvents et _IInkPictureEvents dispatch-only (dispinterfaces) avec un ID de DISPID_ICEGesture.

Lorsque la propriété CollectionMode est définie sur GestureOnly, le délai d’attente entre le moment où un utilisateur ajoute un mouvement et le moment où l’événement Gesture se produit est une valeur fixe que vous ne pouvez pas modifier par programmation. La reconnaissance des mouvements est plus rapide en mode InkAndGesture .

Pour empêcher la collecte d’entrées manuscrites en mode InkAndGesture :

Pour empêcher le flux d’entrée manuscrite lors de la gestation, définissez la propriété DynamicRendering sur FALSE.

En plus de lors de l’insertion d’une entrée manuscrite, l’événement Gesture est déclenché en mode sélection ou effacement. Vous êtes responsable du suivi du mode d’édition et devez connaître le mode avant d’interpréter l’événement.

Notes

Pour reconnaître les mouvements, vous devez utiliser un objet ou un contrôle qui peut collecter des entrées manuscrites.

Les mouvements d’application sont définis comme des mouvements pris en charge dans votre application.

Pour que cet événement se produise, l’objet ou le contrôle doit être intéressé par un ensemble de mouvements d’application. Pour définir les objets ou les contrôles intéressés dans un ensemble de mouvements, appelez la méthode SetGestureStatus de l’objet ou du contrôle.

Pour obtenir la liste des mouvements d’application spécifiques, consultez le type d’énumération InkApplicationGesture .

Spécifications

Condition requise Valeur
Client minimal pris en charge
 Windows XP Édition Tablette PC [applications de bureau uniquement]
Serveur minimal pris en charge
 Aucun pris en charge
En-tête
Msinkaut.h (nécessite également Msinkaut_i.c)
Bibliothèque
InkObj.dll

Voir aussi

Inkpicture

InkApplicationGesture, énumération

SetGestureStatus, méthode

Utilisation de mouvements