InkAnalyzerBase.BackgroundAnalyze, méthode

Article
11/05/2008

Mise à jour : November 2007

Effectue l'analyse asynchrone de l'entrée manuscrite, 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.AnalysisCore
Assembly : IACore (dans IACore.dll)

Syntaxe

'Déclaration
Public Function BackgroundAnalyze As Boolean
'Utilisation
Dim instance As InkAnalyzerBase
Dim returnValue As Boolean

returnValue = instance.BackgroundAnalyze()

public bool BackgroundAnalyze()

public:
bool BackgroundAnalyze()

public boolean BackgroundAnalyze()

public function BackgroundAnalyze() : boolean

Valeur de retour

Type : System.Boolean
true si l'analyse asynchrone de l'écriture manuscrite a démarré ; sinon, false.

Notes

Lorsque cette méthode est appelée, le InkAnalyzerBase exécute l'analyse d'entrée manuscrite sur un thread d'arrière-plan. Le InkAnalyzerBase déclenche des événements générés par l'analyse d'arrière-plan sur le thread sur lequel le InkAnalyzerBase a été créé.

Remarque :
Pour la classe dérivée, InkAnalyzer, la propriété SynchronizingObject contrôle le thread sur lequel le InkAnalyzer déclenche des événements générés pendant l'analyse d'arrière-plan.

Cette méthode ne démarre pas de nouvelle analyse en arrière-plan dans les conditions suivantes.

L'analyseur d'entrée manuscrite effectue actuellement une analyse d'arrière-plan.
La propriété DirtyRegion représente une zone vide.

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.

Si des données de trait ont été ajoutées à l'analyseur d'entrée manuscrite après l'appel à la méthode BackgroundAnalyze, celui-ci peut mettre à jour la propriété DirtyRegion pendant la phase de rapprochement de l'analyse d'entrée manuscrite.

La valeur de la propriété AnalysisModes spécifie la manière dont l'analyseur d'entrée manuscrite effectue l'analyse d'arrière-plan. Pour plus d'informations sur l'analyse d'entrée manuscrite, consultez Ink Analysis Overview.

Cette méthode lève une exception dans les conditions suivantes.

L'indicateur AutomaticReconciliationEnabled de votre application est effacé dans la propriété AnalysisModes et l'application n'a pas ajouté de gestionnaire d'événements pour l'événement ReadyToReconcileBase.
Votre application n'a pas ajouté de gestionnaire d'événements pour l'événement IntermediateResultsUpdatedBase ou ResultsUpdatedBase.
Votre application n'a pas ajouté de gestionnaire d'événements pour l'événement UpdateStrokesCacheBase.

Remarque :

La classe dérivée, InkAnalyzer, ne lève aucune exception dans cette condition.

Remarque :
La classe dérivée, InkAnalyzer, ne lève aucune exception dans cette condition.

Exemples

Cet exemple lance l'analyse d'entrée manuscrite d'arrière-plan sur un InkAnalyzerBase, theInkAnalyzerBase, si une analyse d'entrée manuscrite n'est pas déjà en cours d'exécution.

If Not theInkAnalyzerBase.IsAnalyzing Then
    Dim started As Boolean = theInkAnalyzerBase.BackgroundAnalyze()
End If

if (!theInkAnalyzerBase.IsAnalyzing)
{
    bool started = theInkAnalyzerBase.BackgroundAnalyze();
}

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.