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 事件定义事件处理程序。如果将分析操作标记为中止，则该事件处理程序对生成该事件的 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 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 命名空间