InkAnalyzer.Analyze 方法

發行項
10/29/2008

執行同步筆墨分析。

命名空間： Microsoft.Ink
組件： Microsoft.Ink.Analysis (在 Microsoft.Ink.Analysis.dll 中)

語法

'宣告
Public Function Analyze As AnalysisStatus
'用途
Dim instance As InkAnalyzer
Dim returnValue As AnalysisStatus

returnValue = instance.Analyze()

public AnalysisStatus Analyze()

public:
AnalysisStatus^ Analyze()

public AnalysisStatus Analyze()

public function Analyze() : AnalysisStatus

傳回值

型別：Microsoft.Ink.AnalysisStatus
分析作業的狀態。

備註

這個方法會開始進行同步處理的筆墨分析作業。筆墨分析包括配置分析、書寫和繪圖分類以及手寫輸入辨識。這項作業會在分析作業完成後傳回。InkAnalyzer 只會在其 DirtyRegion 內分析筆墨。

這個方法會將 InkAnalyzer 物件的 DirtyRegion 設為空區域。如果另一個執行緒已加入尚未分析的筆劃資料，則 InkAnalyzer 會在分析的協調階段將已分析筆劃的週框方塊加入至其 DirtyRegion。

InkAnalyzer 不會引發 ResultsUpdated 和 IntermediateResultsUpdated 事件來回應這個方法。

若要修改執行分析的方式，請使用 InkAnalyzer 物件的 AnalysisModes 屬性。

如需筆墨分析的詳細資訊，請參閱Ink Analysis Overview。

範例

這個範例會定義功能表項目之 click 事件的事件處理常式。事件處理常式會在 InkAnalyzer 物件的 DirtyRegion 不是空白時執行同步筆墨分析。它會附加 InkAnalyzer.Activity 事件處理常式並執行分析。然後會移除事件處理常式並且呼叫 Helper 方法 UpdateResults，以分析結果更新表單。

''' <summary>
''' The Ink menu's Analyze menu item's Click event handler.
''' </summary>
''' <param name="sender">The source of the event.</param>
''' <param name="e">The event data.</param>
Private Sub theInkAnalyzeMenuItem_Click( _
    ByVal sender As Object, ByVal e As EventArgs) _
    Handles theInkAnalyzeMenuItem.Click

    ' Only start ink analysis if the dirty region is not empty.
    If Not Me.theInkAnalyzer.DirtyRegion.IsEmpty Then
        ' Attach an activity event handler.
        AddHandler Me.theInkAnalyzer.Activity, AddressOf theInkAnalyzer_Activity

        ' Perform the ink analysis.
        Dim theStatus As Microsoft.Ink.AnalysisStatus = Me.theInkAnalyzer.Analyze()

        ' Remove the activity event handler.
        RemoveHandler Me.theInkAnalyzer.Activity, AddressOf theInkAnalyzer_Activity

        ' Update the analysis results on the form.
        Me.UpdateResults(theStatus)
    End If

End Sub 'theInkAnalyzeMenuItem_Click

/// <summary>
/// The Ink menu's Analyze menu item's Click event handler.
/// </summary>
/// <param name="sender">The source of the event.</param>
/// <param name="e">The event data.</param>
private void theInkAnalyzeMenuItem_Click(object sender, EventArgs e)
{
    // Only start ink analysis if the dirty region is not empty.
    if (!this.theInkAnalyzer.DirtyRegion.IsEmpty)
    {
        // Attach an activity event handler.
        this.theInkAnalyzer.Activity +=
            new Microsoft.Ink.ActivityEventHandler(
            theInkAnalyzer_Activity);

        // Perform the ink analysis.
        Microsoft.Ink.AnalysisStatus theStatus =
            this.theInkAnalyzer.Analyze();

        // Remove the activity event handler.
        this.theInkAnalyzer.Activity -=
            new Microsoft.Ink.ActivityEventHandler(
                theInkAnalyzer_Activity);

        // Update the analysis results on the form.
        this.UpdateResults(theStatus);
    }
}