Handle HRECOCONTEXT
Un descripteur HRECOCONTEXT est utilisé pour ajouter de l’encre au contexte, effectuer la reconnaissance de l’encre (de façon synchrone ou asynchrone), récupérer le résultat de la reconnaissance et récupérer d’autres.
La raison principale de l’existence de handles de contexte de reconnaissance consiste à faire la distinction entre les entrées d’entrée manuscrite. Par exemple, vous pouvez créer une application avec deux fenêtres, l’utilisateur étant en mesure d’écrire dans l’une ou l’autre fenêtre. Vous ne souhaitez pas que l’encre de la première fenêtre ne soit mélangée à l’encre de la deuxième fenêtre lorsque vous demandez au module de reconnaissance de reconnaître l’encre de l’une des fenêtres. Dans ce type d’application, vous créez deux contextes de reconnaissance (un pour chaque fenêtre) et vous ajoutez des traits qui arrivent dans la fenêtre 1 dans le contexte de reconnaissance 1 et les traits de la fenêtre 2 dans le contexte de reconnaissance 2. Pour retourner les résultats de la reconnaissance, appelez le processus sur le contexte de reconnaissance 1 ou le contexte de reconnaissance 2 selon que vous souhaitez ou non les résultats pour la fenêtre 1 ou 2.
Le handle de contexte du module de reconnaissance peut être tout ce que vous souhaitez. Mais en général, il s’agit d’un index dans un tableau global de structures. Les structures peuvent contenir tous les traits qui ont été entrés et toutes les variables que le module de reconnaissance utilise pour cette partie d’encre particulière (par exemple, votre structure de treillis interne ou l’état actuel de reconnaissance). Une structure peut contenir toutes les informations dont le module de reconnaissance a besoin et utilise pour une partie de l’encre particulière.
Pour récupérer un handle HRECOCONTEXT , appelez la fonction CreateContext .
typedef HANDLE HRECOCONTEXT;
Notes
Les fonctions HRECOCONTEXT sont les suivantes :
| Fonction | Description |
|---|---|
| AddStroke | Ajoute un trait d’encre au contexte du module de reconnaissance. |
| AdviseInkChange | Empêche le module de reconnaissance de traiter l’encre car un nouveau trait est ajouté ou supprimé. |
| CloneContext | Crée un contexte de module de reconnaissance qui contient les mêmes paramètres que le d’origine. Le nouveau contexte de module de reconnaissance n’inclut pas les résultats d’encre ou de reconnaissance de l’original. |
| EndInkInput | Indique qu’aucune entrée manuscrite supplémentaire ne sera ajoutée au contexte. |
| GetAlternateList | Retourne une liste d’alternatives pour la meilleure chaîne de résultat. |
| GetBestAlternate | Retourne un pointeur de handle HRECOALT pour le meilleur résultat alternatif. |
| GetBestResultString | Retourne la meilleure chaîne de résultat. |
| GetContextPropertyList | Retourne la liste des propriétés prises en charge par le module de reconnaissance. |
| GetContextPropertyValue | Retourne une valeur de propriété spécifiée à partir du contexte de module de reconnaissance. |
| GetEnabledUnicodeRanges | Retourne une liste de plages de points Unicode activée sur le contexte. |
| GetGuide | Retourne le repère utilisé pour l’entrée boxed ou lineed. |
| GetLatticePtr | Retourne un pointeur vers le treillis pour les résultats actuels. |
| IsStringSupported | Retourne une valeur qui indique si un mot, une date, une heure, un nombre ou un autre texte passé est contenu dans le dictionnaire. |
| Processus | Effectue la reconnaissance de l’encre de façon synchrone. |
| ResetContext | Supprime l’encre et les résultats de reconnaissance actuels du contexte. |
| SetCACMode | Spécifie le mode de saisie semi-automatique de caractères pour la reconnaissance de caractères ou de mots. |
| SetContextPropertyValue | Ajoute une propriété au contexte de module de reconnaissance. Si une propriété existe déjà, sa valeur est modifiée. |
| SetEnabledUnicodeRanges | Active une ou plusieurs plages de points Unicode sur le contexte. |
| SetFactoid | Définit le Factoid qu’un module de reconnaissance utilise pour contraindre sa recherche au résultat. |
| SetFlags | Définit la façon dont le module de reconnaissance interprète l’encre et détermine la chaîne de résultat. |
| SetGuide | Définit le repère à utiliser pour l’entrée boxed ou lineed. |
| SetTextContext | Fournit les chaînes de texte qui précèdent et suivent le texte contenu dans le contexte du module de reconnaissance. Pour les reconnaissances de caractères d’Extrême-Orient, la fonction SetTextContext fournit des caractères plutôt que des chaînes de texte. |
| SetWordList | Définit la liste de mots pour le contexte de module de reconnaissance actuel à reconnaître. |
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 |
|