InkAnalyzer.DirtyRegion プロパティ

2008-10-28

最後の分析処理以降に変更された領域を取得します。

名前空間 : 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();
    }

}