InkRecognizerContext, classe

Permet d’effectuer la reconnaissance de l’encre, de récupérer le résultat de la reconnaissance et de récupérer d’autres fonctionnalités. InkRecognizerContext permet aux différents module de reconnaissance installés sur un système d’utiliser la reconnaissance manuscrite pour traiter l’entrée de manière appropriée.

InkRecognizerContext possède les types de membres suivants :

Événements

La classe InkRecognizerContext contient ces événements.

Événement Description
Reconnaissance Se produit lorsque le InkRecognizerContext a généré des résultats de la méthode BackgroundRecognize.
RecognitionWithAlternates Se produit lorsque le InkRecognizerContext a généré des résultats après l’appel de 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 possède 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 Met fin à l’entrée d’encre dans le InkRecognizerContext.
IsStringSupported Indique si le dictionnaire système, le dictionnaire de l’utilisateur ou la liste de mots contient une chaîne spécifiée.
Recognize Effectue la reconnaissance sur une collection InkStrokes et retourne les résultats de la reconnaissance.
StopBackgroundRecognition Termine la reconnaissance en arrière-plan qui a été démarrée avec un appel à BackgroundRecognize ou BackgroundRecognizeWithAlternates.

Propriétés

La classe InkRecognizerContext possède les propriétés suivantes.

Propriété Type d’accès Description
CharacterAutoCompletion
Lecture/écriture
Obtient ou définit le mode de saisie semi-automatique de 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 d’encre.
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.
Reconnaissance
Lecture/écriture
Obtient ou définit l’objet IInkRecognizer utilisé par l’objet InkRecognizerContext .
Traits
Lecture/écriture
Obtient ou définit la collection InkStrokes associée à l’objet InkRecognizerContext .
SuffixText
Lecture/écriture
Obtient ou définit les caractères qui viennent après la collection InkStrokes dans l’objet InkRecognizerContext .
Mots
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 de premier plan n’est pas retournée tant que la reconnaissance n’est pas terminée, rendant ainsi les résultats de la reconnaissance disponibles pour le thread appelant sans écouter l’événement de reconnaissance.

L’encre 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 immédiatement reconnu. Pour plus d’informations, consultez les notes dans la rubrique relative à la méthode EndInkInput .

Toute reconnaissance se produit par le biais d’un contexte de reconnaissance. Le contexte définit les paramètres pour une session de reconnaissance unique. Elle reçoit l’encre qui doit être reconnue et définit les contraintes sur l’entrée d’encre et sur la sortie de reconnaissance. Les contraintes qui peuvent être définies sur le contexte incluent le langage, le dictionnaire et la grammaire en cours d’utilisation.

Notes

La définition de propriétés autres que les traits ou les propriétés CharacterAutoCompletion ne fonctionne que si la collection InkStrokes est null. Vous devez définir les autres propriétés avant d’attacher la collection InkStrokes au InkRecognizerContext, ou vous devez définir la collection InkStrokes sur la valeur null , puis définir les autres propriétés. Si vous affectez la valeur null à la collection InkStrokes, puis définissez les autres propriétés, vous devrez peut-être rattacher la collection InkStrokes. Cela est dû au fait que la reconnaissance démarre juste après que vous avez affecté le InkStrokes au InkRecognizerContext. Lorsqu’un appel est effectué pour reconnaître la méthode [ InkRecognizeContext ] classe ou BackgroundRecognize, les résultats d’appel 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 Applications de bureau XP Édition Tablet PC [ uniquement]
Serveur minimal pris en charge
Aucun pris en charge
En-tête
Msinkaut. h (nécessite également Msinkaut _ i. c)
Bibliothèque
InkObj.dll

Voir aussi

Interface IInkRecognizer

Collection InkStrokes