IInkRecognitionAlternate::GetStrokesFromStrokeRanges-Methode (msinkaut.h)

Ruft die kleinste InkStrokes-Auflistung ab, die eine bekannte InkStrokes-Eingabeauflistung enthält und für die das IInkRecognizer-Objekt Alternativen 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 der Erkennungsergebnis-Alternative zu finden, die diese Auflistung enthält.

[out, retval] GetStrokesFromStrokeRanges

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

Rückgabewert

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
Innerhalb der -Methode ist eine Ausnahme aufgetreten.
E_INK_MISMATCHED_INK_OBJECT
Der Strichparameter ist einem anderen Ink-Objekt zugeordnet.
E_FAIL
Es ist ein unbekannter Fehler aufgetreten.

Hinweise

Die zurückgegebene Auflistung kann mit der Eingabeauflistung übereinstimmen, oder sie kann größer sein, wenn die Eingabeauflistung nur mit einem Teil des kleinsten Erkennungsergebnisses übereinstimmt, das alle Eingabestriche enthält.

Diese Methode ist besonders nützlich für die Wortauswahl mit nur einem Klick. Um beispielsweise die Striche zurückzugeben, aus denen das Wort besteht, auf das Sie geklickt haben, können Sie auf einen Strich klicken, die HitTest-Methode des IInkStrokeDisp-Objekts aufrufen, um den geklickten Strich abzurufen, und dann GetStrokesFromStrokeRanges aufrufen.

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

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

GetStrokesFromTextRange-Methode

GetTextRangeFromStrokes-Methode

Alternative IInkRecognition-Schnittstelle

InkStrokes-Auflistung