次の方法で共有


InkAnalyzerBase.ActivityBase イベント

Analyze メソッドまたは BackgroundAnalyze メソッドの呼び出し時に発生します。

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

構文

'宣言
Public Event ActivityBase As ActivityBaseEventHandler
'使用
Dim instance As InkAnalyzerBase
Dim handler As ActivityBaseEventHandler

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

解説

このイベントは、インク アナライザがインク分析を実行することを示します。このイベントは、このタスクにおけるインク アナライザの進捗状況は示しません。

このイベントは、次の状況で処理します。

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

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

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

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

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

  • インク アナライザがインク認識に適用するインク認識エンジン。

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

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

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

この例では、インク アナライザの ActivityBase イベントを処理するイベント ハンドラを定義しています。分析処理をキャンセルする必要がある場合、イベント ハンドラはイベントを生成した InkAnalyzerBaseAbort を呼び出し、アナライザの 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 theInkAnalyzerBase_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 analyzer that raised the Activity event.
        Dim theInkAnalyzerBase As System.Windows.Ink.AnalysisCore.InkAnalyzerBase = _
            DirectCast(sender, System.Windows.Ink.AnalysisCore.InkAnalyzerBase)

        ' Abort the analysis and get the region that was being analyzed.
        Dim theAnalysisRegionBase As System.Windows.Ink.AnalysisCore.AnalysisRegionBase = _
            theInkAnalyzerBase.Abort()

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

End Sub 'theInkAnalyzerBase_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 theInkAnalyzerBase_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 analyzer that raised the Activity event.
        System.Windows.Ink.AnalysisCore.InkAnalyzerBase theInkAnalyzerBase =
            sender as System.Windows.Ink.AnalysisCore.InkAnalyzerBase;

        // Abort the analysis and get the region that was being analyzed.
        System.Windows.Ink.AnalysisCore.AnalysisRegionBase theAnalysisRegionBase =
            theInkAnalyzerBase.Abort();

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

プラットフォーム

Windows Vista, Windows XP SP2, Windows Server 2003

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

バージョン情報

.NET Framework

サポート対象 : 3.0

参照

参照

InkAnalyzerBase クラス

InkAnalyzerBase メンバ

System.Windows.Ink.AnalysisCore 名前空間