Événement InkCollector.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, provenant 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 ce mouvement doit être annulé ; 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 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’encre 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’encre lors de la gesture, 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 l’entrée manuscrite.
Les mouvements d’application sont définis comme des mouvements pris en charge au sein de 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 Tablet PC [applications de bureau uniquement] |
| Serveur minimal pris en charge |
Aucun pris en charge |
| En-tête |
|
| Bibliothèque |
|