Méthode IInkCollector ::get_CollectionMode (msinkaut.h)
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
Remarques
Pour obtenir la liste des modes que vous pouvez utiliser, consultez le type d’énumération InkCollectionMode . Toutefois, lorsque vous utilisez la propriété CollectionMode sur un système sur lequel le Kit de développement logiciel (SDK) Microsoft Windows XP Édition Tablet PC est installé, mais qui n’a pas de module de reconnaissance installé, le mode ne peut pas être défini sur GestureOnly ou InkAndGesture.
- 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).
- 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.
- 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.
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.
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 |
| Plateforme cible | Windows |
| En-tête | msinkaut.h |
| Bibliothèque | InkObj.dll |