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

Article
02/29/2024

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.

Note L’objet InkCollector , l’objet InkOverlay ou le contrôle InkPicture génère une erreur si vous essayez de modifier la propriété CollectionMode pendant la collecte de l’encre. Pour éviter ce conflit, case activée la propriété CollectingInk avant de modifier la propriété CollectionMode.

Les comportements suivants se produisent pour chacune des valeurs CollectionMode :

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.

La modification du mode de collecte ne modifie pas la status des mouvements individuels.

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 :

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

Configuration requise

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
Plateforme cible	Windows
En-tête	msinkaut.h
Bibliothèque	InkObj.dll