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
);
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 |
---|---|
|
Erfolg. |
|
Der Kontext ist ungültig, oder einer der Parameter ist ein ungültiger Zeiger. |
|
Die Erkennung unterstützt diese Funktion nicht. |
|
Speicher kann nicht zugeordnet werden, um den Vorgang abzuschließen. |
|
Es ist ein unbekannter Fehler aufgetreten. |
|
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 |