SetFlags-Funktion (recapis.h)

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.

Syntax

HRESULT SetFlags(
  [in] HRECOCONTEXT hrc,
  [in] DWORD        dwFlags
);

Parameter

[in] hrc

Handle mit dem Erkennungskontext.

[in] dwFlags

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]
Unterstützte Mindestversion (Server)	Nicht unterstützt
Zielplattform	Windows
Kopfzeile	recapis.h
DLL	inkobjcore.dll

Weitere Informationen

SetFactoid-Funktion

SetTextContext-Funktion