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
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 |
|
| Bibliothèque |
|