Proprietà InkAnalyzer.DirtyRegion

Articolo
10/29/2008

Aggiornamento: novembre 2007

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

Spazio dei nomi: Microsoft.Ink
Assembly: Microsoft.Ink.Analysis (in Microsoft.Ink.Analysis.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: Microsoft.Ink.AnalysisRegion
Area che è stata modificata dall'ultima operazione di analisi.

Note

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

Solo l'input penna nella proprietà DirtyRegion dell'oggetto InkAnalyzer viene analizzato durante una chiamata al metodo Analyze o BackgroundAnalyze.

Questa proprietà può contenere aree non adiacenti.

Esempi

In questo esempio viene illustrata l'analisi dell'input penna avviata dall'utente nell'applicazione form. Un gestore eventi, theInkAnalyzeMenuItem_Click, gestisce la richiesta dell'utente per i risultati dell'analisi. Il gestore eventi esegue l'analisi solo se la proprietà DirtyRegion dell'oggetto InkAnalyzer non è vuota.

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

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.