RecognizerContext.StopBackgroundRecognition 方法

项目
11/04/2008

终止通过调用 BackgroundRecognize 或 BackgroundRecognizeWithAlternates 启动的后台识别。

命名空间： Microsoft.Ink
程序集： Microsoft.Ink（在 Microsoft.Ink.dll 中）

语法

声明
Public Sub StopBackgroundRecognition
用法
Dim instance As RecognizerContext

instance.StopBackgroundRecognition()

public void StopBackgroundRecognition()

public:
void StopBackgroundRecognition()

public void StopBackgroundRecognition()

public function StopBackgroundRecognition()

备注

调用 StopBackgroundRecognition 方法时，不激发任何事件。

如果调用或多次调用 BackgroundRecognize 或 BackgroundRecognizeWithAlternates，请调用 StopBackgroundRecognition 方法。调用 StopBackgroundRecognition 并不一定可确保不从当前执行的识别进程获取结果。此操作只能确保不执行以前对 BackgroundRecognize 或 BackgroundRecognizeWithAlternates 进行的尚未处理的所有调用。

仅当以异步方式处理墨迹时才应调用此方法。

示例

在此示例中，在激发 Stroke 事件（对用户完成笔画做出的响应）时，将调用 StopBackgroundRecognition 方法以确保取消任何挂起的后台识别请求。然后，将新创建的笔画添加到 RecognizerContext 对象的 Strokes 集合中，并调用 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();
}