InkAnalyzerBase.DirtyRegion プロパティ

2008-10-28

最後の分析処理以降に変更された領域を取得します。このプロパティを使用して、この領域を手動で変更することもできます。

名前空間 : System.Windows.Ink.AnalysisCore
アセンブリ : IACore (IACore.dll 内)

構文

'宣言
Public ReadOnly Property DirtyRegion As AnalysisRegionBase
'使用
Dim instance As InkAnalyzerBase
Dim value As AnalysisRegionBase

value = instance.DirtyRegion

public AnalysisRegionBase DirtyRegion { get; }

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

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

public function get DirtyRegion () : AnalysisRegionBase

プロパティ値

型 : System.Windows.Ink.AnalysisCore.AnalysisRegionBase
最後の分析処理以降に変更された領域。

解説

このプロパティは、分析または再分析する必要がある領域を識別します。ストロークデータを追加、削除、または更新する InkAnalyzerBase メソッドはすべて、DirtyRegion プロパティも更新します。分析用の領域を手動でマークするには、DirtyRegion オブジェクトの Union メソッドを使用します。

InkAnalyzerBase は、Analyze または BackgroundAnalyze の呼び出し時に、その DirtyRegion 内でインクを分析します。ただし、インクアナライザは分析処理を拡張して、隣接する領域を含めることができます。

このプロパティには、隣接していない領域が含まれることがあります。

例

この例では、アナライザの DirtyRegion が空でない場合、InkAnalyzerBase、theInkAnalyzerBase でインク分析を実行します。

' Only start ink analysis if the dirty region is not empty.
Dim theStatus As System.Windows.Ink.AnalysisCore.AnalysisStatusBase = Nothing
If Not theInkAnalyzerBase.DirtyRegion.IsEmpty Then

    ' Perform the ink analysis.
    theStatus = theInkAnalyzerBase.Analyze()

End If

// Only start ink analysis if the dirty region is not empty.
System.Windows.Ink.AnalysisCore.AnalysisStatusBase theStatus = null;
if (!theInkAnalyzerBase.DirtyRegion.IsEmpty)
{
    // Perform the ink analysis.
    theStatus = theInkAnalyzerBase.Analyze();
}