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
Récapitulatif