InkAnalyzer.Analyze, méthode

Article
11/05/2008

Mise à jour : November 2007

Effectue l'analyse d'entrée manuscrite synchrone, qui inclut l'analyse de la disposition, la classification de l'écriture et du dessin et la reconnaissance de l'écriture manuscrite.

Espace de noms : System.Windows.Ink
Assembly : IAWinFX (dans IAWinFX.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 : System.Windows.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 retourne une valeur d'état à la fin de l'analyse. InkAnalyzer analyse uniquement l'entrée manuscrite qui se trouve 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 ajoute 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 Results() et IntermediateResults() 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 bouton. Le gestionnaire d'événements exécute l'analyse d'entrée manuscrite synchrone seulement 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 nommée UpdateResults pour mettre à jour le formulaire à l'aide des résultats de l'analyse.

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

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.