InkAnalyzer.DirtyRegion (Propiedad)
Actualización: noviembre 2007
Obtiene el área que ha cambiado desde la última operación de análisis.
Espacio de nombres: Microsoft.Ink
Ensamblado: Microsoft.Ink.Analysis (en Microsoft.Ink.Analysis.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: Microsoft.Ink.AnalysisRegion
Área que ha cambiado desde la última operación de análisis.
Comentarios
Esta propiedad identifica las áreas que se deben analizar o volver a analizar Todos los métodos InkAnalyzer que agregan, quitan o actualizan datos de trazo actualizan la propiedad DirtyRegion. Para marcar manualmente una área para volver a analizarla, utilice el método Union del objeto DirtyRegion.
Sólo se analiza la entrada manuscrita incluida en la propiedad DirtyRegion del objeto InkAnalyzer durante una llamada al método BackgroundAnalyze o Analyze.
Esta propiedad puede contener áreas no adyacentes.
Ejemplos
En este ejemplo se muestra el análisis de entrada manuscrita iniciado por un usuario dentro de una aplicación de formulario. Un controlador de eventos, theInkAnalyzeMenuItem_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.
''' <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);
}
}
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.
Información de versión
.NET Framework
Compatible con: 3.0