Proprietà InkAnalyzer.DirtyRegion

Articolo
10/29/2008

Aggiornamento: novembre 2007

Ottiene l'area che è stata modificata dall'ultima operazione di analisi.

Spazio dei nomi: System.Windows.Ink
Assembly: IAWinFX (in IAWinFX.dll)

Sintassi

'Dichiarazione
Public ReadOnly Property DirtyRegion As AnalysisRegion
'Utilizzo
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

Valore proprietà

Tipo: System.Windows.Ink.AnalysisRegion
Area che è stata modificata dall'ultima operazione di analisi.

Note

Questa proprietà identifica le aree che devono essere analizzate o rianalizzate. I metodi di InkAnalyzer aggiungono, rimuovono o aggiornano i dati del tratto per l'oggetto DirtyRegion. Per contrassegnare manualmente un'area per una nuova analisi, utilizzare il metodo Union dell'oggetto DirtyRegion.

Se chiamati, i metodi Analyze o BackgroundAnalyze() analizzano l'input penna all'interno dell'oggetto DirtyRegion di InkAnalyzer.

Questa proprietà può contenere aree non adiacenti.

Esempi

In questo esempio viene illustrata l'analisi dell'input penna avviata dall'utente all'interno di un'applicazione. Un gestore eventi, analyzeButton_Click, gestisce la richiesta dell'utente per i risultati dell'analisi. Il gestore eventi esegue l'analisi solo se l'oggetto DirtyRegion dell'oggetto InkAnalyzer non è vuoto.

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

}

Piattaforme

Windows Vista

.NET Framework e .NET Compact Framework non supportano tutte le versioni di ciascuna piattaforma. Per un elenco delle versioni supportate, vedere Requisiti di sistema di .NET Framework.