Méthode IInkOverlay::get_CollectionMode (msinkaut.h)

Article
08/24/2023

Obtient ou définit le mode de collection qui détermine si l’encre, le mouvement ou les deux sont reconnus lorsque l’utilisateur écrit.

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

Syntaxe

HRESULT get_CollectionMode(
  InkCollectionMode *Mode
);

Paramètres

Mode

Valeur de retour

None

Notes

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’encre 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 une fois qu’ils ont été envoyés au module de reconnaissance de mouvements.
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

L’encre 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’encre.

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 encre qui ressemble au mouvement connu et que le mouvement connu figure dans la liste des substituts de l’outil de reconnaissance, l’événement Mouvement se déclenche et l’encre 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 l’annulation de 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 collection d’encre 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 Geste , traitez le mouvement.
Définissez DynamicRendering sur FALSE pour empêcher le flux d’encre lors de la gesturation.

Spécifications


Client minimal pris en charge	Windows XP Édition Tablet 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