This documentation is archived and is not being maintained.

InkAnalyzer.DirtyRegion Property

Gets the area that has changed since the last analysis operation.

Namespace: System.Windows.Ink
Assembly: IAWinFX (in iawinfx.dll)
XML Namespace:

public AnalysisRegion DirtyRegion { get; }
/** @property */
public AnalysisRegion get_DirtyRegion ()

public function get DirtyRegion () : AnalysisRegion

Not applicable.

Property Value

The area that has changed since the last analysis operation.

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

During a call, the Analyze or BackgroundAnalyze methods analyze ink within the DirtyRegion of the InkAnalyzer.

This property may contain nonadjacent areas.

This example demonstrates user-initiated ink analysis within an application. An event handler, analyzeButton_Click, handles the user request for analysis results. The event handler performs analysis only if the InkAnalyzer object's DirtyRegion is not empty.

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 =

        // Update the analysis results on the form.


Windows 98, Windows Server 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.

.NET Framework

Supported in: 3.0


InkAnalyzer Class
InkAnalyzer Members
System.Windows.Ink Namespace