Fonction SetGuide (recapis.h)

Article
03/01/2024

Définit le guide de reconnaissance à utiliser pour les entrées en boîte ou en ligne. 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érez 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 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 ligne du contexte.

Valeur retourné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_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é, encadré, etc.) qui n’est pas pris en charge par le module de reconnaissance, ou les valeurs de champ RECO_GUIDE sont illégales (hauteurs ou largeurs négatives, 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à un peu d’encre dans le contexte de reco, ou, dans le cas des 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 .

Configuration requise

Condition requise	Valeur
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

Voir aussi

GetGuide, fonction

RECO_GUIDE Structure

Partager via