InkAnalyzer.DirtyRegion, propriété

Article
11/05/2008

Mise à jour : November 2007

Obtient la zone modifiée depuis la dernière analyse.

Espace de noms : System.Windows.Ink
Assembly : IAWinFX (dans IAWinFX.dll)

Syntaxe

'Déclaration
Public ReadOnly Property DirtyRegion As AnalysisRegion
'Utilisation
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

Valeur de propriété

Type : System.Windows.Ink.AnalysisRegion
Zone qui a changé depuis la dernière analyse.

Notes

Cette propriété identifie les zones qui doivent être analysées ou réanalysées. Les méthodes InkAnalyzer ajoutent, suppriment ou mettent à jour les données de trait pour la propriété DirtyRegion. Pour marquer manuellement une zone pour réanalyse, utilisez la méthode Union de l'objet DirtyRegion.

Si elles sont appelées, les méthodes Analyze ou BackgroundAnalyze() analysent l'entrée manuscrite dans la propriété DirtyRegion de InkAnalyzer.

Cette propriété peut contenir des zones non adjacentes.

Exemples

Cet exemple montre une analyse d'entrée manuscrite lancée par l'utilisateur dans une application. Un gestionnaire d'événements, analyzeButton_Click, gère la demande des résultats d'analyse par un utilisateur. Le gestionnaire d'événements exécute l'analyse uniquement si la propriété DirtyRegion de l'objet InkAnalyzer n'est pas vide.

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

}

Plateformes

Windows Vista

Le .NET Framework et le .NET Compact Framework ne prennent pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.