RecognizerContext.StopBackgroundRecognition (Método)

Artículo
10/28/2008

Actualización: noviembre 2007

Finaliza el reconocimiento en segundo plano que se inició con una llamada a los métodos BackgroundRecognize o BackgroundRecognizeWithAlternates.

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

Sintaxis

'Declaración
Public Sub StopBackgroundRecognition
'Uso
Dim instance As RecognizerContext

instance.StopBackgroundRecognition()

public void StopBackgroundRecognition()

public:
void StopBackgroundRecognition()

public void StopBackgroundRecognition()

public function StopBackgroundRecognition()

Comentarios

No se desencadena ningún evento cuando se llama al método StopBackgroundRecognition.

Llame al método StopBackgroundRecognition si llama a BackgroundRecognize o a BackgroundRecognizeWithAlternates una o más veces. Llamar a StopBackgroundRecognition no asegura necesariamente que no obtenga resultados de un proceso del reconocimiento que se esté realizando. Únicamente garantiza que no se ejecutan todas las llamadas anteriores a BackgroundRecognize o BackgroundRecognizeWithAlternates que no se hayan procesado todavía.

Llame a este método solamente si procesa la entrada manuscrita de forma asincrónica.

Ejemplos

En este ejemplo, cuando se desencadena el evento Stroke, se llama al método (en respuesta al usuario que completa un trazo), se llama al método StopBackgroundRecognition para garantizar que se cancelan las solicitudes de reconocimiento en segundo plano que haya pendientes. A continuación, el trazo recién creado se agrega a la colección Strokes del objeto RecognizerContext y se llama al método BackgroundRecognize.

Private Sub mInkOverlay_Stroke2(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.BackgroundRecognize()
End Sub

private void mInkOverlay_Stroke2(object sender, InkCollectorStrokeEventArgs e)
{
    // in case background recognition is still occurring, stop it
    mRecognizerContext.StopBackgroundRecognition();
    // add the stroke, and start recognition
    mRecognizerContext.Strokes.Add(e.Stroke);
    mRecognizerContext.BackgroundRecognize();
}

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.