HRECOCONTEXT Handle
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 |
|