Classe InkRecognizerContext

Permet d’effectuer la reconnaissance manuscrite, de récupérer le résultat de la reconnaissance et de récupérer des alternatives. 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
• Interfaces
• Méthodes
• Propriétés

Événements

La classe InkRecognizerContext contient 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 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 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 une fois la reconnaissance terminée.
Clone	Crée un doublon InkRecognizerContext.
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	Termine la reconnaissance en arrière-plan qui a été démarrée par 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 les caractères ou les 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 la façon dont le module de reconnaissance interprète l’entrée manuscrite 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 suivent 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, rendant ainsi les résultats de la reconnaissance disponibles pour le 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 sur la méthode EndInkInput .

Toute la reconnaissance se produit par le biais d’un contexte de module de reconnaissance. Le contexte définit les paramètres d’une session de reconnaissance unique. Il reçoit l’entrée manuscrite qui doit être reconnue et définit les contraintes sur l’entrée manuscrite et sur la sortie de la reconnaissance. Les contraintes qui peuvent être définies sur le contexte incluent la langue, le dictionnaire et la grammaire utilisée.

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 que vous 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 avoir affecté les InkStrokes à InkRecognizerContext. Lorsqu’un appel est effectué à la méthode Recognize [Classe InkRecognizeContext] ou à BackgroundRecognize, les résultats de l’appel peuvent être déjà disponibles.

Pour améliorer les performances de votre application, éliminez votre objet InkRecognizerContext lorsqu’il n’est plus nécessaire.

Spécifications

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
En-tête	Msinkaut.h (nécessite également Msinkaut_i.c)
Bibliothèque	InkObj.dll

Voir aussi

IInkRecognizer Interface

InkStrokes Collection