Freigeben über


IInkRecognizerContext::BackgroundRecognize-Methode (msinkaut.h)

Bewirkt, dass das IInkRecognizer-Objekt die zugeordnete Strichauflistung erkennt und ein Erkennungsereignis auslöst, wenn die Erkennung abgeschlossen ist.

Syntax

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

Parameter

[in, optional] CustomData

Gibt alle anwendungsdefiniert Daten an, die für die Anwendung im Erkennungsereignis verfügbar sind. Dieser Parameter kann ein VARIANT-Wert 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.

Zurückgegebener Wert

Diese Methode kann einen dieser Werte zurückgeben.

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

Bemerkungen

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

Diese Methode erkennt nur die beste Ergebniszeichenfolge. Alternative werden nicht erstellt. Rufen Sie die BackgroundRecognizeWithAlternates-Methode auf, um eine Liste der verfügbaren Alternativen zu erstellen.

Das Erkennungsereignis wird nicht ausgelöst, wenn die Erkennung nichts erkennt.

Anforderungen

Anforderung Wert
Mindestens unterstützter Client Windows XP Tablet PC Edition [nur Desktop-Apps]
Mindestanforderungen für unterstützte Server Nicht unterstützt
Zielplattform Windows
Header msinkaut.h

Siehe auch

BackgroundRecognizeWithAlternates-Methode

Data-Eigenschaft

IInkRecognitionAlternate-Schnittstelle

IInkRecognizerContext

InkRecognizerContext-Klasse