Énumération InkCollectionMode (msinkaut.h)

Article
08/24/2023

Définit des valeurs qui déterminent si l’entrée manuscrite, les mouvements ou l’entrée manuscrite et les mouvements sont reconnus au fur et à mesure que l’utilisateur écrit.

Syntax

typedef enum InkCollectionMode {
  ICM_InkOnly = 0,
  ICM_GestureOnly,
  ICM_InkAndGesture
} ;

Constantes


`ICM_InkOnly` Valeur : 0 Collecte uniquement l’encre, ce qui crée un trait. L’intérêt de l’événement Gesture est défini sur FALSE, ce qui signifie que les mouvements ne sont pas collectés (tous les autres intérêts d’événement restent tels qu’ils étaient).
`ICM_GestureOnly` Collecte uniquement les mouvements et ne crée pas de trait. Les mouvements peuvent être simples ou multi-traits. Les mouvements multi-traits sont acceptés si les traits sont effectués dans le délai défini par le minuteur intégré du module de reconnaissance. Tous les événements liés aux traits et aux paquets ne sont pas déclenchés à partir d’InkCollector. Les événements de curseur se déclenchent et l’entrée manuscrite est toujours supprimée. L’intérêt de l’événement Gesture est défini sur TRUE, ce qui signifie que les mouvements sont collectés (tous les autres intérêts d’événement restent tels qu’ils étaient).
`ICM_InkAndGesture` Accepte uniquement les mouvements d’un seul trait. L’événement Gesture se déclenche en premier, ce qui permet à l’utilisateur de dire Annuler = TRUE ou FALSE. La valeur par défaut est TRUE, sauf si NoGesture est le mouvement principal, cancel a la valeur FALSE par défaut. Si la valeur est TRUE, l’entrée manuscrite est un mouvement et est supprimée. Si la valeur est FALSE, le mouvement est manuscrit et un événement Stroke se déclenche. L’intérêt de l’événement Gesture est défini sur TRUE (tous les autres intérêts d’événement sont conservés tels qu’ils étaient).

Remarques

Si un utilisateur tente de cliquer avec le bouton droit et de déplacer le stylet en mode InkOnly ou InkAndGesture, l’entrée manuscrite s’écoule à partir de la pointe du stylet. Lors de la gestion de l’événement Stroke , vous devez effacer l’encre qui s’est transmise à la suite du mouvement du stylet.

Quand InkCollectionMode est défini sur GestureOnly (défini par le biais de la propriété CollectionMode ), 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 qui ne peut pas être modifiée par programmation. La reconnaissance des mouvements est plus rapide en mode InkAndGesture. Pour empêcher la collection d’encre en mode InkAndGesture, vous pouvez :

Définissez CollectionMode sur InkAndGesture.
Dans l’événement Stroke , supprimez le trait.
Dans l’événement Geste , traitez le mouvement.
Définissez DynamicRendering surFALSE.

Lors de l’utilisation de cette énumération avec le contrôle InkPicture (ou les objets InkCollector ou InkOverlay ) sur un système sur lequel le Kit de développement logiciel (SDK) Microsoft Windows XP Tablet PC Edition est installé, mais qui n’a pas de reconnaissances, le mode ne peut pas être défini sur GestureOnly ou InkAndGesture.

Le collecteur d’encre crée toujours un trait (mode InkOnly) ou un mouvement (mode GestureOnly) et parfois créé les deux (mode InkAndGesture).

Les scénarios classiques pour chaque mode suivent.

InkOnly :
1. L’événement CursorInRange se déclenche.
2. L’événement NewInAirPackets se déclenche.
3. L’événement CursorDown se déclenche.
4. L’événement NewPackets se déclenche.
5. L’objet IInkStrokeDisp est créé.
6. L’événement CursorOutOfRange se déclenche.
Note Il est possible que vous ne souhaitiez pas toujours déclencher l’événement CursorOutOfRange . Si vous souhaitez continuer à dessiner de l’encre, vous pouvez revenir aux événements NewInAirPackets ou CursorDown une fois qu’un trait est terminé.
GestureOnly :
1. L’événement CursorInRange se déclenche.
2. L’événement NewInAirPackets se déclenche.
3. L’événement CursorDown se déclenche.
4. L’événement NewPackets se déclenche.
5. Un objet IInkGesture est créé ou, si le mouvement du curseur ne représente pas un mouvement, rien ne se produit.
6. L’événement CursorOutOfRange se déclenche.
Note Les mouvements simples ou multi-traits sont acceptés dans ce mode.
InkAndGesture :
1. L’événement CursorInRange se déclenche.
2. L’événement NewInAirPackets se déclenche.
3. L’événement CursorDown se déclenche.
4. L’événement NewPackets se déclenche.
5. Un objet IInkGesture ou un objet IInkStrokeDisp est créé.
6. L’événement CursorOutOfRange se déclenche.
Note Seuls les mouvements d’un seul trait sont acceptés dans ce mode.

Un comportement indésirable peut se produire lorsque la propriété CollectionMode est définie sur InkAndGesture et que l’intérêt d’un objet ou d’un contrôle dans un mouvement connu est défini (en appelant la méthode SetGestureStatus ). Si un utilisateur dessine une entrée manuscrite qui ressemble à un mouvement figurant dans la liste des substituts de reconnaissance du module de reconnaissance, l’événement Mouvement se déclenche et l’entrée manuscrite disparaît, même si le mouvement n’est pas l’alternative supérieure. Pour empêcher la disparition de l’entrée manuscrite et annuler la collection du mouvement, définissez Cancel sur TRUE si l’événement est un événement auquel vous ne souhaitez pas que le module de reconnaissance réponde.

Configuration requise

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	msinkaut.h