Metodo RecognizerContext.StopBackgroundRecognition

Articolo
10/29/2008

Aggiornamento: novembre 2007

Termina il riconoscimento in background avviato con una chiamata all'oggetto BackgroundRecognize o BackgroundRecognizeWithAlternates.

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

Sintassi

'Dichiarazione
Public Sub StopBackgroundRecognition
'Utilizzo
Dim instance As RecognizerContext

instance.StopBackgroundRecognition()

public void StopBackgroundRecognition()

public:
void StopBackgroundRecognition()

public void StopBackgroundRecognition()

public function StopBackgroundRecognition()

Note

Quando viene chiamato il metodo StopBackgroundRecognition non viene generato alcun evento.

Chiamare il metodo StopBackgroundRecognition se si chiama l'oggetto BackgroundRecognize o BackgroundRecognizeWithAlternates una o più volte. La chiamata all'oggetto StopBackgroundRecognition non assicura necessariamente che non si ottengano risultati da un processo di riconoscimento attualmente in esecuzione. Viene soltanto garantito che non vengono eseguite tutte le precedenti chiamate all'oggetto BackgroundRecognize o BackgroundRecognizeWithAlternates che non sono state ancora elaborate.

Chiamare questo metodo solo se l'input penna viene elaborato in modo asincrono.

Esempi

In questo esempio, quando viene generato l'evento Stroke (in risposta al completamento di un tratto da parte dell'utente), viene chiamato il metodo StopBackgroundRecognition per assicurarsi che vengano cancellate tutte le eventuali richieste di riconoscimento in background in sospeso. Successivamente, il tratto appena creato viene aggiunto all'insieme Strokes dell'oggetto RecognizerContext e viene chiamato il metodo 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();
}

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.