IInkRecognizerContext::BackgroundRecognize-Methode (msinkaut.h)

Bewirkt, dass das IInkRecognizer-Objekt die zugeordnete Strichauflistung erkennt und nach Abschluss der Erkennung ein Recognition-Ereignis auslöst.

Syntax

HRESULT BackgroundRecognize(
  [in, optional] VARIANT CustomData
);

Parameter

[in, optional] CustomData

Gibt alle anwendungsdefinierten Daten an, die der Anwendung im Erkennungsereignis zur Verfügung stehen. Dieser Parameter kann ein VARIANT vom Typ VT_EMPTY oder VT_NULL sein, wenn keine Daten übergeben werden müssen. Der Standardwert ist NULL.

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

Rückgabewert

Diese Methode kann einen dieser Werte zurückgeben.

Rückgabecode	BESCHREIBUNG
S_OK	Erfolg.
E_OUTOFMEMORY	Speicher kann nicht zugeordnet werden, um den Vorgang abzuschließen.
E_INK_NO_STROKES_TO_RECOGNIZE	Es sind keine Striche vorhanden.
E_INK_EXCEPTION	Innerhalb der -Methode ist eine Ausnahme aufgetreten.

Hinweise

Diese Methode gibt an, dass die Freihanderkennung asynchron durchgeführt wird. Rufen Sie die Recognize-Methode auf, um Freihand synchron zu erkennen.

Diese Methode erkennt nur die beste Ergebniszeichenfolge. Alternativen werden nicht erstellt. Um eine Erkennung durchzuführen, die eine Liste der verfügbaren Alternativen erstellt, rufen Sie die BackgroundRecognizeWithAlternates-Methode auf.

Das Recognition-Ereignis wird nicht ausgelöst, wenn die Erkennung nichts erkennt.

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
Bibliothek	InkObj.dll

Weitere Informationen

BackgroundRecognizeWithAlternates-Methode

Data-Eigenschaft

IInkRecognitionAlternate-Schnittstelle

IInkRecognizerContext

InkRecognizerContext-Klasse