RecognizerContext.StopBackgroundRecognition メソッド

2008-10-28

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 を 1 回以上呼び出す場合は、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();
}