CollectionMode, énumération

Article
11/05/2008

Mise à jour : November 2007

Définit des valeurs qui indiquent si l'entrée manuscrite, les mouvements, ou les deux, sont reconnus à mesure que l'utilisateur écrit.

Espace de noms : Microsoft.Ink
Assembly : Microsoft.Ink (dans Microsoft.Ink.dll)

Syntaxe

'Déclaration
Public Enumeration CollectionMode
'Utilisation
Dim instance As CollectionMode

public enum CollectionMode

public enum class CollectionMode

public enum CollectionMode

public enum CollectionMode

Membres

	Nom de membre	Description
	InkOnly	Collecte uniquement l'entrée manuscrite, ce qui crée un trait. L'intérêt d'événement InkCollector.Gesture, InkOverlay.Gesture ou InkPicture.Gesture a la valeur false, ce qui signifie que les mouvements ne sont pas collectés (tous les autres intérêts d'événement restent tels quels).
	GestureOnly	Collecte uniquement les mouvements et ne crée pas de trait. Les mouvements peuvent être monotraits ou multitraits. Les mouvements multitraits sont acceptés si les traits sont tracés dans la période définie par la minuterie intégrée du module de reconnaissance. Tous les événements associés à des traits et à des paquets ne se déclenchent pas à partir de l'objet InkCollector, de l'objet InkOverlay ou du contrôle InkPicture. Les événements de curseur se déclenchent et l'entrée manuscrite est toujours supprimée. L'intérêt d'événement InkCollector.Gesture, InkOverlay.Gesture ou InkPicture.Gesture a la valeur true, ce qui signifie que les mouvements sont collectés (tous les autres intérêts d'événement restent tels quels).
	InkAndGesture	Accepte les mouvements monotraits uniquement. L'événement InkCollector.Gesture, InkOverlay.Gesture ou InkPicture.Gesture se déclenche en premier, ce qui vous permet d'annuler ou accepter l'événement. L'événement est accepté par défaut, sauf lorsque la valeur NoGesture de ApplicationGesture, est le mouvement principal. Si le mouvement est accepté, l'entrée manuscrite est supprimée. Si le mouvement est annulé, le trait n'est pas supprimé et un événement InkCollector.Stroke, InkOverlay.Stroke ou InkPicture.Stroke se déclenche. L'intérêt d'événement InkCollector.Gesture, InkOverlay.Gesture ou InkPicture.Gesture a la valeur true, ce qui signifie que les mouvements sont collectés (tous les autres intérêts d'événement restent tels quels).

Notes

Si un utilisateur clique avec le bouton droit et déplace le stylet en mode InkOnly ou InkAndGesture, la pointe du stylet génère l'entrée manuscrite. Lorsque vous gérez l'événement InkCollector.Stroke, InkOverlay.Stroke ou InkPicture.Stroke, effacez l'entrée manuscrite générée suite au mouvement du stylet.

Lorsque la propriété InkCollector.CollectionMode, InkOverlay.CollectionMode ou InkPicture.CollectionMode a la valeur GestureOnly, le délai d'attente entre le moment où un utilisateur ajoute un mouvement et celui où l'événement InkCollector.Gesture, InkOverlay.Gesture, InkPicture.Gesture se produit est une valeur fixe que vous ne pouvez pas modifier par programme. La reconnaissance de mouvement est plus rapide en mode InkAndGesture. Pour éviter la collecte d'entrée manuscrite en mode InkAndGesture, vous pouvez :

Affecter la valeur InkAndGesture au mode de collecte.
Supprimer le trait dans le gestionnaire pour le InkCollector.Stroke, InkOverlay.Stroke ou le InkPicture.Stroke.
Traiter le mouvement dans le gestionnaire d'événements de mouvement.
Affecter la valeur false à la propriété InkCollector.DynamicRendering, InkOverlay.DynamicRendering ou InkPicture.DynamicRendering.

Lors de l'utilisation de cette énumération avec le contrôle InkPicture, ou les objets InkCollector ou InkOverlay, sur un système équipé du Kit de développement logiciel (SDK) Windows® XP Édition Tablet PC, mais ne disposant pas de module de reconnaissance, le mode ne peut pas avoir la valeur GestureOnly ou InkAndGesture.

Les scénarios classiques pour chaque mode de collecte figurent ci-après.

Remarque :
Si le curseur ne dépasse pas les limites de l'objet de collection situé entre des traits, les évènements de curseurs situés à l'intérieur et à l'extérieur des limites ne se déclenchent pas.

InkOnly

Étape	Objet InkCollector	Objet InkOverlay	Contrôle InkPicture
1	Un événement CursorInRange se déclenche.	Un événement CursorInRange se déclenche.	Un événement CursorInRange se déclenche.
2	Un événement NewInAirPackets se déclenche.	Un événement NewInAirPackets se déclenche.	Un événement NewInAirPackets se déclenche.
3	Un événement CursorDown se déclenche.	Un événement CursorDown se déclenche.	Un événement CursorDown se déclenche.
4	Un événement NewPackets se déclenche.	Un événement NewPackets se déclenche.	Un événement NewPackets se déclenche.
5	Un objet Stroke est créé.	Un objet Stroke est créé.	Un objet Stroke est créé.
6	Un événement CursorOutOfRange se déclenche.	Un événement CursorOutOfRange se déclenche.	Un événement CursorOutOfRange se déclenche.

GestureOnly

Étape	Objet InkCollector	Objet InkOverlay	Contrôle InkPicture
1	Un événement CursorInRange se déclenche.	Un événement CursorInRange se déclenche.	Un événement CursorInRange se déclenche.
2	Un événement NewInAirPackets se déclenche.	Un événement NewInAirPackets se déclenche.	Un événement NewInAirPackets se déclenche.
3	Un événement CursorDown se déclenche.	Un événement CursorDown se déclenche.	Un événement CursorDown se déclenche.
4	Un événement NewPackets se déclenche.	Un événement NewPackets se déclenche.	Un événement NewPackets se déclenche.
5	Un objet Gesture est créé ou, si le curseur ne se déplace pas, rien ne se produit.	Un objet Gesture est créé ou, si le curseur ne se déplace pas, rien ne se produit.	Un objet Gesture est créé ou, si le curseur ne se déplace pas, rien ne se produit.
6	Un événement CursorOutOfRange se déclenche.	Un événement CursorOutOfRange se déclenche.	Un événement CursorOutOfRange se déclenche.

Remarque :
Les mouvements monotraits ou multitraits sont acceptés dans ce mode.

InkAndGesture

Étape	Objet InkCollector	Objet InkOverlay	Contrôle InkPicture
1	Un événement CursorInRange se déclenche.	Un événement CursorInRange se déclenche.	Un événement CursorInRange se déclenche.
2	Un événement NewInAirPackets se déclenche.	Un événement NewInAirPackets se déclenche.	Un événement NewInAirPackets se déclenche.
3	Un événement CursorDown se déclenche.	Un événement CursorDown se déclenche.	Un événement CursorDown se déclenche.
4	Un événement NewPackets se déclenche.	Un événement NewPackets se déclenche.	Un événement NewPackets se déclenche.
5	Un objet Gesture ou Stroke est créé.	Un objet Gesture ou Stroke est créé.	Un objet Gesture ou Stroke est créé.
6	Un événement CursorOutOfRange se déclenche.	Un événement CursorOutOfRange se déclenche.	Un événement CursorOutOfRange se déclenche.

Remarque :
Seuls les mouvements monotraits sont acceptés dans ce mode.

Un comportement non désiré peut se produire lorsque la propriété InkCollector.CollectionMode, InkOverlay.CollectionMode ou InkPicture.CollectionMode a la valeur InkAndGesture et que l'intérêt d'un objet ou contrôle dans un mouvement donné est défini (en appelant la méthode InkCollector.SetGestureStatus, InkOverlay.SetGestureStatus ou InkPicture.SetGestureStatus). Si un utilisateur trace une entrée manuscrite qui ressemble à un mouvement répertorié dans la liste des propositions de substitution du module de reconnaissance, l'événement de mouvement se déclenche et l'entrée manuscrite disparaît, même si le mouvement n'est pas la meilleure proposition de substitution. Pour éviter la disparition de l'entrée manuscrite et l'annulation de la collecte du mouvement, affectez la valeur true à la propriété Cancel (page pouvant être en anglais) héritée de l'objet InkCollectorGestureEventArgs si vous ne souhaitez pas que le module de reconnaissance réponde à cet événement.

Plateformes

Windows Vista

Le .NET Framework et le .NET Compact Framework ne prennent pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.