RecognitionResult.GetAlternatesFromSelection 方法 (Int32, Int32, Int32)

项目
10/28/2008

从 RecognitionResult 对象的最佳结果字符串中的一个范围返回 RecognitionAlternates 集合，从而集合中的每个 RecognitionAlternate 对象只对应一个墨迹段。返回的集合被限制为指定的大小。

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

语法

声明
Public Function GetAlternatesFromSelection ( _
    selectionStart As Integer, _
    selectionLength As Integer, _
    maximumAlternates As Integer _
) As RecognitionAlternates
用法
Dim instance As RecognitionResult
Dim selectionStart As Integer
Dim selectionLength As Integer
Dim maximumAlternates As Integer
Dim returnValue As RecognitionAlternates

returnValue = instance.GetAlternatesFromSelection(selectionStart, _
    selectionLength, maximumAlternates)

public RecognitionAlternates GetAlternatesFromSelection(
    int selectionStart,
    int selectionLength,
    int maximumAlternates
)

public:
RecognitionAlternates^ GetAlternatesFromSelection(
    int selectionStart, 
    int selectionLength, 
    int maximumAlternates
)

public RecognitionAlternates GetAlternatesFromSelection(
    int selectionStart,
    int selectionLength,
    int maximumAlternates
)

public function GetAlternatesFromSelection(
    selectionStart : int, 
    selectionLength : int, 
    maximumAlternates : int
) : RecognitionAlternates

参数

selectionStart
类型：System.Int32
从中返回 RecognitionAlternates 集合的选定文本的起始点。默认值为 0（零）。

selectionLength
类型：System.Int32
从中返回 RecognitionAlternates 集合的选定文本的长度。默认值为 -1，该值指定文本从选定部分的起始处开始，直到字符串末尾。

maximumAlternates
类型：System.Int32
最多返回的备选项数目。默认值为 10。因为难度或时长问题无法计算备选项数目的识别器会返回任意数目的备选项。

返回值

类型：Microsoft.Ink.RecognitionAlternates
从 RecognitionResult 对象的最佳结果字符串中的选定部分返回 RecognitionAlternates 集合，从而集合中的每个 RecognitionAlternate 对象只对应一个墨迹段。

备注

对于大文本范围和某些语言，备选项的数目呈指数式增长。应用程序应指定备选项的数目，而不要查询识别器最多能返回的备选项数目。

识别器可能根据空白将“how are you”划分为三段，每个单词为一段。调用 GetAlternatesFromSelection 方法只返回此选定部分的一个段的备选项。

请注意 GetAlternatesFromSelection 方法与 RecognitionAlternate 对象的 AlternatesWithConstantPropertyValues 方法、LineAlternates 方法和 ConfidenceAlternates 方法之间的差异。尽管在 GetAlternatesFromSelection 方法返回的 RecognitionAlternates 集合中，每个 RecognitionAlternate 对象都只对应选定部分中的一个墨迹段，但在 AlternatesWithConstantPropertyValues、LineAlternates 和 ConfidenceAlternates 方法返回的 RecognitionAlternates 集合中，RecognitionAlternate 对象对应选定部分的每个墨迹段。

示例

此 C# 示例为 Textox 控件（已填充 RecognitionResult 对象中的最佳结果）theTextBox 中的用户选定部分最多返回五个 RecognitionAlternate 对象。备选项通过 GetAlternatesFromSelection 方法存储在 RecognitionAlternates 集合 theRecognitionAlternates 中。这种方式非常有用，因为用户可以选择已识别的文本，并在备选项中搜索该文本以插入更正内容。

[C#]

using Microsoft.Ink;
// . . .
try
{
    if (theTextBox.SelectionLength != 0)
    {
        RecognitionAlternates theRecognitionAlternates =
            theRecognitionResult.GetAlternatesFromSelection(
                theTextBox.SelectionStart, theTextBox.SelectionLength, 5);
        // Do something with theRecognitionAlternates here.
    }
}
catch
{
    // handle exceptions here.
}

此 Microsoft(R) Visual Basic(R) .NET 示例为 TextBox 控件（已填充 RecognitionResult 对象中的最佳结果）theTextBox 中的用户选定部分最多返回五个 RecognitionAlternate 对象。备选项通过 GetAlternatesFromSelection 方法存储在 RecognitionAlternates 集合 theRecognitionAlternates 中。这种方式非常有用，因为用户可以选择已识别的文本，并在备选项中搜索该文本以插入更正内容。

[Visual Basic]

Imports Microsoft.Ink
' . . .
Try
    If theTextBox.SelectionLength != 0 Then
        Dim theRecognitionAlternates As RecognitionAlternates
        theRecognitionAlternates = _
            theRecognitionResult.GetAlternatesFromSelection( _
                theTextBox.SelectionStart, _
                theTextBox.SelectionLength, 5)
        'Do something with theRecognitionAlternates here.
    End If
Catch
    'Handle exceptions here.
End Try