InkAnalyzer.DirtyRegion-Eigenschaft

Artikel
11/26/2008

Ruft den Bereich ab, der seit dem letzten Analysevorgang geändert wurde.

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

Syntax

'Declaration
Public ReadOnly Property DirtyRegion As AnalysisRegion
'Usage
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

Eigenschaftenwert

Typ: System.Windows.Ink.AnalysisRegion
Der Bereich, der seit dem letzten Analysevorgang geändert wurde.

Hinweise

Diese Eigenschaft identifiziert alle Bereiche, die analysiert bzw. neu analysiert werden müssen. InkAnalyzer-Methoden zum Hinzufügen, Entfernen oder Aktualisieren von Strichdaten für DirtyRegion. Verwenden Sie die Union-Methode des DirtyRegion-Objekts, um einen Bereich manuell zur erneuten Analyse zu markieren.

Wenn sie aufgerufen werden, analysieren die Methoden Analyze oder BackgroundAnalyze() Freihandeingaben innerhalb der DirtyRegion des InkAnalyzer.

Diese Eigenschaft enthält möglicherweise nicht benachbarte Bereiche.

Beispiele

In diesem Beispiel wird eine vom Benutzer initiierte Freihandanalyse in einer Anwendung veranschaulicht. Ein Ereignishandler, analyzeButton_Click, verarbeitet die Benutzeranforderung für Analyseergebnisse. Der Ereignishandler führt die Analyse nur aus, wenn DirtyRegion für das InkAnalyzer-Objekt nicht leer ist.

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

}

Plattformen

Windows Vista

.NET Framework und .NET Compact Framework unterstützen nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.