IInkRecognitionAlternate::GetStrokesFromTextRange-Methode (msinkaut.h)
Ruft die Auflistung ab, die dem kleinsten Satz von Erkennungssegmenten entspricht, der einen angegebenen Zeichenbereich innerhalb des Alternativen enthält.
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. Das Zeichen an der Position selectionStart ist im Bereich des erkannten Texts enthalten. Dieser Parameter wird an den Anfang der kleinsten erkannten Gruppe von Segmenten angepasst, die die Eingabeauswahl enthält. Der selectionStart-Parameter ist ein nullbasierter Index in die Zeichen im Text der Erkennungs-Alternative.
[in, out] selectionLength
Die Länge des Zeichenbereichs innerhalb des Alternativen. Dieser Parameter muss größer als 0 sein. Dieser Parameter wird an die Länge der kleinsten Gruppe von Segmenten angepasst, die die Eingabeauswahl enthält.
[out, retval] GetStrokesFromTextRange
Enthält bei der Rückgabe einen Zeiger auf die Auflistung von Strichen, die dem bekannten Bereich des erkannten Texts entspricht.
Rückgabewert
Diese Methode kann einen dieser Werte zurückgeben.
| Rückgabecode | BESCHREIBUNG |
|---|---|
|
Erfolg. |
|
Ein Parameter enthielt einen ungültigen Zeiger. |
|
Innerhalb der -Methode ist eine Ausnahme aufgetreten. |
|
Es ist ein unbekannter Fehler aufgetreten. |
|
Strichhandlerhilfsobjekt kann nicht zugeordnet werden. |
Hinweise
Um GetStrokesFromTextRange weiter zu verdeutlichen, betrachten Sie eine Sammlung von Strichen, die erkannt wurden und für die die beste Alternative für diese Striche "Wie sind Sie" ist. Der an die -Methode übergebene Parameter ist ein Bereich innerhalb dieses Zeichenfolgenergebnisses (oder möglicherweise alle). Diese Alternative enthält fünf Segmente, eines für jedes Wort und eines 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 selectionLength-Parameter 5 ist und ein Bereich erstellt wird, der dem "how a" der Ergebniszeichenfolge entspricht, sind die zurückgegebenen Striche alle erkannten Striche, aus denen die Segmente "wie sind" bestehen. Dies ist die kleinste Gruppe von Segmenten, die den Eingabebereich enthält.
Sowohl in wort- als auch zeichenbasierten Erkennungen werden Leerzeichen als Zeichen gezählt. Wenn die Eingabeauswahl einem Leerzeichen entspricht, gibt diese Methode die leere InkStrokes-Auflistung zurück.
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
GetStrokesFromStrokeRanges-Methode
GetTextRangeFromStrokes-Methode