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