IInkOverlay ::p ut_CollectionMode, méthode (msinkaut.h)

Obtient ou définit le mode de collection qui détermine si l’entrée manuscrite, le mouvement ou les deux sont reconnus comme écrit par l’utilisateur.

Cette propriété est en lecture/écriture.

Syntaxe

HRESULT put_CollectionMode(
  InkCollectionMode Mode
);

Paramètres

Mode

Valeur de retour

None

Remarques

Pour obtenir la liste des modes que vous pouvez utiliser, consultez le type d’énumération InkCollectionMode . Toutefois, lors de l’utilisation de la propriété CollectionMode sur un système doté de Microsoft Windows ? XP Tablet PC Edition Software Development Kit (SDK) installé, mais qui n’a pas de module de reconnaissance installé, le mode ne peut pas être défini sur GestureOnly ou InkAndGesture.

Mode InkOnly

• Seule l’entrée manuscrite est collectée ; les mouvements ne le sont pas.
• L’intérêt de l’événement Gesture est défini sur FALSE (tous les autres intérêts d’événement restent tels qu’ils étaient).

Mode GestureOnly

• Seuls les mouvements sont collectés ; l’entrée manuscrite n’est pas. Les traits sont supprimés après leur envoi au module de reconnaissance de mouvement.
• L’intérêt de l’événement Gesture est défini sur TRUE (tous les autres intérêts d’événement restent tels qu’ils étaient).
• Le collecteur d’encre ne déclenche pas les événements liés aux traits et aux paquets suivants : les événements CursorDown, Stroke, NewPackets et NewInAirPackets .
• Les événements de curseur se déclenchent.
• L’entrée manuscrite est toujours supprimée.

Mode InkAndGesture

• Les entrées manuscrites et les mouvements sont collectés.
• Seuls les mouvements d’un seul trait sont reconnus.
• L’intérêt de l’événement Gesture est défini sur TRUE (tous les autres intérêts d’événement restent tels qu’ils étaient).
• L’événement Gesture se déclenche en premier, ce qui vous permet d’accepter ou d’annuler le mouvement. Pour annuler le mouvement, définissez le paramètre Cancel sur TRUE. L’annulation du mouvement force le collecteur d’encre à collecter l’entrée manuscrite.

Un comportement indésirable peut se produire lorsque CollectionMode est défini sur InkAndGesture et que l’intérêt d’un objet/contrôle pour un mouvement connu est défini (en appelant la méthode SetGestureStatus ). Si vous dessinez une entrée manuscrite qui ressemble au mouvement connu et que le mouvement connu figure dans la liste des alternatives 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 suppression de l’entrée manuscrite et annuler la collection du mouvement, définissez le paramètre Cancel sur TRUE si l’événement ne vous intéresse pas.

Lorsque CollectionMode est défini 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 qui ne peut pas être modifiée par programmation. La reconnaissance des mouvements est plus rapide en mode InkAndGesture . Pour empêcher la collecte d’entrées manuscrites en mode InkAndGesture , vous pouvez :

1. Définissez la propriété CollectionMode sur InkAndGesture.
2. Dans l’événement Stroke , supprimez le trait.
3. Dans l’événement Gesture , traitez le mouvement.
4. Définissez DynamicRendering sur FALSE pour empêcher le flux d’entrée manuscrite lors de la gesturation.

Configuration requise

Voir aussi

CollectingInk, propriété

Propriété activée

IInkOverlay

InkCollectionMode, énumération

InkOverlay, classe