RecognitionAlternate.GetStrokesFromTextRange 方法

项目
11/04/2008

返回一个 Strokes 集合，该集合对应于包含备选项 中的指定字符范围的识别段 的最小集。

命名空间： Microsoft.Ink
程序集： Microsoft.Ink（在 Microsoft.Ink.dll 中）

语法

声明
Public Function GetStrokesFromTextRange ( _
    ByRef selectionStart As Integer, _
    ByRef selectionLength As Integer _
) As Strokes
用法
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

参数

selectionStart
类型：System.Int32%
备选项中的字符范围的起始点。

selectionLength
类型：System.Int32%
备选项中的字符范围的长度。此参数必须大于 0。此参数将调整为包括输入选择的一个或多个段的最小集的长度。

返回值

类型：Microsoft.Ink.Strokes
返回一个 Strokes 集合，该集合对应于包含备选项中的指定字符范围的识别段的最小集。

备注

selectionStart 位置的字符包括在识别的文本范围中。此参数将调整为包括输入选择的一个或多个段的最小识别集的起始点。selectionStart 参数是从零开始的索引，它指向识别备选项的文本中的字符。

假定有一个已识别的 Strokes 集合，并且其最佳备选项是“how are you”。传递到此方法的参数是此字符串结果中的部分（也可能是全部）范围。此备选项包含五个段，每个单词一个，每个空格一个。返回的笔画对应于包括所有输入范围的段的最小集。如果 selectionStart 参数为 0，selectionLength 参数为 5，创建对应于结果字符串“how a”的范围，则返回的笔画是组成段“how are”的所有已识别笔画。这是包括输入范围的段的最小集。

在基于单词和基于字符的识别器中，将空格视为字符。如果输入选择对应于空格字符，则此方法返回空 Strokes 集合。

示例

此 C# 示例查找与包括文本范围的 RecognitionAlternate 对象的最小集关联的 Strokes 集合 altStrokes。

[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);

此 Microsoft(R) Visual Basic(R) .NET 示例查找与包括文本范围的 RecognitionAlternate 对象的最小集关联的 Strokes 集合 altStrokes。

[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)