SetTextContext, fonction (recapis.h)
Fournit les chaînes de texte qui précèdent et suivent le texte contenu dans le contexte du module de reconnaissance.
Vous appelez cette fonction avant de traiter l’entrée manuscrite pour la première fois. Par conséquent, appelez la fonction SetTextContext avant d’appeler la fonction Process .
Syntaxe
HRESULT SetTextContext(
HRECOCONTEXT hrc,
ULONG cwcBefore,
const WCHAR *pwcBefore,
ULONG cwcAfter,
const WCHAR *pwcAfter
);
Paramètres
hrc
Gérez le contexte du module de reconnaissance.
cwcBefore
Nombre de caractères dans pwcBefore.
pwcBefore
Chaîne de texte qui précède le texte contenu dans le contexte du module de reconnaissance. La chaîne n’est pas terminée par null .
cwcAfter
Nombre de caractères dans pwcAfter.
pwcAfter
Chaîne de texte qui vient après le texte contenu dans le contexte du module de reconnaissance. La chaîne n’est pas terminée par NULL .
Valeur renvoyée
Cette fonction peut retourner l’une de ces valeurs.
Code de retour | Description |
---|---|
|
Réussite. |
|
Le contexte n’est pas valide ou l’un des paramètres est un pointeur non valide. |
|
Le module de reconnaissance ne prend pas en charge cette fonction. |
|
Impossible d’allouer de la mémoire pour terminer l’opération. |
|
Une erreur non spécifiée s'est produite. |
|
Un argument non valide a été spécifié. |
Notes
La fonction SetTextContext fournit un contexte pour une expression ou un mot, ce qui augmente la précision de votre module de reconnaissance. Par exemple, si la chaîne pwcBeforepwcBefore est « under the » et la chaîne pwcAfter est « in the house », vous pouvez biaiser votre module de reconnaissance à l’aide d’un mot ou de mots entre les chaînes. Votre module de reconnaissance doit prendre en compte l’espace après « le » et avant « in » lors de l’exécution de la reconnaissance.
Toutefois, si la chaîne pwcAfter est « Hel » et la chaîne pwcBefore est « o », le manque d’espace entre les chaînes indique que le module de reconnaissance doit reconnaître une ou plusieurs lettres à l’intérieur d’un mot qui commence par « Hel » et se termine par « o ».
Il est recommandé de limiter la longueur du contexte de texte à 1 024 caractères chacun pour les contextes de gauche et de droite.
Spécifications
Client minimal pris en charge | Windows XP Édition Tablet PC [applications de bureau | Applications UWP] |
Serveur minimal pris en charge | Aucun pris en charge |
Plateforme cible | Windows |
En-tête | recapis.h |
DLL | inkobjcore.dll |