IInkRecognitionResult-Schnittstelle (msinkaut.h)

Stellt das Ergebnis der Erkennung dar. Die Ergebnisse der Erkennung handschriftlicher Freihandeingaben werden in einem IInkRecognitionResult-Objekt zurückgegeben.

Vererbung

Die IInkRecognitionResult-Schnittstelle erbt von der IUnknown-Schnittstelle . IInkRecognitionResult verfügt auch über folgende Membertypen:

Methoden

Die IInkRecognitionResult-Schnittstelle verfügt über diese Methoden.

IInkRecognitionResult::get_Strokes Ruft die Auflistung von Strichen ab, die in einem -Objekt enthalten sind oder zum Erstellen eines -Objekts verwendet werden. (IInkRecognitionResult.get_Strokes)
IInkRecognitionResult::get_TopAlternate Ruft die oberste Alternative des Erkennungsergebnisses ab. (IInkRecognitionResult.get_TopAlternate)
IInkRecognitionResult::get_TopConfidence Ruft die oberste Alternative des Erkennungsergebnisses ab. (IInkRecognitionResult.get_TopConfidence)
IInkRecognitionResult::get_TopString Ruft den Ergebnistext für die TopAlternate-Eigenschaft ab.
IInkRecognitionResult::ModifyTopAlternate Ändert die obere Alternative eines Erkennungsergebnisses mithilfe des angegebenen Alternativen.
IInkRecognitionResult::SetResultOnStrokes Weist die Erkennungsergebnisse den Strichen zu, die zum Erstellen der Ergebnisse verwendet wurden.

Hinweise

IInkRecognitionAlternate-Objekte oder Alternativen werden aus dem Ergebnis erstellt. Die beste oder oberste Alternative ist die, die standardmäßig im Ergebnis verwendet wird. Sie können jedoch die Methoden des IInkRecognitionResult-Objekts verwenden, um anzugeben, welche Alternativen im Ergebnis verwendet werden sollen.

Die Systemleistung kann beeinträchtigt werden, wenn erkennungsergebnisse automatisch jeder Strichsammlung zugewiesen werden. Daher werden Ergebnisse standardmäßig nicht an eine Auflistung von Strichen angefügt. Sie müssen die SetResultOnStrokes-Methode aufrufen, um einer Sammlung von Strichen Ergebnisse zuzuweisen.

Die einzige Möglichkeit zum Beibehalten von Erkennungsergebnissen besteht darin , SetResultOnStrokes aufzurufen und diese Auflistung von Strichen dann der CustomStrokes-Auflistung für das InkDisp-Objekt hinzuzufügen.

Nicht alle Erkennungen legen die TopConfidence-Eigenschaft fest. Wenn eine Anwendung versucht, auf eine Eigenschaft zuzugreifen, die nicht von der Erkennung festgelegt wird, wird eine Argument-Ausnahme ausgelöst.

Wenn Sie eine Klasse definieren, die diese Schnittstelle implementiert, interagiert die neue Klasse nicht ordnungsgemäß mit den Tablet PC-ApIs (Application Programming Interfaces).

Hinweis Die verschiedenen Handschrifterkennungen, die von Microsoft sowohl in lateinischen Als auch in ostasiatischen Sprachen ausgeliefert werden, können manchmal den Unicode-Wert 0xFFFF als Erkennungsergebnis erzeugen. Dies tritt auf, wenn die Erkennung nicht in der Lage ist, ein Freihandstück mit einem gültigen Zeichen zuzuordnen. Der 0xFFFF Codepunkts ist gültiger UCS-2, aber in UTF-8 nicht zulässig. Eine Anwendung, die Erkennungsergebnisse in UTF-8 konvertiert, sollte 0xFFFF durch einen anderen Codepunkt ersetzen, z. B. durch 0xFFFD.

 

Anforderungen

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

Weitere Informationen

CustomStrokes-Eigenschaft [InkDisp-Klasse]

IInkCustomStrokes-Schnittstelle

IInkRecognizer-Schnittstelle

InkDisp-Klasse

InkRecognizerContext-Klasse

InkStrokes-Auflistung