Metodo InkAnalyzer.Analyze

Articolo
10/29/2008

Aggiornamento: novembre 2007

Esegue l'analisi dell'input penna sincrona.

Spazio dei nomi: Microsoft.Ink
Assembly: Microsoft.Ink.Analysis (in Microsoft.Ink.Analysis.dll)

Sintassi

'Dichiarazione
Public Function Analyze As AnalysisStatus
'Utilizzo
Dim instance As InkAnalyzer
Dim returnValue As AnalysisStatus

returnValue = instance.Analyze()

public AnalysisStatus Analyze()

public:
AnalysisStatus^ Analyze()

public AnalysisStatus Analyze()

public function Analyze() : AnalysisStatus

Valore restituito

Tipo: Microsoft.Ink.AnalysisStatus
Stato dell'operazione di analisi.

Note

Questo metodo avvia un'operazione di analisi sincrona dell'input penna. L'analisi dell'input penna include l'analisi del layout, la classificazione della scrittura e del disegno e il riconoscimento della grafia. L'operazione restituisce i risultati una volta completata l'analisi. L'oggetto InkAnalyzer analizza l'input penna solo nel relativo oggetto DirtyRegion.

Questo metodo imposta la proprietà DirtyRegion dell'oggetto InkAnalyzer su un'area vuota. Se un altro thread ha aggiunto i dati del tratto che non sono stati analizzati, l'oggettoInkAnalyzer aggiunge il riquadro dei tratti non analizzati al relativo oggetto DirtyRegion durante la fase di risoluzione delle differenze dell'analisi.

L'oggetto InkAnalyzer non genera gli eventi ResultsUpdated e IntermediateResultsUpdated in risposta a questo metodo.

Per modificare la modalità di esecuzione dell'analisi dell'input penna, utilizzare la proprietà AnalysisModes dell'oggetto InkAnalyzer.

Per ulteriori informazioni sull'analisi dell'input penna, vedere Ink Analysis Overview.

Esempi

In questo esempio viene definito un gestore eventi per l'evento Click di una voce di menu. Il gestore eventi esegue l'analisi sincrona dell'input penna se la proprietà DirtyRegion dell'oggetto InkAnalyzer non è vuota. Associa un gestore eventi InkAnalyzer.Activity ed esegue l'analisi. Quindi rimuove il gestore eventi e chiama un metodo di supporto, UpdateResults, per aggiornare il form con i risultati dell'analisi.

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

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.