InkAnalyzer.Analyze, méthode

Article
11/05/2008

Mise à jour : November 2007

Exécute l'analyse synchrone de l'entrée manuscrite.

Espace de noms : Microsoft.Ink
Assembly : Microsoft.Ink.Analysis (dans Microsoft.Ink.Analysis.dll)

Syntaxe

'Déclaration
Public Function Analyze As AnalysisStatus
'Utilisation
Dim instance As InkAnalyzer
Dim returnValue As AnalysisStatus

returnValue = instance.Analyze()

public AnalysisStatus Analyze()

public:
AnalysisStatus^ Analyze()

public AnalysisStatus Analyze()

public function Analyze() : AnalysisStatus

Valeur de retour

Type : Microsoft.Ink.AnalysisStatus
État de l'analyse.

Notes

Cette méthode démarre une analyse synchrone de l'entrée manuscrite. L'analyse d'entrée manuscrite inclut l'analyse de disposition, la classification de l'écriture et du dessin et la reconnaissance de l'écriture manuscrite. L'opération est retournée une fois l'opération d'analyse terminée. InkAnalyzer analyse l'entrée manuscrite uniquement dans sa propriété DirtyRegion.

Cette méthode affecte une région vide à la propriété DirtyRegion de l'objet InkAnalyzer. Si un autre thread a ajouté des données de trait qui n'ont pas été analysées, le InkAnalyzer ajoute le cadre englobant des traits non analysés à sa propriété DirtyRegion pendant la phase de rapprochement de l'analyse.

InkAnalyzer ne déclenche pas les événements ResultsUpdated et IntermediateResultsUpdated en réponse à cette méthode.

Pour modifier la manière dont l'entrée manuscrite est analysée, utilisez la propriété AnalysisModes de l'objet InkAnalyzer.

Pour plus d'informations sur l'analyse d'entrée manuscrite, consultez Ink Analysis Overview.

Exemples

Cet exemple définit un gestionnaire d'événements pour l'événement Click d'un élément de menu. Le gestionnaire d'événements exécute l'analyse synchrone de l'entrée manuscrite si la propriété DirtyRegion de l'objet InkAnalyzer n'est pas vide. Il attache un gestionnaire d'événements InkAnalyzer.Activity et exécute l'analyse. Il supprime ensuite le gestionnaire d'événements et appelle une méthode d'assistance, UpdateResults, pour mettre à jour le formulaire à l'aide des résultats de l'analyse.

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

Plateformes

Windows Vista

Le .NET Framework et le .NET Compact Framework ne prennent pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.