InkAnalyzer.DirtyRegion (Propiedad)

Artículo
10/28/2008

Actualización: noviembre 2007

Obtiene el área que ha cambiado desde la última operación de análisis.

Espacio de nombres: System.Windows.Ink
Ensamblado: IAWinFX (en IAWinFX.dll)

Sintaxis

'Declaración
Public ReadOnly Property DirtyRegion As AnalysisRegion
'Uso
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

Valor de propiedad

Tipo: System.Windows.Ink.AnalysisRegion
Área que ha cambiado desde la última operación de análisis.

Comentarios

Esta propiedad identifica las áreas que necesitan analizarse o volver a analizarse. Los métodos de InkAnalyzer agregan, quitan o actualizan los datos de trazo de DirtyRegion. Para marcar manualmente una área para volver a analizarla, utilice el método Union del objeto DirtyRegion.

Si se llama, el método BackgroundAnalyze() o Analyze analiza la entrada manuscrita en DirtyRegion de InkAnalyzer.

Esta propiedad puede contener áreas no adyacentes.

Ejemplos

En este ejemplo, se muestra el análisis de entrada manuscrita iniciado por el usuario dentro de una aplicación. Un controlador de eventos, analyzeButton_Click, administra la solicitud del usuario para los resultados de análisis. El controlador de eventos sólo realiza el análisis si la propiedad DirtyRegion del objeto InkAnalyzer no está vacía.

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

}

Plataformas

Windows Vista

.NET Framework y .NET Compact Framework no admiten todas las versiones de cada plataforma. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.