InkAnalyzer.DirtyRegion 属性

项目
11/04/2008

获取自上一次分析操作以来更改的区域。

命名空间： Microsoft.Ink
程序集： Microsoft.Ink.Analysis（在 Microsoft.Ink.Analysis.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

属性值

类型：Microsoft.Ink.AnalysisRegion
自上一次分析操作以来更改的区域。

备注

此属性标识需要分析或重新分析的区域。所有添加、移除或更新笔画数据的 InkAnalyzer 方法都更新 DirtyRegion。若要手动标记需要重新分析的区域，请使用 DirtyRegion 对象的 Union 方法。

在调用 Analyze 或 BackgroundAnalyze 方法的过程中只分析 InkAnalyzer 的 DirtyRegion 中的墨迹。

此属性可包含不相邻的区域。

示例

此示例演示窗体应用程序中由用户启动的墨迹分析。事件处理程序 theInkAnalyzeMenuItem_Click 处理用户对分析结果的请求。仅当 InkAnalyzer 对象的 DirtyRegion 不为空时，该事件处理程序才执行分析。

''' <summary>
''' The 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 System.Object, ByVal e As System.EventArgs) _
    Handles theInkAnalyzeMenuItem.Click

    ' 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 Microsoft.Ink.AnalysisStatus = _
            Me.theInkAnalyzer.Analyze()

        ' 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)
    {
        // Perform the ink analysis.
        Microsoft.Ink.AnalysisStatus theStatus =
            this.theInkAnalyzer.Analyze();

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