Partager via


HRECOCONTEXT Handle

Un handle HRECOCONTEXT permet d’ajouter de l’encre au contexte, d’effectuer la reconnaissance manuscrite (de manière synchrone ou asynchrone), de récupérer le résultat de la reconnaissance et de récupérer des éléments de remplacement.

La principale raison d’avoir des handles de contexte de reconnaissance est de différencier les entrées manuscrites. Par exemple, vous pouvez créer une application avec deux fenêtres, l’utilisateur pouvant effectuer une entrée manuscrite dans l’une ou l’autre fenêtre. Vous ne souhaitez pas que l’encre de la première fenêtre 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 entrant dans la fenêtre 1 dans le contexte de reconnaissance 1 et des traits de la fenêtre 2 dans le contexte de reconnaissance 2. Pour retourner des résultats de reconnaissance, appelez le processus sur le contexte de reconnaissance 1 ou le contexte de reconnaissance 2, selon que vous souhaitez obtenir les résultats de la fenêtre 1 ou 2.

Le handle de contexte de reconnaissance peut être ce que vous voulez. Mais il s’agit généralement d’un index dans un tableau global de structures. Les structures peuvent contenir tous les traits entrés et toutes les variables que le module de reconnaissance utilise pour ce morceau d’encre particulier (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 un morceau d’encre particulier.

Pour obtenir un handle HRECOCONTEXT , appelez la fonction CreateContext .

typedef HANDLE HRECOCONTEXT;

Notes

Voici les fonctions HRECOCONTEXT

Fonction Description
AddStroke Ajoute un trait d’encre au contexte du module de reconnaissance.
AdviseInkChange Empêche le module de reconnaissance de traiter l’entrée manuscrite, car un nouveau trait est ajouté ou supprimé.
CloneContext Crée un contexte de reconnaissance qui contient les mêmes paramètres que l’original. Le nouveau contexte de reconnaissance n’inclut pas les résultats d’entrée manuscrite ou de reconnaissance de l’original.
EndInkInput Indique qu’aucune entrée manuscrite supplémentaire n’est 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.
GetBestResultString Retourne la meilleure chaîne de résultat.
GetContextPropertyList Retourne une liste de 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 l’outil de reconnaissance.
GetEnabledUnicodeRanges Retourne une liste de plages de points Unicode activées sur le contexte.
GetGuide Retourne le guide utilisé pour l’entrée en boîte ou en ligne.
GetLatticePtr Retourne un pointeur vers le réseau pour les résultats actuels.
IsStringSupported Retourne une valeur qui indique si un mot, une date, une heure, un nombre ou un autre texte transmis est contenu dans le dictionnaire.
Processus Effectue la reconnaissance manuscrite de manière synchrone.
ResetContext Supprime les résultats actuels de l’entrée manuscrite et de la reconnaissance du contexte.
SetCACMode Spécifie le mode de saisie semi-automatique des caractères pour la reconnaissance de caractères ou de mots.
SetContextPropertyValue Ajoute une propriété au contexte du 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 limiter sa recherche du résultat.
SetFlags Définit la façon dont l’outil de reconnaissance interprète l’encre et détermine la chaîne de résultat.
SetGuide Définit le guide à utiliser pour les entrées en boîte ou en ligne.
SetTextContext Fournit les chaînes de texte qui arrivent avant et après le texte contenu dans le contexte du module de reconnaissance. Pour les éléments de reconnaissance de caractères d’Asie de l’Est, 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 reconnaissance actuel à reconnaître.

Spécifications

Condition requise Valeur
Client minimal pris en charge
Windows XP Édition Tablet PC [applications de bureau uniquement]
Serveur minimal pris en charge
Aucun pris en charge
En-tête
Recapis.h