InkRecognizerContext-Klasse
Ermöglicht das Ausführen der Freihanderkennung, das Abrufen des Erkennungsergebnisses und das Abrufen von Alternativen. Der InkRecognizerContext ermöglicht es den verschiedenen Erkennungsmodulen, die auf einem System installiert sind, die Freihanderkennung zu verwenden, um Eingaben entsprechend zu verarbeiten.
InkRecognizerContext verfügt über folgende Membertypen:
Ereignisse
Die InkRecognizerContext-Klasse verfügt über diese Ereignisse.
| Ereignis | Beschreibung |
|---|---|
| Erkennung | Tritt auf, wenn inkRecognizerContext Ergebnisse aus der BackgroundRecognize-Methode generiert wurden. |
| RecognitionWithAlternates | Tritt auf, wenn inkRecognizerContext Nach dem Aufrufen der BackgroundRecognizeWithAlternates-Methode Ergebnisse generiert wurden |
Schnittstellen
Die InkRecognizerContext-Klasse definiert diese Schnittstellen.
| Schnittstelle | Beschreibung |
|---|---|
| IInkRecognizerContext | Dieses Objekt implementiert die IInkRecognizerContext-COM-Schnittstelle . |
Methoden
Die InkRecognizerContext-Klasse verfügt über diese Methoden.
| Methode | Beschreibung |
|---|---|
| Backgroundrecognize | Gibt an, dass die Erkennung die zugeordneten Striche erkennen und nach Abschluss der Erkennung ein Erkennungsereignis auslösen soll. |
| Backgroundrecognizewithalternates | Gibt an, dass die Erkennung die zugeordneten Striche erkennen und nach Abschluss der Erkennung ein RecognitionWithAlternates-Ereignis auslösen soll. |
| Klon | Erstellt ein doppeltes InkRecognizerContext-Objekt. |
| EndInkInput | Beendet die Freihandeingabe auf inkRecognizerContext. |
| Isstringsupported | Gibt an, ob das Systemwörterbuch, das Benutzerwörterbuch oder die Wortliste eine angegebene Zeichenfolge enthält. |
| Recognize | Führt die Erkennung für eine InkStrokes-Auflistung aus und gibt Erkennungsergebnisse zurück. |
| StopBackgroundRecognition | Beendet die Hintergrunderkennung, die mit einem Aufruf von BackgroundRecognize oder BackgroundRecognizeWithAlternates gestartet wurde. |
Eigenschaften
Die InkRecognizerContext-Klasse verfügt über diese Eigenschaften.
| Eigenschaft | Zugriffstyp | BESCHREIBUNG |
|---|---|---|
|
CharacterAutoCompletion |
Lesen/Schreiben |
Ruft den AutoVervollständigen-Modus für Zeichen ab, der bestimmt, wann Zeichen oder Wörter erkannt werden, oder legt diese fest. |
|
Factoid |
Lesen/Schreiben |
Ruft den Zeichenfolgennamen des Factoids ab, das vom InkRecognizerContext-Objekt verwendet wird, oder legt den Zeichenfolgennamen fest. |
|
Handbuch |
Lesen/Schreiben |
Ruft den InkRecognizerGuide ab, der für die Freihandeingabe verwendet werden soll, oder legt diesen fest. |
|
Prefixtext |
Lesen/Schreiben |
Ruft die Zeichen ab, die vor der InkStrokes-Auflistung im InkRecognizerContext-Objekt enthalten sind, oder legt diese fest. |
|
RecognitionFlags |
Lesen/Schreiben |
Ruft die Flags ab, die angeben, wie die Erkennung die Freihandeingabe interpretiert und die Ergebniszeichenfolge bestimmt, oder legt diese fest. |
|
Erkennung |
Lesen/Schreiben |
Ruft das IInkRecognizer-Objekt ab, das vom InkRecognizerContext-Objekt verwendet wird, oder legt es fest. |
|
Striche |
Lesen/Schreiben |
Ruft die Dem InkRecognizerContext-Objekt zugeordnete InkStrokes-Auflistung ab oder legt sie fest. |
|
SuffixText |
Lesen/Schreiben |
Ruft die Zeichen ab, die nach der InkStrokes-Auflistung im InkRecognizerContext-Objekt folgen, oder legt sie fest. |
|
Wordlist |
Lesen/Schreiben |
Ruft das InkWordList-Objekt ab, das zum Verbessern der Erkennungsergebnisse verwendet wird, oder legt es fest. |
Bemerkungen
Dieses Objekt kann instanziiert werden, indem die CoCreateInstance-Methode in C++ aufgerufen wird.
Es gibt zwei Arten der Erkennung: Hintergrund (asynchron) oder Vordergrund (synchron). Die Hintergrunderkennung wird durch einen Aufruf der BackgroundRecognize - oder BackgroundRecognizeWithAlternates-Methode gestartet, tritt in einem Hintergrundthread auf und meldet Ergebnisse über einen Ereignismechanismus an die Anwendung. Die Vordergrunderkennung wird erst zurückgegeben, wenn alle Erkennungen abgeschlossen sind, sodass erkennungsergebnisse für den aufrufenden Thread verfügbar gemacht werden, ohne auf das Erkennungsereignis zu lauschen.
Freihand wird kontinuierlich im Hintergrund verarbeitet. Wenn der InkStrokes-Auflistung, auf die sich inkRecognizerContext bezieht, ein IInkStrokeDisp hinzugefügt wird, wird IInkStrokeDisp sofort erkannt. Weitere Informationen finden Sie in den Hinweisen im Thema der EndInkInput-Methode .
Die gesamte Erkennung erfolgt über einen Erkennungskontext. Der Kontext definiert die Einstellungen für eine einzelne Erkennungssitzung. Sie empfängt die Freihandeingabe, die erkannt werden muss, und definiert die Einschränkungen für die Freihandeingabe und die Erkennungsausgabe. Zu den Einschränkungen, die für den Kontext festgelegt werden können, gehören die Sprache, das Wörterbuch und die Grammatik, die verwendet wird.
Hinweis
Das Festlegen anderer Eigenschaften als die Eigenschaften Strokes oder CharacterAutoCompletion ist nur erfolgreich, wenn die InkStrokes-AuflistungNULL ist. Sie müssen die anderen Eigenschaften festlegen, bevor Sie die InkStrokes-Auflistung an inkRecognizerContext anfügen, oder Sie müssen die InkStrokes-Auflistung auf NULL und dann die anderen Eigenschaften festlegen. Wenn Sie die InkStrokes-Auflistung auf NULL und dann die anderen Eigenschaften festlegen, müssen Sie die InkStrokes-Auflistung möglicherweise erneut anfügen. Dies liegt daran, dass die Erkennung direkt beginnt, nachdem Sie inkRecognizerContext die InkStrokes zugewiesen haben. Wenn ein Aufruf der Recognize-Methode [InkRecognizeContext Class] oder BackgroundRecognize erfolgt, sind aufrufbare Ergebnisse möglicherweise bereits verfügbar.
Um die Leistung Ihrer Anwendung zu verbessern, verwerfen Sie Ihr InkRecognizerContext-Objekt , wenn es nicht mehr benötigt wird.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows XP Tablet PC Edition [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) |
Nicht unterstützt |
| Header |
|
| Bibliothek |
|