HRECOCONTEXT Handle

  • Artikel

Ein HRECOCONTEXT-Handle wird verwendet, um dem Kontext Freihandeingaben hinzuzufügen, freihanderkennung (synchron oder asynchron) durchzuführen, das Erkennungsergebnis abzurufen und Alternativen abzurufen.

Der Hauptgrund für die Verwendung von Erkennungskontexthandles ist die Unterscheidung zwischen Freihandeingaben. Sie können z. B. eine Anwendung mit zwei Fenstern erstellen, wobei der Benutzer in beiden Fenstern Freihandeingaben ausführen kann. Sie möchten die Freihandeingabe des ersten Fensters nicht mit der Freihandeingabe des zweiten Fensters vermischten lassen, wenn Sie die Erkennung bitten, die Freihand eines der Fenster zu erkennen. In dieser Art von Anwendung erstellen Sie zwei Erkennungskontexte (einen für jedes Fenster) und fügen Striche in Fenster 1 in Den Erkennungskontext 1 und Striche aus Fenster 2 in Den Erkennungskontext 2 hinzu. Um Erkennungsergebnisse zurückzugeben, rufen Sie den Prozess für den Erkennungskontext 1 oder den Erkennungskontext 2 auf, je nachdem, ob Sie die Ergebnisse für Fenster 1 oder 2 möchten.

Das Erkennungskontexthandle kann beliebig sein. In der Regel handelt es sich jedoch um einen Index in einem globalen Array von Strukturen. Die Strukturen können alle eingegebenen Striche und alle Variablen enthalten, die die Erkennung für diese bestimmte Freihandeingabe verwendet (z. B. Ihre interne Gitterstruktur oder den aktuellen Status der Erkennung). Eine Struktur kann alle Informationen enthalten, die die Erkennung für ein bestimmtes Freihandstück benötigt und verwendet.

Um ein HRECOCONTEXT-Handle abzurufen, rufen Sie die CreateContext-Funktion auf.

typedef HANDLE HRECOCONTEXT;

Bemerkungen

Nachfolgend sind die HRECOCONTEXT-Funktionen aufgeführt.

Funktion BESCHREIBUNG
Addstroke Fügt dem Erkennungskontext einen Freihandstrich hinzu.
AdviseInkChange Verhindert, dass die Erkennung Freihandeingaben verarbeitet, da ein neuer Strich hinzugefügt oder gelöscht wird.
CloneContext Erstellt einen Erkennungskontext, der die gleichen Einstellungen wie das Original enthält. Der neue Erkennungskontext enthält nicht die Freihand- oder Erkennungsergebnisse des Originals.
EndInkInput Gibt an, dass dem Kontext keine Freihandeingabe mehr hinzugefügt wird.
GetAlternateList Gibt eine Liste von Alternativen für die beste Ergebniszeichenfolge zurück.
GetBestAlternate Gibt einen HRECOALT Handle-Zeiger für die beste Alternative zum Ergebnis zurück.
GetBestResultString Gibt die beste Ergebniszeichenfolge zurück.
GetContextPropertyList Gibt eine Liste von Eigenschaften zurück, die von der Erkennung unterstützt werden.
GetContextPropertyValue Gibt einen angegebenen Eigenschaftswert aus dem Erkennungskontext zurück.
GetEnabledUnicodeRanges Gibt eine Liste der Unicode-Punktbereiche zurück, die für den Kontext aktiviert sind.
GetGuide Gibt die Führungslinie zurück, die für geschachtelte oder gefügete Eingaben verwendet wird.
GetLatticePtr Gibt einen Zeiger auf das Gitter für die aktuellen Ergebnisse zurück.
Isstringsupported Gibt einen Wert zurück, der angibt, ob ein Wort, ein Datum, eine Uhrzeit, eine Zahl oder ein anderer Text, der übergeben wird, im Wörterbuch enthalten ist.
Prozess Führt die Freihanderkennung synchron aus.
ResetContext Löscht die aktuelle Freihand- und Erkennungsergebnisse aus dem Kontext.
SetCACMode Gibt den AutoVervollständigen-Modus für Zeichen für die Zeichen- oder Worterkennung an.
SetContextPropertyValue Fügt dem Erkennungskontext eine -Eigenschaft hinzu. Wenn eine Eigenschaft bereits vorhanden ist, wird deren Wert geändert.
SetEnabledUnicodeRanges Aktiviert einen oder mehrere Unicode-Punktbereiche im Kontext.
SetFactoid Legt das Factoid fest, das eine Erkennung verwendet, um die Suche nach dem Ergebnis einzuschränken.
SetFlags Legt fest, wie die Erkennung die Freihandeingabe interpretiert und die Ergebniszeichenfolge bestimmt.
SetGuide Legt die Anleitung fest, die für geschachtelte oder gefügete Eingaben verwendet werden soll.
SetTextContext Stellt die Textzeichenfolgen bereit, die vor und nach dem text im Erkennungskontext enthalten sind. Für Erkennungen ostasiatischer Zeichen stellt die SetTextContext-Funktion Zeichen anstelle von Textzeichenfolgen bereit.
SetWordList Legt die Wortliste fest, die vom aktuellen Erkennungskontext erkannt werden soll.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client)
 Windows XP Tablet PC Edition [nur Desktop-Apps]
Unterstützte Mindestversion (Server)
 Nicht unterstützt
Header
Recapis.h