Gibt an, wie die Erkennung die Freihandeingabe interpretiert und die Ergebniszeichenfolge bestimmt.
Rufen Sie diese Funktion auf, bevor Sie die Freihandeingabe zum ersten Mal verarbeiten. Rufen Sie daher die SetFlags-Funktion auf, bevor Sie die Process-Funktion aufrufen.
In der folgenden Tabelle sind die Flags aufgeführt, die Sie festlegen können, um anzugeben, wie die Erkennung die Freihandeingabe interpretiert und die Ergebniszeichenfolge bestimmt. Verwenden Sie den OR-Operator (|), um Flags nach Bedarf zu kombinieren.
Bitflag
Bedeutung
RECOFLAG_AUTOSPACE
Die Erkennung verwendet intelligente Abstände basierend auf Sprachmodellregeln.
RECOFLAG_COERCE
Die Erkennung führt das Ergebnis basierend auf dem Factoid aus, das Sie für den Kontext angeben. Wenn Sie beispielsweise ein Telefonnummern-Factoid angeben und der Benutzer das Wort "hello" eingibt, gibt die Erkennung möglicherweise eine zufällige Telefonnummer oder eine leere Zeichenfolge zurück. Wenn Sie dieses Flag nicht angeben, gibt die Erkennung "hello" als Ergebnis zurück.
RECOFLAG_PREFIXOK
Die Erkennung unterstützt die Erkennung eines beliebigen Präfixteils der Zeichenfolgen, die im Standard- oder angegebenen (Factoid)-Sprachmodell definiert sind.
Ohne dieses Flag schreibt der Benutzer beispielsweise "handw", und die Erkennung gibt Vorschläge (z. B. "Hander" oder "Hand") zurück, bei denen es sich um Wörter handelt, die im Erkennungs-Lexikon vorhanden sind. Mit dem Flag gibt die Erkennung möglicherweise "handw" als einen der Vorschläge zurück, da es sich um ein gültiges Präfix des Worts "Handschrift" handelt, das im Erkennungs-Lexikon vorhanden ist.
Der Tablet PC-Eingabebereich legt dieses Flag in den meisten Fällen fest, außer wenn der Eingabebereich IS_DEFAULT (oder kein Eingabebereich) ist oder wenn keine Benutzerwortliste oder kein regulärer Ausdruck vorhanden ist.
Erkennungen ostasiatischer Zeichen sollten E_INVALIDARG zurückgeben, wenn ein Aufrufer dieses Flag übergibt.
RECOFLAG_LINEMODE
Die Erkennung teilt keine Zeilen, muss aber dennoch Zeichen- und Worttrennung durchführen. Dies ist identisch mit dem lined-Modus, mit der Ausnahme, dass es keine Anleitung gibt, und es wird davon ausgegangen, dass sich alle Freihandeingaben in einer einzigen Zeile befinden. Wenn dieses Flag festgelegt ist, wird eine Anleitung ignoriert, sofern festgelegt.
RECOFLAG_SINGLESEG
Deaktiviert die mehrfache Segmentierung. Standardmäßig gibt die Erkennung mehrere Segmentierungen (Alternative) für die Freihand zurück.
Wenn Sie beispielsweise "zusammen" als separate Striche schreiben, kann die Erkennung die Freihand als "to get her", "to gather" oder "together" segmentieren. Legen Sie dieses Flag fest, wenn Sie beim Abfragen nach Alternativen nicht mehrere Segmentierungen der Freihandeingabe benötigen. Dies verbessert die Leistung und reduziert die Arbeitsspeicherauslastung.
RECOFLAG_WORDMODE
Die Erkennung behandelt die Freihand als einzelnes Wort. Wenn der Kontext beispielsweise "to get her" enthält, gibt die Erkennung "zusammen" zurück.
Rückgabewert
Diese Funktion kann einen dieser Werte zurückgeben.
HRESULT-Wert
BESCHREIBUNG
S_OK
Erfolg.
E_INVALIDARG
Das Flag ist ungültig.
E_NOTIMPL
Die Erkennung unterstützt diese Funktion nicht.
E_OUTOFMEMORY
Speicher kann nicht zugewiesen werden, um den Vorgang abzuschließen.
E_FAIL
Es ist ein unbekannter Fehler aufgetreten.
E_POINTER
Der Kontext ist ungültig, oder einer der Parameter ist ein ungültiger Zeiger.
Hinweise
Vor dem Microsoft Windows XP Tablet PC Edition Development Kit 1.7 hat der Tablet-PC-Eingabebereich intelligente Abstände ausgeführt. Ab Tablet PC SDK 1.7 erzeugt der Eingabebereich weiterhin Ergebnisse mit vorläufigen Abstandsempfehlungen. Die Ergebnisse des Tablet-PC-Eingabebereichs können jedoch durch die Empfehlungen (Ergebnisse) der Erkennung geändert werden. Die Erkennung kann dazu kontextbezogene Textinformationen (basierend auf dem SetTextContext-Aufruf des Eingabebereichs) und seinen internen Sprachmodellregeln verwenden.
Der Eingabebereich kann bestimmen, ob die Erkennung in der Lage ist, automatische Abstände auszuführen, indem diese Funktion mit dem RECOFLAG_AUTOSPACE-Flags aufgerufen wird. Wenn die Erkennung den automatischen Abstand nicht unterstützt, wird E_INVALIDARG zurückgegeben.
Hinweis Nur der Zeilenmodus wird in der SetFlags-Funktion unterstützt. Boxed Mode, Free Mode und Single-Line-Modus werden nicht unterstützt.
Anforderungen
Anforderung
Wert
Unterstützte Mindestversion (Client)
Windows XP Tablet PC Edition [Desktop-Apps | UWP-Apps]