Événement InkPicture.Gesture
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 :
- Définissez CollectionMode sur InkAndGesture.
- Supprimez le trait dans l’événement Stroke .
- Traitez le mouvement dans l’événement Gesture .
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 |
|
| Bibliothèque |
|