InkRecognizerContext.Recognition-Ereignis

Tritt auf, wenn der InkRecognizerContext Ergebnisse der BackgroundRecognize-Methode generiert hat.

Syntax

void Recognition(
  [in] BSTR                 RecognizedString,
  [in] VARIANT              CustomData,
  [in] InkRecognitionStatus RecognitionStatus
);

Parameter

RecognizedString [in]

Der Text des Erkennungsergebnisses mit der höchsten Zuverlässigkeit.

Weitere Informationen zum BSTR-Datentyp finden Sie unter Verwenden der COM-Bibliothek.

CustomData [in]

Das Objekt, das die benutzerdefinierten Daten für das Erkennungsergebnis enthält.

Weitere Informationen zur VARIANT-Struktur finden Sie unter Verwenden der COM-Bibliothek.

RecognitionStatus [in]

Die Anerkennung status ab dem letzten Anerkennungsergebnis.

Rückgabewert

Dieses Ereignis gibt keinen Wert zurück.

Bemerkungen

Das Verhalten der Anwendungsprogrammierschnittstelle (Application Programming Interface, API) ist unvorhersehbar, wenn Sie versuchen, über den Erkennungsereignishandler Zugriff auf das ursprüngliche InkRecognizerContext-Objekt zu erhalten. Versuchen Sie nicht, dies zu tun. Erstellen Sie stattdessen bei Bedarf ein Flag, und legen Sie es im Erkennungsereignishandler fest. Anschließend können Sie dieses Flag abfragen, um zu bestimmen, wann die InkRecognizerContext-Eigenschaften außerhalb des Ereignishandlers geändert werden sollen.

Diese Ereignismethode wird in der _IInkEvents-Schnittstelle definiert. Die _IInkEvents-Schnittstelle implementiert die IDispatch-Schnittstelle mit dem Bezeichner DISPID_IRERecognition.

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

InkRecognizerContext-Klasse

BackgroundRecognize-Methode

InkRecognitionStatus-Enumeration

Erkennungsmethode

IInkRecognitionResult-Schnittstelle