IInkRecognitionResult::ModifyTopAlternate-Methode (msinkaut.h)

Ändert die obere Alternative eines Erkennungsergebnisses mithilfe des angegebenen Alternativen.

Syntax

HRESULT ModifyTopAlternate(
  [in] IInkRecognitionAlternate *Alternate
);

Parameter

[in] Alternate

Die IInkRecognitionAlternate , die verwendet werden soll, um die obere Alternative zu ändern.

Rückgabewert

Diese Methode kann einen dieser Werte zurückgeben.

Rückgabecode BESCHREIBUNG
S_OK
Erfolg.
TPC_E_NOT_RELEVANT
Das Gitter enthält keine Daten.
E_POINTER
Ein Parameter enthielt einen ungültigen Zeiger.
E_INVALIDARG
Die Alternative stimmt nicht mit dem bekannten Bereich überein, oder sie wurde nicht aus diesem Gitter abgerufen.
E_INK_EXCEPTION
Während der Verarbeitung ist eine Ausnahme aufgetreten.
E_OUTOFMEMORY
Speicher kann nicht zugeordnet werden, um den Vorgang abzuschließen.

Hinweise

Standardmäßig entspricht die beste Ergebniszeichenfolge des Erkennungsergebnisses der obersten Alternative. Sie können diese Methode jedoch verwenden, um anzugeben, dass andere Alternativen als die oberste Alternative im Ergebnis verwendet werden. Wenn Sie eine alternative Alternative als die oberste Alternative auswählen, wählen Sie im Wesentlichen einen anderen Pfad durch das Gitter der Alternativen, die den Ergebnissen zugeordnet sind.

Um die Alternativen abzurufen, die zum Ändern des Erkennungsergebnisses verwendet werden können, rufen Sie die AlternatesFromSelection-Methode auf.

Hinweis Ein Aufruf der ModifyTopAlternate-Methode kann die Eigenschaften TopString und TopAlternate ändern.
 
Die in der Funktion verwendete Alternative kann ein Wort sein, das sich in einem ganzen Satz abwechselt. Beispielsweise ändert ein Alternative, das mithilfe von AlternatesFromSelection (0, 5) für "Hallo Welt" abgerufen wurde, nur den Teil "Hello" des Worts, wobei der Teil "World" intakt bleibt.

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

GetAlternatesFromSelection-Methode

IInkRecognitionAlternate-Schnittstelle

IInkRecognitionResult-Schnittstelle

TopAlternate-Eigenschaft

TopString-Eigenschaft