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 命名空間