Share via


InkAnalyzerBase.DirtyRegion Property

Gets the area that has changed since the last analysis operation. You can also use this property to manually modify this region.

Namespace:  System.Windows.Ink.AnalysisCore
Assembly:  IACore (in IACore.dll)

Syntax

'Declaration
Public ReadOnly Property DirtyRegion As AnalysisRegionBase
'Usage
Dim instance As InkAnalyzerBase 
Dim value As AnalysisRegionBase 

value = instance.DirtyRegion
public AnalysisRegionBase DirtyRegion { get; }
public:
property AnalysisRegionBase^ DirtyRegion {
    AnalysisRegionBase^ get ();
}
public function get DirtyRegion () : AnalysisRegionBase

Property Value

Type: System.Windows.Ink.AnalysisCore.AnalysisRegionBase
The area that has changed since the last analysis operation.

Remarks

This property identifies the areas that need to be analyzed or reanalyzed. All of the InkAnalyzerBase methods that add, remove, or update stroke data also update the DirtyRegion property. To manually mark an area for reanalysis, use the DirtyRegion object's Union method.

The InkAnalyzerBase analyzes ink within its DirtyRegion during a call to Analyze or BackgroundAnalyze. However, the ink analyzer may expand the analysis operation to include neighboring regions.

This property may contain nonadjacent areas.

Examples

This example performs ink analysis on an InkAnalyzerBase, theInkAnalyzerBase, if the analyzer's DirtyRegion is not empty.

' 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();
}

Platforms

Windows 7, Windows Vista, Windows XP SP2, Windows Server 2008 R2, Windows Server 2008, Windows Server 2003

The .NET Framework and .NET Compact Framework do not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Version Information

.NET Framework

Supported in: 3.0

See Also

Reference

InkAnalyzerBase Class

InkAnalyzerBase Members

System.Windows.Ink.AnalysisCore Namespace

InkAnalyzerBase.Analyze

InkAnalyzerBase.BackgroundAnalyze

InkAnalyzerBase.AddStroke

InkAnalyzerBase.AddStrokes

InkAnalyzerBase.RemoveStroke

InkAnalyzerBase.RemoveStrokes