InkAnalyzer.BackgroundAnalyze, méthode
Mise à jour : November 2007
Effectue l'analyse d'entrée manuscrite asynchrone, 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 BackgroundAnalyze As Boolean
'Utilisation
Dim instance As InkAnalyzer
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 InkAnalyzer exécute l'analyse d'entrée manuscrite sur un thread d'arrière-plan. InkAnalyzer déclenche des événements générés par l'analyse d'entrée manuscrite sur le même thread que celui utilisé pour créer la propriété SynchronizingObject. Si la propriété InkAnalyzer.SynchronizingObject a la valeur nullune référence null (Nothing en Visual Basic), le InkAnalyzer déclenche également ces événements sur un thread d'arrière-plan.
La propriété SynchronizingObject contrôle le thread sur lequel 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.
InkAnalyzer peut étendre l'analyse pour inclure des régions avoisinantes même s'il analyse l'entrée manuscrite dans sa propriété DirtyRegion pendant un appel à Analyze ou BackgroundAnalyze.
Cette méthode affecte une région vide à la propriété DirtyRegion.
Si les 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 [F:System.Windows.Ink. AnalysisModes.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 ReadyToReconcile.
Votre application n'a pas ajouté de gestionnaire d'événements pour l'événement IntermediateResultsUpdated ou Results().
Exemples
Cet exemple lance l'analyse d'entrée manuscrite d'arrière-plan sur un InkAnalyzer, nommé theInkAnalyzer, si aucune analyse d'entrée manuscrite n'est en cours d'exécution.
If Not theInkAnalyzer.IsAnalyzing Then
Dim started As Boolean = theInkAnalyzer.BackgroundAnalyze()
End If
if (!theInkAnalyzer.IsAnalyzing)
{
bool started = theInkAnalyzer.BackgroundAnalyze();
}
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.
Informations de version
.NET Framework
Pris en charge dans : 3.0
Voir aussi
Référence
System.Windows.Ink, espace de noms
InkAnalyzerBaseAnalysisModes()
InkAnalyzerBaseDirtyRegion()
InkAnalyzerBaseRootNode()
InkAnalyzerBaseAnalyze()