Classe InkRecognizerContext
Permet d’effectuer la reconnaissance manuscrite, de récupérer le résultat de la reconnaissance et de récupérer d’autres. InkRecognizerContext permet aux différents modules de reconnaissance installés sur un système d’utiliser la reconnaissance manuscrite pour traiter les entrées de manière appropriée.
InkRecognizerContext a les types de membres suivants :
Événements
La classe InkRecognizerContext a ces événements.
Événement | Description |
---|---|
Reconnaissance | Se produit lorsque InkRecognizerContext a généré des résultats à partir de la méthode BackgroundRecognize. |
RecognitionWithAlternates | Se produit lorsque InkRecognizerContext a généré des résultats après avoir appelé la méthode BackgroundRecognizeWithAlternates |
Interfaces
La classe InkRecognizerContext définit ces interfaces.
Interface | Description |
---|---|
IInkRecognizerContext | Cet objet implémente l’interface COM IInkRecognizerContext . |
Méthodes
La classe InkRecognizerContext a ces méthodes.
Méthode | Description |
---|---|
BackgroundRecognize | Spécifie que le module de reconnaissance doit reconnaître les traits associés et déclencher un événement de reconnaissance lorsque la reconnaissance est terminée. |
BackgroundRecognizeWithAlternates | Spécifie que le module de reconnaissance doit reconnaître les traits associés et déclencher un événement RecognitionWithAlternates lorsque la reconnaissance est terminée. |
Clone | Crée un inkRecognizerContext en double. |
EndInkInput | Termine l’entrée manuscrite dans InkRecognizerContext. |
IsStringSupported | Indique si le dictionnaire système, le dictionnaire utilisateur ou la liste de mots contiennent une chaîne spécifiée. |
Recognize | Effectue la reconnaissance sur une collection InkStrokes et retourne les résultats de la reconnaissance. |
StopBackgroundRecognition | Met fin à la reconnaissance en arrière-plan démarrée avec un appel à BackgroundRecognize ou BackgroundRecognizeWithAlternates. |
Propriétés
La classe InkRecognizerContext a ces propriétés.
Propriété | Type d’accès | Description |
---|---|---|
CharacterAutoCompletion |
Lecture/écriture |
Obtient ou définit le mode de saisie semi-automatique des caractères, qui détermine quand des caractères ou des mots sont reconnus. |
Factoid |
Lecture/écriture |
Obtient ou définit le nom de chaîne du factoid utilisé par l’objet InkRecognizerContext . |
Guide |
Lecture/écriture |
Obtient ou définit le InkRecognizerGuide à utiliser pour l’entrée manuscrite. |
PrefixText |
Lecture/écriture |
Obtient ou définit les caractères qui précèdent la collection InkStrokes dans l’objet InkRecognizerContext . |
RecognitionFlags |
Lecture/écriture |
Obtient ou définit les indicateurs qui spécifient comment le module de reconnaissance interprète l’encre et détermine la chaîne de résultat. |
Module de reconnaissance |
Lecture/écriture |
Obtient ou définit l’objet IInkRecognizer utilisé par l’objet InkRecognizerContext . |
Coups |
Lecture/écriture |
Obtient ou définit la collection InkStrokes associée à l’objet InkRecognizerContext . |
SuffixeText |
Lecture/écriture |
Obtient ou définit les caractères qui viennent après la collection InkStrokes dans l’objet InkRecognizerContext . |
Dictionnaire |
Lecture/écriture |
Obtient ou définit l’objet InkWordList utilisé pour améliorer les résultats de la reconnaissance. |
Notes
Cet objet peut être instancié en appelant la méthode CoCreateInstance en C++.
Il existe deux types de reconnaissance : l’arrière-plan (asynchrone) ou le premier plan (synchrone). La reconnaissance en arrière-plan est démarrée par un appel aux méthodes BackgroundRecognize ou BackgroundRecognizeWithAlternates, se produit sur un thread d’arrière-plan et signale les résultats à l’application via un mécanisme d’événement. La reconnaissance au premier plan ne retourne pas tant que toute la reconnaissance n’est pas terminée, ce qui rend les résultats de reconnaissance accessibles au thread appelant sans écouter l’événement de reconnaissance.
L’entrée manuscrite est traitée en continu en arrière-plan. Si un IInkStrokeDisp est ajouté à la collection InkStrokes à laquelle le InkRecognizerContext fait référence, le IInkStrokeDisp est alors reconnu immédiatement. Pour plus d’informations, consultez les remarques de la rubrique de la méthode EndInkInput .
Toutes les reconnaissances se produisent par le biais d’un contexte de reconnaissance. Le contexte définit les paramètres d’une session de reconnaissance unique. Il reçoit l’encre qui doit être reconnue et définit les contraintes sur l’entrée manuscrite et sur la sortie de reconnaissance. Les contraintes qui peuvent être définies sur le contexte incluent la langue, le dictionnaire et la grammaire utilisées.
Notes
La définition de propriétés autres que les propriétés Strokes ou CharacterAutoCompletion réussit uniquement si la collection InkStrokes a la valeur NULL. Vous devez définir les autres propriétés avant d’attacher la collection InkStrokes à InkRecognizerContext, ou vous devez définir la collection InkStrokes sur NULL , puis définir les autres propriétés. Si vous définissez la collection InkStrokes sur NULL , puis définissez les autres propriétés, vous devrez peut-être rattacher la collection InkStrokes. Cela est dû au fait que la reconnaissance commence juste après avoir affecté les séquences d’encre à InkRecognizerContext. Lorsqu’un appel est effectué à la méthode Recognize [Classe InkRecognizeContext] ou BackgroundRecognize, les résultats des appels peuvent être déjà disponibles.
Pour améliorer les performances de votre application, supprimez votre objet InkRecognizerContext lorsqu’il n’est plus nécessaire.
Spécifications
Condition requise | Valeur |
---|---|
Client minimal pris en charge |
Windows XP Tablet PC Edition [applications de bureau uniquement] |
Serveur minimal pris en charge |
Aucun pris en charge |
En-tête |
|
Bibliothèque |
|