RecognitionResult.GetAlternatesFromSelection-Methode (Int32, Int32, Int32)

Artikel
10/28/2008

Gibt die RecognitionAlternates-Auflistung aus einem Bereich innerhalb der Zeichenfolge mit dem besten Ergebnis des RecognitionResult-Objekts zurück, sodass jedes RecognitionAlternate-Objekt in der Auflistung nur einem Freihandsegment entspricht. Die zurückgegebene Auflistung ist auf eine angegebene Größe beschränkt.

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

Syntax

'Declaration
Public Function GetAlternatesFromSelection ( _
    selectionStart As Integer, _
    selectionLength As Integer, _
    maximumAlternates As Integer _
) As RecognitionAlternates
'Usage
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

Parameter

selectionStart
Typ: System.Int32
Der Anfang der Textauswahl, von der die RecognitionAlternates-Auflistung zurückgegeben wird. Der Standardwert ist 0 (null).

selectionLength
Typ: System.Int32
Die Länge der Textauswahl, von der die RecognitionAlternates-Auflistung zurückgegeben wird. Der Standardwert ist -1. Dies gibt an, dass der Text am Anfang der Auswahl beginnt und sich bis zum Ende der Zeichenfolge erstreckt.

maximumAlternates
Typ: System.Int32
Die maximale Anzahl zurückzugebender Alternativen. Der Standardwert ist 10. Erkennungsmodule, die die Anzahl von Alternativen aufgrund des Schwierigkeitsgrads oder der Zeitdauer nicht berechnen können, geben eine beliebige Alternativenzahl zurück.

Rückgabewert

Typ: Microsoft.Ink.RecognitionAlternates
Gibt die RecognitionAlternates-Auflistung aus einer Auswahl innerhalb der Zeichenfolge mit dem besten Ergebnis des RecognitionResult-Objekts zurück, sodass jedes RecognitionAlternate-Objekt in der Auflistung nur einem Freihandsegment entspricht.

Hinweise

Hinweis

Die Anzahl von Alternativen nimmt bei großen Bereichen und bestimmten Sprachen exponentiell zu. Anwendungen sollten die Anzahl von Alternative angeben, anstatt abzufragen, welche Zahl von Alternativen das Erkennungsmodul maximal zurückgeben kann.

Ein Erkennungsmodul teilt wahrscheinlich die Aussage "how are you" in drei Segmente auf (je nach dem Abstand zwischen den Segmenten), wobei ein Segment jeweils ein Wort enthält. Rufen Sie die GetAlternatesFromSelection-Methode auf, um die Alternativen für nur ein Segment dieser Auswahl zurückzugeben.

Beachten Sie den Unterschied zwischen der GetAlternatesFromSelection-Methode und den Methoden AlternatesWithConstantPropertyValues, LineAlternates und ConfidenceAlternates des RecognitionAlternate-Objekts. Die GetAlternatesFromSelection-Methode gibt zwar eine RecognitionAlternates-Auflistung zurück, in der jedes RecognitionAlternate-Objekt nur einem Freihandsegment innerhalb einer Auswahl entspricht, die Methoden AlternatesWithConstantPropertyValues, LineAlternates und ConfidenceAlternates geben jedoch die RecognitionAlternates-Auflistung zurück, in der die RecognitionAlternate-Objekte den einzelnen Freihandsegmenten innerhalb einer Auswahl entsprechen.

Beispiele

In diesem C#-Beispiel werden bis zu fünf RecognitionAlternate-Objekte für die Benutzerauswahl in einem TextBox-Steuerelement namens theTextBox zurückgegeben, das bereits mit dem ersten (obersten) Ergebnis aus dem RecognitionResult-Objekt ausgefüllt wurde. Die Alternativen werden mithilfe der GetAlternatesFromSelection-Methode in der RecognitionAlternates-Auflistung theRecognitionAlternates gespeichert. Das ist ein nützliches Verfahren, um einem Benutzer die Auswahl von erkanntem Text und die Suche in den Alternativen nach diesem Text zu ermöglichen, um eine Korrektur einzugeben.

[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.
}

In diesem Microsoft® Visual Basic® .NET-Beispiel werden bis zu fünf RecognitionAlternate-Objekte für die Benutzerauswahl in einem TextBox-Steuerelement namens theTextBox zurückgegeben, das bereits mit dem ersten (obersten) Ergebnis aus dem RecognitionResult-Objekt ausgefüllt wurde. Die Alternativen werden mithilfe der GetAlternatesFromSelection-Methode in der RecognitionAlternates-Auflistung theRecognitionAlternates gespeichert. Das ist ein nützliches Verfahren, um einem Benutzer die Auswahl von erkanntem Text und die Suche in den Alternativen nach diesem Text zu ermöglichen, um eine Korrektur einzugeben.

[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

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.