RecognitionAlternate.GetStrokesFromTextRange-Methode

Artikel
11/26/2008

Gibt die Strokes-Auflistung zurück, die dem kleinsten Satz mit Erkennungssegmenten entspricht, der einen bestimmten Zeichenbereich innerhalb der Alternative enthält.

Namespace: Microsoft.Ink
Assembly: Microsoft.Ink (in Microsoft.Ink.dll)

Syntax

'Declaration
Public Function GetStrokesFromTextRange ( _
    ByRef selectionStart As Integer, _
    ByRef selectionLength As Integer _
) As Strokes
'Usage
Dim instance As RecognitionAlternate
Dim selectionStart As Integer
Dim selectionLength As Integer
Dim returnValue As Strokes

returnValue = instance.GetStrokesFromTextRange(selectionStart, _
    selectionLength)

public Strokes GetStrokesFromTextRange(
    ref int selectionStart,
    ref int selectionLength
)

public:
Strokes^ GetStrokesFromTextRange(
    int% selectionStart, 
    int% selectionLength
)

public Strokes GetStrokesFromTextRange(
    /** @ref */int selectionStart,
    /** @ref */int selectionLength
)

public function GetStrokesFromTextRange(
    selectionStart : int, 
    selectionLength : int
) : Strokes

Parameter

selectionStart
Typ: System.Int32%
Der Beginn des Zeichenbereichs innerhalb dieser Alternative.

selectionLength
Typ: System.Int32%
Die Länge des Zeichenbereichs innerhalb der Alternative. Dieser Parameter muss größer als 0 (null) sein. Er wird an die Länge des kleinsten Satzes eines oder mehrerer Segmente angepasst, der die Eingabeauswahl enthält.

Rückgabewert

Typ: Microsoft.Ink.Strokes
Gibt die Strokes-Auflistung zurück, die dem kleinsten Satz mit Erkennungssegmenten entspricht, der einen bestimmten Zeichenbereich innerhalb der Alternative enthält.

Hinweise

Das Zeichen an der selectionStart-Position ist im Bereich des erkannten Texts enthalten. Dieser Parameter wird an den Anfang des kleinsten erkannten Satzes mit einem oder mehreren Segmenten angepasst, der die Eingabeauswahl enthält. Der selectionStart-Parameter ist ein nullbasierter Index für die Zeichen im Text der Erkennungsalternative.

Angenommen, es gibt eine Strokes-Auflistung, die erkannt wurde und deren beste Alternative "how are you" lautet. Der an diese Methode übergebene Parameter ist ein Bereich in diesem (oder möglicherweise das gesamte) Zeichenfolgenergebnis. 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 einschließen. Wenn der selectionStart-Parameter 0 (null) und der selectionLength-Parameter 5 ist, sodass ein Bereich entsteht, der dem "how a" der Ergebniszeichenfolge entspricht, bestehen die zurückgegebenen Striche aus den erkannten Strichen, die die Segmente "how are" bilden. Dies ist der kleinste Satz von Segmenten, der den Eingabebereich einschließt.

In wortbasierten und in zeichenbasierten Erkennungsmodulen werden Leerzeichen als Zeichen betrachtet. Wenn die Eingabeauswahl einem Leerzeichen entspricht, gibt diese Methode eine leere Strokes-Auflistung zurück.

Beispiele

In diesem C#-Beispiel wird die Strokes-Auflistung mit dem Namen altStrokes gesucht, die dem kleinsten Satz von RecognitionAlternate-Objekten mit dem Textbereich zugeordnet ist.

[C#]

theTextBox.Text = theRecognitionResult.TopString;
//... Assume the user has selected a range within theTextBox.
int selStart = theTextBox.SelectionStart;
int selLength = theTextBox.SelectionLength;
Strokes altStrokes;
altStrokes = theRecognitionResult.TopAlternate.GetStrokesFromTextRange(
    ref selStart, ref selLength);

In diesem Microsoft® Visual Basic® .NET-Beispiel wird die Strokes-Auflistung mit dem Namen altStrokes gesucht, die dem kleinsten Satz von RecognitionAlternate-Objekten mit dem Textbereich zugeordnet ist.

[Visual Basic]

theTextBox.Text = theRecognitionResult.TopString
'... Assume the user has selected a range within theTextBox.
Dim selStart As Integer = theTextBox.SelectionStart
Dim selLength As Integer = theTextBox.SelectionLength
Dim altStrokes As Strokes
altStrokes = theRecognitionResult.TopAlternate.GetStrokesFromTextRange( _
    selStart, selLength)

Plattformen

Windows Vista

.NET Framework und .NET Compact Framework unterstützen nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.