RecognitionResult.ModifyTopAlternate (Método)

Artículo
10/28/2008

Actualización: noviembre 2007

Modifica el objeto RecognitionResult con un objeto RecognitionAlternate conocido.

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

Sintaxis

'Declaración
Public Sub ModifyTopAlternate ( _
    alternate As RecognitionAlternate _
)
'Uso
Dim instance As RecognitionResult
Dim alternate As RecognitionAlternate

instance.ModifyTopAlternate(alternate)

public void ModifyTopAlternate(
    RecognitionAlternate alternate
)

public:
void ModifyTopAlternate(
    RecognitionAlternate^ alternate
)

public void ModifyTopAlternate(
    RecognitionAlternate alternate
)

public function ModifyTopAlternate(
    alternate : RecognitionAlternate
)

Parámetros

alternate
Tipo: Microsoft.Ink.RecognitionAlternate
RecognitionAlternate que se usa para modificar el objeto RecognitionResult.

Comentarios

De forma predeterminada, la propiedad TopString del objeto RecognitionResult se corresponde con la propiedad TopAlternate; sin embargo, puede elegir este método para utilizar otras alternativas que no sea la mejor del resultado. Al elegir una alternativa que no sea la mejor, esencialmente está eligiendo una ruta de acceso diferente en el entramado de alternativas asociadas a los resultados.

Para recuperar los objetos RecognitionAlternate que se pueden utilizar para modificar el objeto RecognitionResult, llame al método GetAlternatesFromSelection.

La alternativa que se usa en este método puede ser una palabra alternativa dentro de una oración completa. Por ejemplo, al llamar al método ModifyTopAlternate en una alternativa obtenida mediante una llamada a GetAlternatesFromSelection(0,5) para "Hello World", se cambia "Hello" pero "World" se mantiene tal cual.

Nota

Una llamada al método ModifyTopAlternate puede modificar las propiedades TopAlternate y TopString del objeto RecognitionResult.

Ejemplos

En este ejemplo de C#, se realiza el seguimiento del objeto RecognitionResult y sus objetos RecognitionAlternate. A continuación, se guardan los objetos RecognitionResult con los objetos Stroke que se reconocen mediante el uso del método SetResultOnStrokes. Finalmente, se modifica la propiedad TopAlternate del objeto RecognitionResult según los datos proporcionados por el usuario.

[C#]

// Declarations...
InkCollector theInkCollector;
Strokes theStrokes;
RecognizerContext theRecognizerContext;
RecognitionResult theRecognitionResult;

// Initialization...

// Initialize the recognizer's strokes
// and assign them to the context.
theStrokes = theInkCollector.Ink.Strokes;
theRecognizerContext = new RecognizerContext();
theRecognizerContext.Strokes = theStrokes;

// Install event handlers.
theRecognizerContext.RecognitionWithAlternates +=
    new RecognizerContextRecognitionWithAlternatesEventHandler(
        RecognitionWithAlternates_Event);

//...

// Recognition Event Handler
private void RecognitionWithAlternates_Event(
    object sender,
    RecognizerContextRecognitionWithAlternatesEventArgs e)
{
    // Save the RecognitionResult, and copy it to the strokes
    theRecognitionResult = e.Result;
    theRecognitionResult.SetResultOnStrokes();
}

// Modify the TopAlternate of the result
private void buttonAlt2_Click(object sender, System.EventArgs e)
{
    RecognitionAlternates theRecognitionAlternates =
        theRecognitionResult.GetAlternatesFromSelection(0, -1);
    theRecognitionResult.ModifyTopAlternate(theRecognitionAlternates[2]);
}

En este ejemplo de Microsoft® Visual Basic® .NET, se realiza el seguimiento del objeto RecognitionResult y sus objetos RecognitionAlternate. A continuación, se guardan los objetos RecognitionResult con los objetos Stroke que se reconocen mediante el uso del método SetResultOnStrokes. Finalmente, se modifica la propiedad TopAlternate del objeto RecognitionResult según los datos proporcionados por el usuario.

[Visual Basic]

'Declarations...
Dim theInkCollector As InkCollector
Dim theStrokes As Strokes
Dim theRecognizerContext As RecognizerContext
Dim theRecognitionResult As RecognitionResult

'Initialization...

'Initialize the recognizer's strokes
'and assign them to the context.
theStrokes = theInkCollector.Ink.Strokes
theRecognizerContext = new RecognizerContext()
theRecognizerContext.Strokes = theStrokes

'Install event handlers.
AddHandler theRecognizerContext.RecognitionWithAlternates, _
AddressOf RecognitionWithAlternates_Event

'...

'Recognition Event Handler
Private Sub RecognitionWithAlternates_Event( _
ByVal sender As Object, _
ByVal e As RecognizerContextRecognitionWithAlternatesEventArgs)
    'Save the RecognitionResult, and copy it to the strokes.
    theRecognitionResult = e.Result
    theRecognitionResult.SetResultOnStrokes()
End Sub

'Modify the TopAlternate of the result
Private Sub ButtonAlt2_Click(object sender, System.EventArgs e) _
Handles ButtonAlt2.Click
    RecognitionAlternates theRecognitionAlternates =
        theRecognitionResult.GetAlternatesFromSelection(0, -1)
    theRecognitionResult.ModifyTopAlternate(theRecognitionAlternates(2))
End Sub

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.