Partager via


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
S_OK
Réussite.
E_POINTER
Le contexte n’est pas valide ou l’un des paramètres est un pointeur non valide.
E_NOTIMPL
Le module de reconnaissance ne prend pas en charge cette fonction.
E_OUTOFMEMORY
Impossible d’allouer de la mémoire pour terminer l’opération.
E_FAIL
Une erreur non spécifiée s'est produite.
E_INVALIDARG
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