SetTextContext-Funktion (recapis.h)

  • Artikel

Stellt die Textzeichenfolgen bereit, die vor und nach dem text im Erkennungskontext enthalten sind.

Sie rufen diese Funktion auf, bevor Sie die Freihandeingabe zum ersten Mal verarbeiten. Rufen Sie daher die SetTextContext-Funktion auf, bevor Sie die Process-Funktion aufrufen.

Syntax

HRESULT SetTextContext(
  HRECOCONTEXT hrc,
  ULONG        cwcBefore,
  const WCHAR  *pwcBefore,
  ULONG        cwcAfter,
  const WCHAR  *pwcAfter
);

Parameter

hrc

Handle für den Erkennungskontext.

cwcBefore

Anzahl der Zeichen in pwcBefore.

pwcBefore

Textzeichenfolge, die vor dem text im Erkennungskontext enthalten ist. Die Zeichenfolge ist nicht NULL beendet.

cwcAfter

Anzahl der Zeichen in pwcAfter.

pwcAfter

Textzeichenfolge, die nach dem im Erkennungskontext enthaltenen Text kommt. Die Zeichenfolge ist nicht NULL -terminated.

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_NOTIMPL
 Die Erkennung unterstützt diese Funktion nicht.
E_OUTOFMEMORY
 Speicher kann nicht zugeordnet werden, um den Vorgang abzuschließen.
E_FAIL
 Es ist ein unbekannter Fehler aufgetreten.
E_INVALIDARG
 Es wurde ein ungültiges Argument angegeben.

Hinweise

Die SetTextContext-Funktion stellt Kontext für einen Ausdruck oder ein Wort bereit, wodurch die Genauigkeit Der Erkennung erhöht wird. Wenn z. B. die pwcBeforepwcBefore-Zeichenfolge "unter " und die pwcAfter-Zeichenfolge "im Haus" ist, können Sie die Erkennung mit einem Wort oder Wörtern zwischen den Zeichenfolgen voreinstellen. Ihre Erkennung sollte bei der Erkennung das Leerzeichen nach "das" und vor "in" berücksichtigen.

Wenn die pwcAfter-Zeichenfolge jedoch "Hel" und die pwcBefore-Zeichenfolge "o" ist, deutet der fehlende Abstand zwischen den Zeichenfolgen darauf hin, dass die Erkennung einen oder mehrere Buchstaben in einem Wort erkennen sollte, das mit "Hel" beginnt und mit "o" endet.

Es wird empfohlen, die Länge des Textkontexts für den linken und rechten Kontext auf maximal 1024 Zeichen zu beschränken.

Anforderungen

   
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