RecognizerContext.StopBackgroundRecognition-Methode

Artikel
11/26/2008

Beendet die Hintergrunderkennung, die mit einem Aufruf von BackgroundRecognize oder BackgroundRecognizeWithAlternates gestartet wurde.

Namespace: Microsoft.Ink
Assembly: Microsoft.Ink (in Microsoft.Ink.dll)

Syntax

'Declaration
Public Sub StopBackgroundRecognition
'Usage
Dim instance As RecognizerContext

instance.StopBackgroundRecognition()

public void StopBackgroundRecognition()

public:
void StopBackgroundRecognition()

public void StopBackgroundRecognition()

public function StopBackgroundRecognition()

Hinweise

Beim Aufruf der StopBackgroundRecognition-Methode wird kein Ereignis ausgelöst.

Rufen Sie die StopBackgroundRecognition-Methode auf, wenn Sie BackgroundRecognize oder BackgroundRecognizeWithAlternates einmal oder mehrmals aufrufen. Durch den Aufruf von StopBackgroundRecognition wird nicht notwendigerweise sichergestellt, dass ein gegenwärtig laufender Erkennungsprozess keine Ergebnisse liefert. Damit wird nur sichergestellt, dass vorherige Aufrufe von BackgroundRecognize oder BackgroundRecognizeWithAlternates, die bislang noch nicht verarbeitet wurden, nicht ausgeführt werden.

Rufen Sie diese Methode nur auf, wenn die Freihandeingaben asynchron verarbeitet werden.

Beispiele

In diesem Beispiel wird beim Auslösen des Stroke-Ereignisses (in Reaktion auf das Abschließen eines Strichs durch den Benutzer) die StopBackgroundRecognition-Methode aufgerufen, um sicherzustellen, dass ausstehende Anforderungen für die Hintergrunderkennung storniert werden. Der neu erstellte Strich wird dann der Strokes-Auflistung des RecognizerContext-Objekts hinzugefügt, und die BackgroundRecognize-Methode wird aufgerufen.

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

Plattformen

Windows Vista

.NET Framework und .NET Compact Framework unterstützen nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.