Partager via


SetGuide, fonction (recapis.h)

Définit le guide de reconnaissance à utiliser pour l’entrée boxed ou lined. Vous devez appeler cette fonction avant d’ajouter des traits au contexte.

Syntaxe

HRESULT SetGuide(
  HRECOCONTEXT     hrc,
  const RECO_GUIDE *pGuide,
  ULONG            iIndex
);

Paramètres

hrc

Gérer le contexte du module de reconnaissance.

pGuide

Guide à utiliser pour l’entrée de zone ou de ligne. La définition de ce paramètre sur NULL signifie que le contexte n’a pas de repère. Il s’agit de la valeur par défaut et signifie que le module de reconnaissance est en mode d’entrée libre. Pour plus d’informations sur le guide, consultez la structure RECO_GUIDE .

iIndex

Valeur d’index à utiliser pour la première zone ou la première ligne dans le contexte.

Valeur retournée

Cette fonction peut retourner l’une de ces valeurs.

Code de retour Descriptif
S_OK
Opération réussie.
E_POINTER
Le contexte n’est pas valide ou l’un des paramètres est un pointeur non valide.
E_OUTOFMEMORY
Impossible d’allouer de la mémoire pour terminer l’opération.
E_INVALIDARG
Tentative de définition d’un mode de reconnaissance (libre, aligné, boxé, etc.) qui n’est pas pris en charge par le module de reconnaissance, ou les valeurs de champ RECO_GUIDE sont illégales (hauteurs négatives ou largeurs, par exemple).
E_FAIL
Une erreur non spécifiée s’est produite.
TPC_E_OUT_OF_ORDER_CALL
Tentative de définition du repère lorsqu’il y avait déjà des entrées manuscrites dans le contexte de reco ou, dans le cas de reconnaissances de caractères d’Asie de l’Est, SetCACMode a été appelé précédemment.

Remarques

Les zones de repère sont numérotées en fonction de la valeur iIntex .

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

GetGuide, fonction

RECO_GUIDE Structure