Événement InkCollector.SystemGesture

Article
06/13/2023

Se produit lorsqu’un mouvement système est reconnu.

Syntaxe

void SystemGesture(
  [in] IInkCursor       *Cursor,
  [in] InkSystemGesture Id,
  [in] long             X,
  [in] long             Y,
  [in] long             Modifier,
  [in] BSTR             Character,
  [in] long             CursorMode
);

Paramètres

Curseur [in]: Objet IInkCursor qui a généré l’événement SystemGesture .
ID [in]: Valeur du mouvement système.
X [in]: Coordonnée x de l’emplacement du mouvement.
Y [in]: Coordonnée y de l’emplacement du mouvement.
Modificateur [in]: Réservé.
Caractère [in]: Réservé.
CursorMode [in]: Valeur qui indique si l’objet IInkCursor est en mode normal ou en mode gomme. 1 est pour le mode normal et 2 pour le mode gomme.

Valeur retournée

Cet événement ne retourne pas de valeur.

Notes

Les mouvements système sont utiles, car ils fournissent des informations sur l’objet IInkCursor utilisé pour créer le mouvement. Ils fournissent également des raccourcis vers des combinaisons d’événements de souris et sont des moyens « moins chers » de détecter les événements de souris.

Par exemple, au lieu de rechercher une paire d’événements MouseUp Event / MouseDown Event d’événements sans aucun autre événement de souris se produisant entre les deux, vous pouvez rechercher les mouvements système Tap ou RightTap .

Par exemple, au lieu d’écouter les événementsMouseMove Event MouseDown / et d’obtenir de nombreux messages d’événement MouseMove, vous pouvez watch pour les mouvements système Glisser ou DroiteDrag tant que vous n’êtes pas intéressé par les coordonnées (x, y) de chaque position de la souris. Cela vous permet de recevoir un seul message au lieu de nombreux messages d’événement MouseMove .

Pour obtenir la liste des mouvements système spécifiques, consultez le type d’énumération InkSystemGesture . Pour plus d’informations sur les mouvements système, consultez Utilisation de mouvements et entrée de commande sur le Tablet PC.

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

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

InkCollector, classe
InkSystemGesture, énumération
IInkCursor, interface
Utilisation de mouvements
Entrée, entrée manuscrite et reconnaissance du stylet
Entrée de commande sur le Tablet PC