InkAnalyzer.DirtyRegion プロパティ

[アーティクル]
10/28/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);
    }
}