IInkRecognitionAlternate::GetStrokesFromStrokeRanges-Methode (msinkaut.h)

Ruft die kleinste InkStrokes -Auflistung ab, die eine bekannte Eingabe InkStrokes -Auflistung enthält und für die das IInkRecognizer -Objekt Alternative bereitstellen kann.

Syntax

HRESULT GetStrokesFromStrokeRanges(
  [in]          IInkStrokes *Strokes,
  [out, retval] IInkStrokes **GetStrokesFromStrokeRanges
);

Parameter

[in] Strokes

Die Auflistung von Strichobjekten, die verwendet werden sollen, um die kleinste Strichauflistung des Erkennungsergebnisses zu finden, die diese Auflistung enthält.

[out, retval] GetStrokesFromStrokeRanges

Wenn diese Methode zurückgegeben wird, enthält sie einen Zeiger auf die kleinste Auflistung von Strichen, die eine bekannte Eingabeauflistung von Strichen enthalten und für die die Erkennung Alternative bereitstellen kann.

Zurückgegebener Wert

Diese Methode kann einen dieser Werte zurückgeben.

Rückgabecode Beschreibung
S_OK
Erfolg.
E_POINTER
Ein Parameter enthielt einen ungültigen Zeiger.
E_INK_EXCEPTION
In der Methode ist eine Ausnahme aufgetreten.
E_INK_MISMATCHED_INK_OBJECT
Der Strichparameter ist einem anderen Freihandobjekt zugeordnet.
E_FAIL
Ein nicht angegebener Fehler ist aufgetreten.

Bemerkungen

Die zurückgegebene Auflistung stimmt möglicherweise mit der Eingabeauflistung überein, oder sie ist größer, wenn die Eingabeauflistung nur einem Teil des kleinsten Erkennungsergebnisses entspricht, das alle Eingabestriche enthält.

Diese Methode ist am nützlichsten für die Auswahl von Wörtern mit nur einem Klick. Wenn Sie z. B. die Striche zurückgeben möchten, aus denen sie geklickt haben, können Sie auf einen Strich klicken, die HitTest-Methode des IInkStrokeDisp - Objekts aufrufen, um den angeklickten Strich abzurufen und dann GetStrokesFromStrokeRanges aufzurufen.

Die Strichbereiche sind gültig, bis das InkDisp-Objekt geändert wird.

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

GetStrokesFromTextRange-Methode

GetTextRangeFromStrokes-Methode

Alternative IInkRecognition-Schnittstelle

InkStrokes-Auflistung