RecognizerContext.BackgroundRecognizeWithAlternates (Método) (Object)

Artículo
11/26/2008

Actualización: noviembre 2007

Hace que el objeto Recognizer reconozca la colección Strokes la asociada y se provoca un evento RecognitionWithAlternates, con datos de la aplicación asociados, cuando el reconocimiento ha finalizado.

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

Sintaxis

'Declaración
Public Sub BackgroundRecognizeWithAlternates ( _
    customData As Object _
)
'Uso
Dim instance As RecognizerContext
Dim customData As Object

instance.BackgroundRecognizeWithAlternates(customData)

public void BackgroundRecognizeWithAlternates(
    Object customData
)

public:
void BackgroundRecognizeWithAlternates(
    Object^ customData
)

public void BackgroundRecognizeWithAlternates(
    Object customData
)

public function BackgroundRecognizeWithAlternates(
    customData : Object
)

Parámetros

customData
Tipo: System.Object
Todos los datos definidos por la aplicación que estén disponibles para la aplicación en el evento Recognition. El valor predeterminado es nullreferencia null (Nothing en Visual Basic) (Nothing en Microsoft® Visual Basic® .NET).

Comentarios

Este método especifica que el reconocimiento de entradas manuscritas se realiza de forma asincrónica.

Para realizar un reconocimiento que incluya solamente las alternativas principales, llame al método BackgroundRecognize.

No se provoca el evento RecognitionWithAlternates si el reconocedor no reconoce ninguna alternativa.

Ejemplos

En este ejemplo, cada trazo creado en un objeto InkOverlay se reconoce automáticamente y se muestra el resultado del reconocimiento.

Cuando se activa el evento Stroke (en respuesta a la finalización de un trazo por parte del usuario), el trazo recién creado se agrega a la colección Strokes del objeto RecognizerContext y se llama al método BackgroundRecognizeWithAlternates mientras se pasa la hora actual al parámetro customData.

Private Sub mInkOverlay_Stroke3(ByVal sender As Object, ByVal e As InkCollectorStrokeEventArgs)
    ' in case background recognition is still occurring, stop it
    mRecognizerContext.StopBackgroundRecognition()
    ' add the stroke, and start recognition
    mRecognizerContext.Strokes.Add(e.Stroke)
    mRecognizerContext.BackgroundRecognizeWithAlternates(DateTime.Now)
End Sub

private void mInkOverlay_Stroke3(object sender, InkCollectorStrokeEventArgs e)
{
    // in case background recognition is still occurring, stop it
    mRecognizerContext.StopBackgroundRecognition();
    // add the stroke, and start recognition, passing current time
    mRecognizerContext.Strokes.Add(e.Stroke);
    mRecognizerContext.BackgroundRecognizeWithAlternates(DateTime.Now);
}

Cuando se completa el reconocimiento en segundo plano, se desencadena el evento RecognitionWithAlternates. Durante el control de este evento, los resultados del reconocimiento (incluidas las alternativas) se introducen en un cuadro de lista. Asimismo, el momento en que se inicia el reconocimiento se recupera de la propiedad CustomData del objeto RecognizerContextRecognitionWithAlternatesEventArgs y se usa para calcular el tiempo total que es necesario que transcurra para el reconocimiento.

' event fires when recognition results (without alternates) are ready
Private Sub RecognizerContext_Recognition(ByVal sender As Object, _
            ByVal e As RecognizerContextRecognitionEventArgs)
    ' when updating a control, must use Invoke() since controls are
    ' not thread safe and recognition occurs on a different thread
    If Me.InvokeRequired Then
        ' recursively call this method via Invoke()
        Me.Invoke( _
            New RecognizerContextRecognitionEventHandler(AddressOf RecognizerContext_Recognition), _
            New Object() {sender, e} _
        )
        Return
    End If
    If RecognitionStatus.NoError = e.RecognitionStatus Then
        listBoxRecognitionResults.Items.Add(e.Text)
        ' get the custom data and calculate elapsed time
        Dim startTime As DateTime = DirectCast(e.CustomData, DateTime)
        Dim endTime As DateTime = DateTime.Now
        Dim span As TimeSpan = New TimeSpan(endTime.Ticks - startTime.Ticks)
        ' display the number of seconds for this recognition to finish
        listBoxRecognitionResults.Items.Add(span.TotalSeconds.ToString())
    End If
End Sub

// event fires when recognition results (without alternates) are ready
private void RecognizerContext_Recognition(object sender, RecognizerContextRecognitionEventArgs e)
{
    // when updating a control, must use Invoke() since controls are
    // not thread safe and recognition occurs on a different thread
    if (this.InvokeRequired)
    {
        // recursively call this method via Invoke()
        this.Invoke(
            new RecognizerContextRecognitionEventHandler(RecognizerContext_Recognition),
            new object[] { sender, e }
            );
        return;
    }

    if (RecognitionStatus.NoError == e.RecognitionStatus)
    {
        listBoxRecognitionResults.Items.Add(e.Text);
        // get the custom data and calculate elapsed time
        DateTime startTime = (DateTime)e.CustomData;
        DateTime endTime = DateTime.Now;
        TimeSpan span = new TimeSpan(endTime.Ticks - startTime.Ticks);
        // display the number of seconds for this recognition to finish
        listBoxRecognitionResults.Items.Add(span.TotalSeconds.ToString());
    }
}

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.