Spécifie la façon dont le module de reconnaissance interprète l’encre et détermine la chaîne de résultat.
Appelez cette fonction avant de traiter l’entrée manuscrite pour la première fois. Par conséquent, appelez la fonction SetFlags avant d’appeler la fonction Process .
Le tableau suivant répertorie les indicateurs que vous pouvez définir pour spécifier la façon dont l’outil de reconnaissance interprète l’encre et détermine la chaîne de résultat. Utilisez l’opérateur OR (|) pour combiner les indicateurs en fonction des besoins.
Indicateur de bits
Signification
RECOFLAG_AUTOSPACE
Recognizer utilise un espacement intelligent basé sur des règles de modèle de langage.
RECOFLAG_COERCE
Recognizer force le résultat en fonction du factoid que vous spécifiez pour le contexte. Par exemple, si vous spécifiez un factoid de numéro de téléphone et que l’utilisateur entre le mot « hello », l’outil de reconnaissance peut renvoyer un numéro de téléphone aléatoire ou une chaîne vide. Si vous ne spécifiez pas cet indicateur, le module de reconnaissance retourne « hello » comme résultat.
RECOFLAG_PREFIXOK
Recognizer prend en charge la reconnaissance de n’importe quelle partie de préfixe des chaînes définies dans le modèle de langage par défaut ou spécifié (factoid).
Par exemple, sans cet indicateur, l’utilisateur écrit « handw » et le module de reconnaissance renvoie des suggestions (telles que « hander » ou « hand ») qui sont des mots qui existent dans le lexique de reconnaissance. Avec l’indicateur, le module de reconnaissance peut retourner « handw » comme l’une des suggestions, car il s’agit d’un préfixe valide du mot « écriture manuscrite » qui existe dans le lexique de reconnaissance.
Le panneau d’entrée Tablet PC définit cet indicateur dans la plupart des cas, sauf lorsque l’étendue d’entrée est IS_DEFAULT (ou pas d’étendue d’entrée) ou lorsqu’il n’existe aucune liste de mots utilisateur ou expression régulière.
Les caractères de reconnaissance de caractères d’Asie de l’Est doivent retourner E_INVALIDARG lorsqu’un appelant passe cet indicateur.
RECOFLAG_LINEMODE
Le module de reconnaissance ne fractionne pas les lignes, mais doit toujours effectuer la séparation des caractères et des mots. Cela est identique au mode aligné, sauf qu’il n’y a pas de repère et que toute l’encre est supposée être dans une seule ligne. Lorsque cet indicateur est défini, un repère, s’il est défini, est ignoré.
RECOFLAG_SINGLESEG
Désactive plusieurs segmentations. Par défaut, le module de reconnaissance retourne plusieurs segmentations (alternatives) pour l’entrée manuscrite.
Par exemple, si vous écrivez « ensemble » sous forme de traits distincts, le module de reconnaissance peut segmenter l’encre comme « pour l’obtenir », « pour rassembler » ou « ensemble ». Définissez cet indicateur si vous n’avez pas besoin de plusieurs segmentations de l’entrée manuscrite lorsque vous interrogez des alternatives. Cela améliore les performances et réduit l’utilisation de la mémoire.
RECOFLAG_WORDMODE
Recognizer traite l’encre comme un seul mot. Par exemple, si le contexte contient « pour l’obtenir », le module de reconnaissance retourne « ensemble ».
Valeur retournée
Cette fonction peut retourner l’une de ces valeurs.
Valeur HRESULT
Description
S_OK
Réussite.
E_INVALIDARG
L’indicateur n’est pas 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_POINTER
Le contexte n’est pas valide ou l’un des paramètres est un pointeur non valide.
Remarques
Avant Microsoft Windows XP Tablet PC Edition Development Kit 1.7, le panneau d’entrée Tablet PC effectuait un espacement intelligent. À compter du Kit de développement logiciel (SDK) Tablet PC 1.7, le panneau d’entrée continue de produire des résultats avec des recommandations d’espacement préliminaires. Toutefois, les résultats de l’espacement du panneau d’entrée tablet PC peuvent être modifiés par les recommandations (résultats) du module de reconnaissance. Pour ce faire, le module de reconnaissance peut utiliser des informations contextuelles textuelles (basées sur l’appel SetTextContext effectué par le panneau d’entrée) et ses règles de modèle de langage interne.
Le panneau d’entrée est en mesure de déterminer si le module de reconnaissance est capable d’effectuer un espacement automatique en appelant cette fonction avec l’indicateur RECOFLAG_AUTOSPACE défini. Si le module de reconnaissance ne prend pas en charge l’espacement automatique, E_INVALIDARG est retourné.
Note Seul le mode ligne est pris en charge dans la fonction SetFlags . Le mode boxed, le mode libre et le mode monoligne ne sont pas pris en charge.
Configuration requise
Condition requise
Valeur
Client minimal pris en charge
Windows XP Édition Tablet PC [applications de bureau | Applications UWP]