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 : Microsoft.Ink
Assembly : Microsoft.Ink.Analysis (dans Microsoft.Ink.Analysis.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 : Microsoft.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. Toutes les méthodes InkAnalyzer qui ajoutent, suppriment ou mettent à jour des données de trait mettent à jour la propriété DirtyRegion. Pour marquer manuellement une zone pour réanalyse, utilisez la méthode Union de l'objet DirtyRegion.

Seule l'entrée manuscrite se trouvant dans la propriété DirtyRegion du InkAnalyzer est analysée pendant un appel à la méthode Analyze ou BackgroundAnalyze.

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

Exemples

Cet exemple montre une analyse d'entrée manuscrite initialisée par utilisateur dans une application de formulaire. Un gestionnaire d'événements, theInkAnalyzeMenuItem_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.

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

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.