Metodo InkAnalyzer.Analyze

Articolo
10/29/2008

Aggiornamento: novembre 2007

Esegue l'analisi sincrona dell'input penna che include l'analisi del layout, la classificazione del disegno e della scrittura e il riconoscimento della grafia.

Spazio dei nomi: System.Windows.Ink
Assembly: IAWinFX (in IAWinFX.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: System.Windows.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 del disegno e della scrittura e il riconoscimento della grafia. Una volta completata l'analisi, l'operazione restituisce il valore dello stato. InkAnalyzer analizza solo l'input penna posizionato all'interno dell'oggetto DirtyRegion.

Questo metodo imposta l'oggetto DirtyRegion dell'oggetto InkAnalyzer su un'area vuota. Se un altro thread aggiunge i dati di un tratto non ancora analizzato, InkAnalyzer aggiunge il riquadro dei tratti non analizzati all'oggetto DirtyRegion durante la fase di risoluzione delle differenze dell'analisi.

InkAnalyzer non genera eventi Results() e IntermediateResults() 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 per l'evento Click di un pulsante. Il gestore eventi esegue l'analisi sincrona dell'input penna, ma solo se l'oggetto DirtyRegion dell'oggetto InkAnalyzer non è vuoto. Associa un gestore per l'evento InkAnalyzer.Activity ed esegue l'analisi. Quindi, rimuove il gestore eventi e chiama un metodo di supporto, denominato UpdateResults, per aggiornare il form con i risultati dell'analisi.

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

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.