Partager via

SetFlags, fonction (recapis.h)

Spécifie comment le module de reconnaissance interprète l’entrée manuscrite 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 .

Syntaxe

HRESULT SetFlags(
  [in] HRECOCONTEXT hrc,
  [in] DWORD        dwFlags
);

Paramètres

[in] hrc

Gérer le contexte du module de reconnaissance.

[in] dwFlags

Le tableau suivant répertorie les indicateurs que vous pouvez définir pour spécifier la façon dont le module de reconnaissance interprète l’encre et détermine la chaîne de résultat. Utilisez l’opérateur OR (|) pour combiner des indicateurs selon les besoins.

Indicateur de bits Meaning
RECOFLAG_AUTOSPACE
 Recognizer utilise l’espacement intelligent en fonction 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 », le module de reconnaissance peut retourner 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 retourne des suggestions (telles que « hander » ou « hander ») qui sont des mots qui existent dans le lexique du module 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 du module 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 aucune étendue d’entrée) ou lorsqu’il n’existe aucune liste de mots utilisateur ou expression régulière.

Les modules de reconnaissance des caractères d’Asie de l’Est doivent retourner E_INVALIDARG lorsqu’un appelant passe dans cet indicateur.
RECOFLAG_LINEMODE
 Le module de reconnaissance ne fractionne pas les lignes, mais doit toujours faire la séparation des caractères et des mots. C’est le même que le mode aligné, sauf qu’il n’y a pas de repère, et toutes les entrées manuscrites sont supposées ê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 » comme traits distincts, le module de reconnaissance peut segmenter l’encre comme « pour l’obtenir », « 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 mot unique. 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 Descriptif
S_OK
 Opération réussie.
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 le Kit de développement Microsoft Windows XP Tablet PC Edition 1.7, le panneau d’entrée tablet PC a effectué un espacement intelligent. À compter du SDK Tablet PC 1.7, le panneau d’entrée continue de produire des résultats avec des recommandations préliminaires d’espacement. Les résultats de l’espacement du panneau d’entrée tablette PC peuvent toutefois être modifiés par les recommandations du module de reconnaissance (résultats). Le module de reconnaissance est en mesure de le faire à l’aide d’informations contextuelles textuelles (basées sur l’appel SetTextContext effectué par le panneau d’entrée) et de 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 l’espacement automatique en appelant cette fonction avec le jeu d’indicateurs RECOFLAG_AUTOSPACE. 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.
 

Spécifications

Requirement Valeur
Client minimum requis Windows XP Tablet PC Edition [applications de bureau | Applications UWP]
Serveur minimal pris en charge Aucun pris en charge
plateforme cible Fenêtres
Header recapis.h
Library inkobjcore.lib
DLL inkobjcore.dll

Voir aussi

SetFactoid, fonction

SetTextContext, fonction

  • Last updated on