Metodo RecognitionResult.GetAlternatesFromSelection (Int32, Int32, Int32)

Aggiornamento: novembre 2007

Restituisce l'insieme RecognitionAlternates da un intervallo all'interno della stringa di risultato migliore dell'oggetto RecognitionResult, in modo che ogni oggetto RecognitionAlternate nell'insieme corrisponda a un solo segmento di input penna. L'insieme restituito non può superare una dimensione specificata.

Spazio dei nomi: Microsoft.Ink
Assembly: Microsoft.Ink (in Microsoft.Ink.dll)

Sintassi

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

Parametri

selectionStart
Tipo: System.Int32
Inizio della selezione di testo da cui viene restituito l'insieme RecognitionAlternates. Il valore predefinito è 0 (zero).

selectionLength
Tipo: System.Int32
Lunghezza della selezione di testo da cui viene restituito l'insieme RecognitionAlternates. Il valore predefinito è –1 che specifica l'inizio del testo dall'inizio della selezione alla fine della stringa.

maximumAlternates
Tipo: System.Int32
Numero massimo di alternative da restituire. Il valore predefinito è 10. I riconoscimenti che non sono in grado di calcolare il numero di alternative, a causa del grado di difficoltà o della durata di tempo, restituiscono un numero arbitrario di alternative.

Valore restituito

Tipo: Microsoft.Ink.RecognitionAlternates
Restituisce l'insieme RecognitionAlternates da una selezione all'interno della stringa di risultato migliore dell'oggetto RecognitionResult, in modo che ogni oggetto RecognitionAlternate nell'insieme corrisponda a un solo segmento di input penna.

Note

Nota

Il numero di alternative aumenta esponenzialmente per intervalli ampi e per alcune lingue. Le applicazioni devono specificare il numero di alternative piuttosto che eseguire query per ottenere il numero massimo di alternative restituibili dal riconoscimento.

È probabile che un riconoscimento divida "how are you" in tre segmenti, a seconda della spaziatura tra i segmenti, uno per parola. Chiamare il metodo GetAlternatesFromSelection per restituire le alternative per un solo segmento di questa selezione.

Si noti la differenza tra il metodo GetAlternatesFromSelection e i metodi AlternatesWithConstantPropertyValues, LineAlternates e ConfidenceAlternates dell'oggetto RecognitionAlternate. Sebbene il metodo GetAlternatesFromSelection restituisca un insieme RecognitionAlternates in cui ogni oggetto RecognitionAlternate corrisponde a un solo segmento di input penna all'interno di una selezione, i metodi AlternatesWithConstantPropertyValues, LineAlternates e ConfidenceAlternates restituiscono l'insieme RecognitionAlternates in cui gli oggetti RecognitionAlternate corrispondono a ogni segmento di input penna all'interno di una selezione.

Esempi

In questo esempio C# vengono restituiti fino a cinque oggetti RecognitionAlternate per la selezione dell'utente in un controllo TextBox, theTextBox, che è già stato compilato con il primo risultato dall'oggetto RecognitionResult. Le alternative vengono archiviate nell'insieme RecognitionAlternates, theRecognitionAlternates, mediante il metodo GetAlternatesFromSelection. È un modo utile per consentire a un utente di selezionare il testo riconosciuto e cercare nelle alternative il testo in questione allo scopo di inserire una correzione.

[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 questo esempio Microsoft® Visual Basic® .NET vengono restituiti fino a cinque oggetti RecognitionAlternate per la selezione dell'utente in un controllo TextBox, theTextBox, che è già stato compilato con il primo risultato dall'oggetto RecognitionResult. Le alternative vengono archiviate nell'insieme RecognitionAlternates, theRecognitionAlternates, mediante il metodo GetAlternatesFromSelection. È un modo utile per consentire a un utente di selezionare il testo riconosciuto e cercare nelle alternative il testo in questione allo scopo di inserire una correzione.

[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

Piattaforme

Windows Vista

.NET Framework e .NET Compact Framework non supportano tutte le versioni di ciascuna piattaforma. Per un elenco delle versioni supportate, vedere Requisiti di sistema di .NET Framework.