InkAnalyzer.DirtyRegion-Eigenschaft
Ruft den Bereich ab, der seit dem letzten Analysevorgang geändert wurde.
Namespace: Microsoft.Ink
Assembly: Microsoft.Ink.Analysis (in Microsoft.Ink.Analysis.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: Microsoft.Ink.AnalysisRegion
Der Bereich, der seit dem letzten Analysevorgang geändert wurde.
Hinweise
Diese Eigenschaft identifiziert die Bereiche, die analysiert oder neu analysiert werden müssen. Alle InkAnalyzer-Methoden, die Strichdaten entfernen, hinzufügen oder aktualisieren, aktualisieren auch DirtyRegion. Verwenden Sie die Union-Methode des DirtyRegion-Objekts, um einen Bereich manuell zur erneuten Analyse zu markieren.
Nur Freihanddaten innerhalb des DirtyRegion-Bereichs von InkAnalyzer werden während eines Aufrufs der Analyze-Methode oder BackgroundAnalyze-Methode analysiert.
Diese Eigenschaft enthält möglicherweise nicht benachbarte Bereiche.
Beispiele
In diesem Beispiel wird eine vom Benutzer initiierte Freihandanalyse in einer Formularanwendung veranschaulicht. Ein Ereignishandler, theInkAnalyzeMenuItem_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.
''' <summary>
''' The Analyze menu item's Click event handler.
''' </summary>
''' <param name="sender">The source of the event.</param>
''' <param name="e">The event data.</param>
Private Sub theInkAnalyzeMenuItem_Click( _
ByVal sender As System.Object, ByVal e As System.EventArgs) _
Handles theInkAnalyzeMenuItem.Click
' 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 Microsoft.Ink.AnalysisStatus = _
Me.theInkAnalyzer.Analyze()
' Update the analysis results on the form.
Me.UpdateResults(theStatus)
End If
End Sub 'theInkAnalyzeMenuItem_Click
/// <summary>
/// The Ink menu's Analyze menu item's Click event handler.
/// </summary>
/// <param name="sender">The source of the event.</param>
/// <param name="e">The event data.</param>
private void theInkAnalyzeMenuItem_Click(object sender, EventArgs e)
{
// Only start ink analysis if the dirty region is not empty.
if (!this.theInkAnalyzer.DirtyRegion.IsEmpty)
{
// Perform the ink analysis.
Microsoft.Ink.AnalysisStatus theStatus =
this.theInkAnalyzer.Analyze();
// Update the analysis results on the form.
this.UpdateResults(theStatus);
}
}
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.
Versionsinformationen
.NET Framework
Unterstützt in: 3.0