InkRecognizerContext-Klasse

  • Artikel

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
Msinkaut.h (erfordert auch Msinkaut_i.c)
Bibliothek
InkObj.dll

Weitere Informationen

IInkRecognizer-Schnittstelle

InkStrokes-Auflistung