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

發行項
10/29/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# 範例會針對 TextBox (英文) 控制項 theTextBox 中的使用者選取範圍傳回多達五個 RecognitionAlternate 物件，而這個控制項已使用 RecognitionResult 物件的頂端結果填滿。接著再藉由使用 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® Visual Basic® .NET 範例會針對 TextBox (英文) 控制項 theTextBox 中的使用者選取範圍傳回多達五個 RecognitionAlternate 物件，而這個控制項已使用 RecognitionResult 物件的頂端結果填滿。接著再藉由使用 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