RecognizerContext.StopBackgroundRecognition, méthode

Article
11/05/2008

Mise à jour : November 2007

Met fin à la reconnaissance d'arrière-plan démarrée par un appel à BackgroundRecognize ou BackgroundRecognizeWithAlternates.

Espace de noms : Microsoft.Ink
Assembly : Microsoft.Ink (dans Microsoft.Ink.dll)

Syntaxe

'Déclaration
Public Sub StopBackgroundRecognition
'Utilisation
Dim instance As RecognizerContext

instance.StopBackgroundRecognition()

public void StopBackgroundRecognition()

public:
void StopBackgroundRecognition()

public void StopBackgroundRecognition()

public function StopBackgroundRecognition()

Notes

Aucun événement n'est déclenché lorsque vous appelez la méthode StopBackgroundRecognition.

Appelez la méthode StopBackgroundRecognition si vous appelez BackgroundRecognize ou BackgroundRecognizeWithAlternates une ou plusieurs fois. Lorsque vous appelez StopBackgroundRecognition, un processus de reconnaissance en cours peut tout de même retourner des résultats. Vous avez uniquement la garantie que tous les appels précédents à BackgroundRecognize ou BackgroundRecognizeWithAlternates qui n'ont pas encore été traités ne seront pas exécutés.

Appelez cette méthode uniquement si vous traitez l'entrée manuscrite de façon asynchrone.

Exemples

Dans cet exemple, lorsque l'événement Stroke se déclenche (suite à la création d'un trait), la méthode StopBackgroundRecognition est appelée pour vérifier que toutes demandes de reconnaissance d'arrière-plan en attente sont annulées. Le nouveau trait est ensuite ajouté à la collection Strokes de l'objet RecognizerContext et la méthode BackgroundRecognize est appelée.

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();
}

Plateformes

Windows Vista

Le .NET Framework et le .NET Compact Framework ne prennent pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.