次の方法で共有


InkAnalyzer.Activity イベント

Analyze または BackgroundAnalyze メソッドで分析が実行されていることを示すために発生します。

名前空間 :  System.Windows.Ink
アセンブリ :  IAWinFX (IAWinFX.dll 内)

構文

'宣言
Public Event Activity As ActivityEventHandler
'使用
Dim instance As InkAnalyzer
Dim handler As ActivityEventHandler

AddHandler instance.Activity, handler
public event ActivityEventHandler Activity
public:
 event ActivityEventHandler^ Activity {
    void add (ActivityEventHandler^ value);
    void remove (ActivityEventHandler^ value);
}
/** @event */
public void add_Activity (ActivityEventHandler value)
/** @event */
public void remove_Activity (ActivityEventHandler value)
JScript では、イベントは使用できません。

解説

このイベントは、インク アナライザがインク分析を実行することを示します。このイベントは、インク アナライザの進捗状況は示さないことに注意してください。

Activity イベントを処理する目的には、次のものがあります。

  • ユーザーにアクティビティを示す。

  • 同期分析時にユーザー入力を処理する。

  • アプリケーションのウィンドウの再描画など、システム要求の通知を受け取る。

インク アナライザは、レイアウト分析段階、および書き込みおよび描画分類時に、このイベントを頻繁に発生させます。インク アナライザは、手書き認識段階で InkRecognizer へのアクセスの前後に、Activity イベントを発生させます。

InkRecognizer が生成するアクティビティ イベントの数は、次の要素によって決まります。

  • InkAnalyzer がインク認識に適用する InkRecognizer

  • インク アナライザが分析するストロークの数と長さ。

  • 書き込みとして分類されるストロークの数。

アプリケーション データと InkAnalyzer の同期の詳細については、「Data Proxy with Ink Analysis」を参照してください。

この例では、インク アナライザの Activity イベントのイベント ハンドラを定義します。分析操作を中止するフラグが設定された場合、イベント ハンドラは、イベントを生成した InkAnalyzerAbort を呼び出し、アナライザの DirtyRegion プロパティを更新します。

' <summary>
' The ink analyzer's Activity event handler.
' </summary>
' <param name="sender">The source of the event.</param>
' <param name="e">The event data.</param>
Sub theInkAnalyzer_Activity(ByVal sender As Object, ByVal e As EventArgs) 
    Dim abortAnalysis As Boolean = False

    ' Check if the analysis operation should be canceled.
    ' Abort analysis if the flag to do so is set.
    If abortAnalysis Then
        ' Get the InkAnalyzer that raised the Activity event.
        Dim theInkAnalyzer As InkAnalyzer = sender

        ' Abort the analysis and get the region that was being analyzed.
        Dim theAnalysisRegion As AnalysisRegion = theInkAnalyzer.Abort()

        ' Add the region that was being analyzed to the analyzer's dirty region.
        theInkAnalyzer.DirtyRegion.Union(theAnalysisRegion)
    End If

End Sub 'theInkAnalyzer_Activity
/// <summary>
/// The ink analyzer's Activity event handler.
/// </summary>
/// <param name="sender">The source of the event.</param>
/// <param name="e">The event data.</param>
void theInkAnalyzer_Activity(object sender, EventArgs e)
{
    bool abortAnalysis = false;

    // Check if the analysis operation should be canceled.

    // Abort analysis if the flag to do so is set.
    if (abortAnalysis)
    {
        // Get the InkAnalyzer that raised the Activity event.
        InkAnalyzer theInkAnalyzer =
            sender as InkAnalyzer;

        // Abort the analysis and get the region that was being analyzed.
        AnalysisRegion theAnalysisRegion = theInkAnalyzer.Abort();

        // Add the region that was being analyzed to the analyzer's dirty region.
        theInkAnalyzer.DirtyRegion.Union(theAnalysisRegion);
    }
}

プラットフォーム

Windows Vista

.NET Framework および .NET Compact Framework では、各プラットフォームのすべてのバージョンはサポートしていません。サポートされているバージョンについては、「.NET Framework システム要件」を参照してください。

バージョン情報

.NET Framework

サポート対象 : 3.0

参照

参照

InkAnalyzer クラス

InkAnalyzer メンバ

System.Windows.Ink 名前空間