Freigeben über

SetFlags-Funktion (recapis.h)

Gibt an, wie die Freihanderkennung 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
);

Die Parameter

[in] hrc

Behandeln sie den Erkennungskontext.

[in] dwFlags

In der folgenden Tabelle sind die Flags aufgeführt, die Sie festlegen können, um anzugeben, wie die Freihanderkennung interpretiert und die Ergebniszeichenfolge bestimmt. Verwenden Sie den OR-Operator (|), um Kennzeichnungen nach Bedarf zu kombinieren.

Bitkennzeichnung Bedeutung
RECOFLAG_AUTOSPACE
 Erkennung verwendet intelligenten Abstand basierend auf Sprachmodellregeln.
RECOFLAG_COERCE
 Die Erkennung wandelt das Ergebnis basierend auf dem Für den Kontext angegebenen Factoid um. Wenn Sie beispielsweise ein Factoid für eine Telefonnummer 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 Kennzeichen 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 Kennzeichen schreibt der Benutzer beispielsweise "handw", und die Erkennung gibt Vorschläge (z. B. "Hander" oder "Hand") zurück, die Wörter sind, die im Erkennungswörterbücher vorhanden sind. Mit der Kennzeichnung kann die Erkennung "handw" als einen der Vorschläge zurückgeben, da es sich um ein gültiges Präfix des Worts "Handschrift" handelt, das im Erkennungswörterbücher vorhanden ist.

Der Tablet PC-Eingabebereich legt dieses Kennzeichen in den meisten Fällen fest, außer wenn der Eingabebereich IS_DEFAULT (oder kein Eingabebereich) oder wenn keine Benutzerwortliste oder kein regulärer Ausdruck vorhanden ist.

Erkennungen ostasiatischer Zeichen sollten E_INVALIDARG zurückgeben, wenn ein Aufrufer dieses Kennzeichens übergibt.
RECOFLAG_LINEMODE
 Die Erkennung teilt keine Zeilen, muss aber trotzdem Zeichen und Worttrennung ausführen. Dies ist identisch mit dem Linienmodus, mit der Ausnahme, dass es keine Führungslinie gibt, und es wird davon ausgegangen, dass sich alle Freihandeingaben in einer einzelnen Zeile befinden. Wenn dieses Kennzeichen festgelegt ist, wird eine Anleitung ignoriert, falls festgelegt.
RECOFLAG_SINGLESEG
 Deaktiviert mehrere Segmentierungen. Standardmäßig gibt die Erkennung mehrere Segmentierungen (Alternative) für die Freihandeingabe zurück.

Wenn Sie z. B. "zusammen" als separate Striche schreiben, kann die Erkennung die Freihandeingabe als "zum Sammeln" oder "zusammen" segmentieren. Legen Sie dieses Kennzeichen fest, wenn Sie beim Abfragen nach Alternativen keine mehrfachen Segmentierungen der Freihandeingabe benötigen. Dadurch wird die Leistung verbessert und die Speicherauslastung reduziert.
RECOFLAG_WORDMODE
 Die Erkennung behandelt die Freihandeingabe als einzelnes Wort. Wenn der Kontext beispielsweise "um sie abzurufen" enthält, gibt die Erkennung "zusammen" zurück.

Rückgabewert

Diese Funktion kann einen dieser Werte zurückgeben.

HRESULT-Wert Description
S_OK
 Erfolg.
E_INVALIDARG
 Die Kennzeichnung ist ungültig.
E_NOTIMPL
 Die Erkennung unterstützt diese Funktion nicht.
E_OUTOFMEMORY
 Speicher kann nicht zugeordnet werden, um den Vorgang abzuschließen.
E_FAIL
 Ein nicht angegebener Fehler ist aufgetreten.
E_POINTER
 Der Kontext ist ungültig, oder einer der Parameter ist ein ungültiger Zeiger.

Bemerkungen

Vor Microsoft Windows XP Tablet PC Edition Development Kit 1.7 hat der Tablet PC-Eingabebereich einen intelligenten Abstand ausgeführt. Ab Tablet PC SDK 1.7 erzeugt input Panel weiterhin Ergebnisse mit vorläufigen Abstandsempfehlungen. Die Ergebnisse des Tablet PC-Eingabebereichs können jedoch durch die Empfehlungen der Erkennung (Ergebnisse) geändert werden. Die Erkennung kann dies mithilfe von Textkontextinformationen (basierend auf dem SetTextContext-Aufruf von Input Panel) und den internen Sprachmodellregeln tun.

Der Eingabebereich kann bestimmen, ob die Erkennung den automatischen Abstand ausführen kann, indem sie diese Funktion mit dem RECOFLAG_AUTOSPACE Flagsatz aufruft. Wenn die Erkennung den automatischen Abstand nicht unterstützt, wird E_INVALIDARG zurückgegeben.

Anmerkung Nur der Zeilenmodus wird in der SetFlags-Funktion unterstützt. Boxed mode, free mode, and single-line mode are not supported.
 

Anforderungen

Anforderung Wert
Mindestens unterstützter Client Windows XP Tablet PC Edition [Desktop-Apps | UWP-Apps]
Mindestanforderungen für unterstützte Server Nicht unterstützt
Zielplattform Fenster
Header recapis.h
Library inkobjcore.lib
DLL inkobjcore.dll

Siehe auch

SetFactoid-Funktion

SetTextContext-Funktion

  • Last updated on