RecognitionResult.GetAlternatesFromSelection (Método) (Int32, Int32, Int32)

Artículo
11/26/2008

Actualización: noviembre 2007

Devuelve la colección RecognitionAlternates a partir de un intervalo de la cadena más satisfactoria del objeto RecognitionResult, de modo que cada objeto RecognitionAlternate de la colección se corresponde con un único segmento de la entrada manuscrita. La colección devuelta se limita a un tamaño especificado.

Espacio de nombres: Microsoft.Ink
Ensamblado: Microsoft.Ink (en Microsoft.Ink.dll)

Sintaxis

'Declaración
Public Function GetAlternatesFromSelection ( _
    selectionStart As Integer, _
    selectionLength As Integer, _
    maximumAlternates As Integer _
) As RecognitionAlternates
'Uso
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

Parámetros

selectionStart
Tipo: System.Int32
Comienzo de la selección de texto desde la que se devuelve la colección RecognitionAlternates. El valor predeterminado es 0 (cero).

selectionLength
Tipo: System.Int32
Longitud de la selección de texto desde la que se devuelve la colección RecognitionAlternates. El valor predeterminado es –1, que especifica el texto que empieza al principio de la selección hasta el final de la cadena.

maximumAlternates
Tipo: System.Int32
Número máximo de alternativas que se va a devolver. El valor predeterminado es 10. Los reconocedores que no pueden calcular el número de alternativas, debido al grado de dificultad o a la duración, devuelven un número arbitrario de alternativas.

Valor devuelto

Tipo: Microsoft.Ink.RecognitionAlternates
Devuelve la colección RecognitionAlternates a partir de una selección de la cadena más satisfactoria del objeto RecognitionResult, de modo que cada objeto RecognitionAlternate de la colección se corresponde con un único segmento de la entrada manuscrita.

Comentarios

Nota

El número de alternativas aumenta exponencialmente para los intervalos grandes y para algunos idiomas. Las aplicaciones deberían especificar el número de alternativas en lugar de consultar el número máximo de alternativas que el reconocedor puede devolver.

Es probable que un reconocedor divida "how are you" en tres segmentos (en función del espaciado entre los segmentos), uno por palabra. Llame al método GetAlternatesFromSelection si desea devolver las alternativas para un solo segmento de esta selección.

Tenga en cuenta la diferencia entre el método GetAlternatesFromSelection y los métodos AlternatesWithConstantPropertyValues, LineAlternates y ConfidenceAlternates del objeto RecognitionAlternate. Aunque el método GetAlternatesFromSelection devuelve una colección RecognitionAlternates en la que cada objeto RecognitionAlternate se corresponde con un solo segmento de entrada manuscrita de una selección, los métodos AlternatesWithConstantPropertyValues, LineAlternates y ConfidenceAlternates devuelven la colección RecognitionAlternates, en la que los objetos RecognitionAlternate se corresponden con cada segmento de entrada manuscrita de una selección.

Ejemplos

En este ejemplo de C#, se devuelven hasta cinco objetos RecognitionAlternate para la selección del usuario en un control TextBox, theTextBox, que ya se ha llenado con el mejor resultado del objeto RecognitionResult. Las alternativas se almacenan en la colección RecognitionAlternates, theRecognitionAlternates mediante el uso del método GetAlternatesFromSelection. Ésta es una manera útil de que el usuario pueda seleccionar texto que se ha reconocido y buscar entre las alternativas de ese texto para insertar una corrección.

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

En este ejemplo de Microsoft® Visual Basic® .NET, se devuelven hasta cinco objetos RecognitionAlternate para la selección del usuario en un control TextBox, theTextBox, que ya se ha llenado con el mejor resultado del objeto RecognitionResult. Las alternativas se almacenan en la colección RecognitionAlternates, theRecognitionAlternates mediante el uso del método GetAlternatesFromSelection. Ésta es una manera útil de que el usuario pueda seleccionar texto que se ha reconocido y buscar entre las alternativas de ese texto para insertar una corrección.

[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

Plataformas

Windows Vista

.NET Framework y .NET Compact Framework no admiten todas las versiones de cada plataforma. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.