SetTextContext-Funktion (recapis.h)

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
);

Die Parameter

hrc

Behandeln sie 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 text im Erkennungskontext enthalten ist. Die Zeichenfolge ist nicht NULL -terminated.

Rückgabewert

Diese Funktion kann einen dieser Werte zurückgeben.

Bemerkungen

Die SetTextContext-Funktion stellt Kontext für einen Ausdruck oder ein Wort bereit, wodurch die Genauigkeit der Erkennung erhöht wird. Wenn beispielsweise die pwcBeforepwcBefore-Zeichenfolge "unter dem " und die pwcAfter-Zeichenfolge "im Haus" lautet, können Sie die Erkennung mithilfe eines Worts oder Wörters zwischen den Zeichenfolgen voreingenommen haben. Ihre Erkennung sollte den Raum nach "the" und vor "in" beim Ausführen der Erkennung berücksichtigen.

Wenn die pwcAfter-Zeichenfolge jedoch "Hel" lautet und die pwcBefore-Zeichenfolge "o" lautet, gibt der Fehlende Abstand zwischen den Zeichenfolgen an, 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 auf maximal 1024 Zeichen für den linken und rechten Kontext zu beschränken.

Anforderungen