IInkRecognizerContext::BackgroundRecognizeWithAlternates-Methode (msinkaut.h)

Artikel
08/25/2023

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

Syntax

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

Parameter

[in, optional] CustomData

Optional. Gibt alle anwendungsdefinierte Daten an, die der Anwendung im RecognitionWithAlternates-Ereignis 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.

HRESULT-Wert	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.

Um eine Erkennung durchzuführen, die nur die beste Ergebniszeichenfolge ohne Alternativen enthält, rufen Sie die BackgroundRecognize-Methode auf .

Das RecognitionWithAlternates-Ereignis wird nicht ausgelöst, wenn die Erkennung keine Alternativen erkennt.

Anforderungen


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