AnalysisStatus.AppliedChangesRegion Property

Article
12/12/2007

Returns the region of the document where the InkAnalyzer has changed the ContextNode tree

Namespace: System.Windows.Ink
Assembly: IAWinFX (in iawinfx.dll)
XML Namespace: https://schemas.microsoft.com/winfx/2006/xaml/presentation

Syntax

'Declaration
Public ReadOnly Property AppliedChangesRegion As AnalysisRegion
'Usage
Dim instance As AnalysisStatus
Dim value As AnalysisRegion

value = instance.AppliedChangesRegion

public AnalysisRegion AppliedChangesRegion { get; }

public:
property AnalysisRegion^ AppliedChangesRegion {
    AnalysisRegion^ get ();
}

/** @property */
public AnalysisRegion get_AppliedChangesRegion ()

public function get AppliedChangesRegion () : AnalysisRegion

Not applicable.

Property Value

The AnalysisRegion of the document where changes were updated.

Remarks

AppliedChangesRegion is used when the application must locate the area that changed. For example, the application might draw a special tag to click for the user to modify the analysis results.

Example

The following example is a ResultsUpdated event handler that is called when BackgroundAnalyze completes analysis. In the event handler, a Rectangle that represents the AppliedChangesRegion is drawn on an InkCanvas, theInkCanvas.

Sub theInkAnalyzer_ResultsUpdated(ByVal sender As Object, _
                                  ByVal e As ResultsUpdatedEventArgs)

    Dim status As AnalysisStatus = e.Status

    ' Draw a rectangle around the changed region.
    If status.Successful Then

        Dim bounds As Rect = status.AppliedChangesRegion.GetBounds()
        Dim box As Rectangle = New Rectangle()

        box.Width = bounds.Width
        box.Height = bounds.Height
        InkCanvas.SetTop(box, bounds.Top)
        InkCanvas.SetLeft(box, bounds.Left)

        box.Stroke = Brushes.Black
        theInkCanvas.Children.Add(box)
    End If

End Sub 'theInkAnalyzer_ResultsUpdated

void theInkAnalyzer_ResultsUpdated(object sender, ResultsUpdatedEventArgs e)
{
    AnalysisStatus status = e.Status;

    // Draw a rectangle around the changed region.
    if (status.Successful)
    {
        Rect bounds = status.AppliedChangesRegion.GetBounds();
        Rectangle box = new Rectangle();

        box.Width = bounds.Width;
        box.Height = bounds.Height;
        InkCanvas.SetTop(box, bounds.Top);
        InkCanvas.SetLeft(box, bounds.Left);
        
        box.Stroke = Brushes.Black;
        theInkCanvas.Children.Add(box);
    }

}

Platforms

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.

Version Information

.NET Framework

Supported in: 3.0

Share via