IInkRecognitionAlternate::GetStrokesFromTextRange-Methode (msinkaut.h)

Ruft die Auflistung ab, die dem kleinsten Satz von Erkennungssegmenten entspricht, die einen angegebenen Zeichenbereich innerhalb der Alternativen enthalten.

Syntax

HRESULT GetStrokesFromTextRange(
  [in, out]     long        *selectionStart,
  [in, out]     long        *selectionLength,
  [out, retval] IInkStrokes **GetStrokesFromTextRange
);

Parameter

[in, out] selectionStart

Der Anfang des Zeichenbereichs innerhalb dieses alternativen Bereichs. Das Zeichen an der Position selectionStart ist im Bereich des erkannten Texts enthalten. Dieser Parameter wird an den Anfang der kleinsten erkannten Gruppe eines oder mehrerer Segmente angepasst, die die Eingabeauswahl enthalten. Der SelectionStart-Parameter ist ein nullbasierter Index in den Zeichen im Text der Erkennungsvarianten.

[in, out] selectionLength

Die Länge des Zeichenbereichs innerhalb der Alternativen. Dieser Parameter muss größer als 0 sein. Dieser Parameter wird an die Länge des kleinsten Satzes eines oder mehrerer Segmente angepasst, die die Eingabeauswahl enthalten.

[out, retval] GetStrokesFromTextRange

Wenn sie zurückgegeben wird, enthält einen Zeiger auf die Auflistung von Strichen, die dem bekannten Bereich des erkannten Texts entsprechen.

Zurückgegebener Wert

Diese Methode kann einen dieser Werte zurückgeben.

Bemerkungen

Um GetStrokesFromTextRange weiter zu verdeutlichen, ziehen Sie eine Sammlung von Strichen in Betracht, die erkannt wurden und für die die beste Alternative für diese Striche "wie sie sind" ist. Der an die Methode übergebene Parameter ist ein Bereich innerhalb (oder möglicherweise alle) dieses Zeichenfolgenergebnis. Diese Alternative enthält fünf Segmente, eine für jedes Wort und eins für jedes Leerzeichen. Die zurückgegebenen Striche entsprechen dem kleinsten Satz von Segmenten, die den gesamten Eingabebereich enthalten. Wenn der SelectionStart-Parameter 0 ist und der Parameter selectionLength 5 ist, wird ein Bereich erstellt, der der Ergebniszeichenfolge "how a" entspricht, dann sind die zurückgegebenen Striche alle erkannten Striche, aus denen die Segmente "how are" bestehen. Dies ist die kleinste Gruppe von Segmenten, die den Eingabebereich enthalten.

In Wort- und Zeichenbasierten Erkennungen werden Leerzeichen als Zeichen gezählt. Wenn die Eingabeauswahl einem Leerzeichen entspricht, gibt diese Methode die InkStrokes-Auflistung zurück und leer.

Anforderungen

Siehe auch

GetStrokesFromStrokeRanges-Methode

GetTextRangeFromStrokes-Methode

Alternative IInkRecognition-Schnittstelle

InkStrokes-Auflistung