SetGuide-Funktion (recapis.h)

Legt die Erkennungsanleitung fest, die für geschachtelte oder gefügete Eingaben verwendet werden soll. Sie müssen diese Funktion aufrufen, bevor Sie dem Kontext Striche hinzufügen.

Syntax

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

Parameter

hrc

Handle für den Erkennungskontext.

pGuide

Leitfaden zur Verwendung für Feld- oder Zeileneingaben. Das Festlegen dieses Parameters auf NULL bedeutet, dass der Kontext keine Anleitung enthält. Dies ist die Standardeinstellung und bedeutet, dass sich die Erkennung im freien Eingabemodus befindet. Weitere Informationen finden Sie in der RECO_GUIDE-Struktur .

iIndex

Indexwert, der für das erste Feld oder die erste Zeile im Kontext verwendet werden soll.

Rückgabewert

Diese Funktion kann einen dieser Werte zurückgeben.

Rückgabecode	BESCHREIBUNG
S_OK	Erfolg.
E_POINTER	Der Kontext ist ungültig, oder einer der Parameter ist ein ungültiger Zeiger.
E_OUTOFMEMORY	Speicher kann nicht zugeordnet werden, um den Vorgang abzuschließen.
E_INVALIDARG	Es wurde versucht, einen Erkennungsmodus festzulegen (frei, gekleidet, geschachtelt usw.), der von der Erkennung nicht unterstützt wird, oder die RECO_GUIDE Feldwerte sind unzulässig (z. B. negative Höhe oder Breite).
E_FAIL	Es ist ein unbekannter Fehler aufgetreten.
TPC_E_OUT_OF_ORDER_CALL	Es wurde versucht, eine Anleitung festzulegen, wenn bereits eine Freihandeingabe im Reco-Kontext vorhanden war, oder bei Erkennungen ostasiatischer Zeichen SetCACMode zuvor aufgerufen wurde.

Hinweise

Führungsfelder werden basierend auf dem iIntex-Wert nummeriert.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP Tablet PC Edition [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server)	Nicht unterstützt
Zielplattform	Windows
Kopfzeile	recapis.h
DLL	inkobjcore.dll

Weitere Informationen

GetGuide-Funktion

RECO_GUIDE-Struktur