IInkRecognitionAlternate::GetStrokesFromStrokeRanges-Methode (msinkaut.h)

Artikel
03/04/2024

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

Freigeben über