InkAnalyzer.Analyze (Método)

Artículo
11/26/2008

Actualización: noviembre 2007

Realiza un análisis sincrónico de la entrada manuscrita.

Espacio de nombres: Microsoft.Ink
Ensamblado: Microsoft.Ink.Analysis (en Microsoft.Ink.Analysis.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: Microsoft.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 termina una vez que finaliza la operación de análisis. El objeto InkAnalyzer analiza sólo la entrada manuscrita incluida en su propiedad DirtyRegion.

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

El objeto InkAnalyzer no provoca los eventos IntermediateResultsUpdated y ResultsUpdated en 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 de un evento de clic de un elemento de menú. El controlador de eventos realiza el análisis sincrónico de la entrada manuscrita si la propiedad DirtyRegion del objeto InkAnalyzer no está vacía. Asocia un controlador de eventos InkAnalyzer.Activity y realiza el análisis. A continuación, quita el controlador de eventos y llama a un método de aplicación auxiliar, UpdateResults, para actualizar el formulario con los resultados del análisis.

''' <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 Sub theInkAnalyzeMenuItem_Click( _
    ByVal sender As Object, ByVal e As EventArgs) _
    Handles theInkAnalyzeMenuItem.Click

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

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

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

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