InkAnalyzer.DirtyRegion 속성

아티클
11/04/2008

업데이트: 2007년 11월

마지막 분석 작업 이후 변경된 영역을 가져옵니다.

네임스페이스: 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);
    }
}