InkAnalyzer.DirtyRegion 屬性

發行項
10/29/2008

取得自上次執行分析作業以來已變更的區域。

命名空間： System.Windows.Ink
組件： IAWinFX (在 IAWinFX.dll 中)

語法

'宣告
Public ReadOnly Property DirtyRegion As AnalysisRegion
'用途
Dim instance As InkAnalyzer
Dim value As AnalysisRegion

value = instance.DirtyRegion

public AnalysisRegion DirtyRegion { get; }

public:
property AnalysisRegion^ DirtyRegion {
    AnalysisRegion^ get ();
}

/** @property */
public AnalysisRegion get_DirtyRegion()

public function get DirtyRegion () : AnalysisRegion

屬性值

型別：System.Windows.Ink.AnalysisRegion
自上次執行分析作業以來已變更的區域。

備註

這個屬性會識別需要分析或重新分析的區域。InkAnalyzer 方法會新增、移除或更新 DirtyRegion 的筆劃資料。若要手動標記需重新分析的區域，請使用 DirtyRegion 物件的 Union 方法。

如果呼叫 Analyze 或 BackgroundAnalyze() 方法，這些方法會分析 InkAnalyzer 之 DirtyRegion 中的筆劃。

這個屬性可能包含不相鄰的區域。

範例

這個範例會示範應用程式中使用者啟始的筆墨分析。事件處理常式 analyzeButton_Click 會處理使用者對分析結果的要求。事件處理常式只會在 InkAnalyzer 物件的 DirtyRegion 不是空白時執行分析。

Sub analyzeButton_Click(ByVal sender As Object, ByVal e As RoutedEventArgs) 

    ' Only start ink analysis if the dirty region is not empty.
    If Not Me.theInkAnalyzer.DirtyRegion.IsEmpty Then
        ' Perform the ink analysis.
        Dim theStatus As AnalysisStatus = Me.theInkAnalyzer.Analyze()

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

End Sub 'analyzeButton_Click

void analyzeButton_Click(object sender, RoutedEventArgs e)
{
    // Only start ink analysis if the dirty region is not empty.
    if (!this.theInkAnalyzer.DirtyRegion.IsEmpty)
    {
        // Perform the ink analysis.
        AnalysisStatus theStatus =
            this.theInkAnalyzer.Analyze();

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

}