Analyze メソッドまたは BackgroundAnalyze メソッドの呼び出し時に発生します。
名前空間 : Microsoft.Ink
アセンブリ : Microsoft.Ink.Analysis (Microsoft.Ink.Analysis.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 では、イベントは使用できません。
解説
このイベントは、インク アナライザがインク分析を実行することを示します。このイベントは、このタスクにおけるインク アナライザの進捗状況は示しません。
このイベントは、次の状況で処理します。
ユーザーにアクティビティを示す場合。
同期分析時にユーザー入力を処理する場合。
アプリケーションのウィンドウの再描画など、システム要求の通知を受け取る場合。
インク アナライザは、レイアウト分析段階、およびインク分析の書き込みおよび描画分類時に、このイベントを頻繁に発生させます。インク アナライザは、手書き認識段階でインク認識エンジンへのアクセスの前後に、このイベントを発生させます。
インク アナライザが生成するアクティビティ イベントの数は、次の要素によって決まります。
インク アナライザがインク認識に適用するインク認識エンジン。
インク アナライザが分析するストロークの数と長さ。
書き込みとして分類されるストロークの数。
アプリケーション データと InkAnalyzer の同期の詳細については、「Data Proxy with Ink Analysis」を参照してください。
例
この例では、インク アナライザの Activity イベントを処理するイベント ハンドラを定義しています。分析処理をキャンセルする必要がある場合、イベント ハンドラはイベントを生成した InkAnalyzer で Abort を呼び出し、アナライザの 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 Microsoft.Ink.InkAnalyzer = _
DirectCast(sender, Microsoft.Ink.InkAnalyzer)
' Abort the analysis and get the region that was being analyzed.
Dim theAnalysisRegion As Microsoft.Ink.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.
Microsoft.Ink.InkAnalyzer theInkAnalyzer =
sender as Microsoft.Ink.InkAnalyzer;
// Abort the analysis and get the region that was being analyzed.
Microsoft.Ink.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