InkAnalyzerBase.Analyze, méthode

Article
11/05/2008

Mise à jour : November 2007

Effectue l'analyse synchrone de l'entrée manuscrite.

Espace de noms : System.Windows.Ink.AnalysisCore
Assembly : IACore (dans IACore.dll)

Syntaxe

'Déclaration
Public Function Analyze As AnalysisStatusBase
'Utilisation
Dim instance As InkAnalyzerBase
Dim returnValue As AnalysisStatusBase

returnValue = instance.Analyze()

public AnalysisStatusBase Analyze()

public:
AnalysisStatusBase^ Analyze()

public AnalysisStatusBase Analyze()

public function Analyze() : AnalysisStatusBase

Valeur de retour

Type : System.Windows.Ink.AnalysisCore.AnalysisStatusBase
É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. Cette méthode est retournée une fois l'opération d'analyse terminée.

Le InkAnalyzerBase analyse l'entrée manuscrite dans sa propriété DirtyRegion pendant un appel à Analyze ou BackgroundAnalyze. Toutefois, l'analyseur d'entrée manuscrite peut étendre l'analyse aux régions avoisinantes.

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

Cette méthode lève une exception lorsque votre application n'a pas ajouté de gestionnaire d'événements pour l'événement UpdateStrokesCacheBase.

Le InkAnalyzerBase ne déclenche pas les événements ResultsUpdatedBase et IntermediateResultsUpdatedBase en réponse à cette méthode.

Pour modifier le mode d'exécution de l'analyse d'entrée manuscrite, utilisez la propriété AnalysisModes.

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

Exemples

Cet exemple effectue l'analyse d'entrée manuscrite sur un InkAnalyzerBase, theInkAnalyzerBase, si la propriété DirtyRegion de l'analyseur n'est pas vide.

' Only start ink analysis if the dirty region is not empty.
Dim theStatus As System.Windows.Ink.AnalysisCore.AnalysisStatusBase = Nothing
If Not theInkAnalyzerBase.DirtyRegion.IsEmpty Then

    ' Perform the ink analysis.
    theStatus = theInkAnalyzerBase.Analyze()

End If

// Only start ink analysis if the dirty region is not empty.
System.Windows.Ink.AnalysisCore.AnalysisStatusBase theStatus = null;
if (!theInkAnalyzerBase.DirtyRegion.IsEmpty)
{
    // Perform the ink analysis.
    theStatus = theInkAnalyzerBase.Analyze();
}

Plateformes

Windows Vista, Windows XP SP2, Windows Server 2003

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.