InkAnalyzer.Analyze-Methode

Artikel
10/28/2008

Führt eine synchrone Freihandanalyse durch; diese umfasst die Layoutanalyse, die Schrift- und Zeichnungsklassifizierung und die Handschrifterkennung.

Namespace: System.Windows.Ink
Assembly: IAWinFX (in IAWinFX.dll)

Syntax

'Declaration
Public Function Analyze As AnalysisStatus
'Usage
Dim instance As InkAnalyzer
Dim returnValue As AnalysisStatus

returnValue = instance.Analyze()

public AnalysisStatus Analyze()

public:
AnalysisStatus^ Analyze()

public AnalysisStatus Analyze()

public function Analyze() : AnalysisStatus

Rückgabewert

Typ: System.Windows.Ink.AnalysisStatus
Der Status des Analysevorgangs..

Hinweise

Diese Methode startet eine synchrone Freihandanalyse. Die Freihandanalyse umfasst die Layoutanalyse, die Schrift- und Zeichnungsklassifizierung und die Handschrifterkennung. Der Vorgang gibt einen Statuswert zurück, sobald die Analyse abgeschlossen wurde. Der InkAnalyzer analysiert nur die Freihandeingaben, die im Bereich der DirtyRegion stehen.

Diese Methode legt die DirtyRegion des InkAnalyzer-Objekts auf einen leeren Bereich fest. Wenn ein anderer Thread Strichdaten hinzufügt, die noch nicht analysiert wurden, fügt InkAnalyzer das umgebende Feld der nicht analysierten Striche während der Abgleichsphase der Analyse seiner DirtyRegion hinzu.

Der InkAnalyzer löst die Ereignisse Results() und IntermediateResults() nicht als Reaktion auf diese Methode aus.

Verwenden Sie die AnalysisModes-Eigenschaft des InkAnalyzer-Objekts, um die Art der Ausführung einer Freihandanalyse zu ändern.

Weitere Informationen zur Freihandanalyse finden Sie unter Ink Analysis Overview.

Beispiele

Im folgenden Beispiel wird ein Ereignishandler für das Click-Ereignis einer Schaltfläche definiert. Der Ereignishandler führt eine synchrone Freihandanalyse aus, jedoch wenn DirtyRegion für das InkAnalyzer-Objekt nicht leer ist. Er fügt einen InkAnalyzer.Activity-Ereignishandler an und führt die Analyse aus. Dann entfernt er den Ereignishandler und ruft eine Hilfsmethode namens UpdateResults auf, um das Formular mit den Analyseergebnissen zu aktualisieren.

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

Plattformen

Windows Vista

.NET Framework und .NET Compact Framework unterstützen nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.