InkAnalyzer.Analyze (Método)

Artículo
11/26/2008

Actualización: noviembre 2007

Realiza el análisis sincrónico de la entrada manuscrita, que incluye el análisis del diseño, la clasificación de la escritura y del dibujo y el reconocimiento de la escritura a mano.

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

Sintaxis

'Declaración
Public Function Analyze As AnalysisStatus
'Uso
Dim instance As InkAnalyzer
Dim returnValue As AnalysisStatus

returnValue = instance.Analyze()

public AnalysisStatus Analyze()

public:
AnalysisStatus^ Analyze()

public AnalysisStatus Analyze()

public function Analyze() : AnalysisStatus

Valor devuelto

Tipo: System.Windows.Ink.AnalysisStatus
Estado de la operación de análisis.

Comentarios

Este método inicia una operación de análisis sincrónico de la entrada manuscrita. El análisis de la entrada manuscrita incluye el análisis del diseño, la clasificación de la escritura y el dibujo y el reconocimiento de la escritura a mano. La operación devuelve un valor de estado una vez completado el análisis. InkAnalyzer analiza sólo la entrada manuscrita que se encuentra en DirtyRegion.

Este método establece la propiedad DirtyRegion del objeto InkAnalyzer en una región vacía. Si otro subproceso agrega datos de trazos que no se han analizado todavía, el objeto InkAnalyzer agrega el cuadro de límite de los trazos no analizados a su propiedad DirtyRegion durante la fase de conciliación del análisis.

El objeto InkAnalyzer no provoca eventos IntermediateResults() y Results() como respuesta a este método.

Para modificar la manera en que se realiza el análisis de la entrada manuscrita, utilice la propiedad AnalysisModes del objeto InkAnalyzer.

Para obtener más información sobre el análisis de entrada manuscrita, vea Ink Analysis Overview.

Ejemplos

En este ejemplo, se define un controlador de eventos para el evento de clic de un botón. El controlador de eventos realiza el análisis sincrónico de la entrada manuscrita, pero sólo si la propiedad DirtyRegion del objeto InkAnalyzer no está vacía. Se asocia un controlador de eventos InkAnalyzer.Activity y se realiza el análisis. A continuación, se quita el controlador de eventos y se llama a un método auxiliar, denominado UpdateResults, para actualizar el formulario con los resultados del análisis.

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

        ' Attach an activity event handler.
        AddHandler Me.theInkAnalyzer.Activity, AddressOf theInkAnalyzer_Activity

        ' Perform the ink analysis.
        Dim theStatus As AnalysisStatus = Me.theInkAnalyzer.Analyze()

        ' Remove the activity event handler.
        RemoveHandler Me.theInkAnalyzer.Activity, AddressOf theInkAnalyzer_Activity

        ' 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)
    {
        // Attach an activity event handler.
        this.theInkAnalyzer.Activity +=
            new ActivityEventHandler(
            theInkAnalyzer_Activity);

        // Perform the ink analysis.
        AnalysisStatus theStatus =
            this.theInkAnalyzer.Analyze();

        // Remove the activity event handler.
        this.theInkAnalyzer.Activity -=
            new ActivityEventHandler(
                theInkAnalyzer_Activity);

        // 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.