IInkAnalyzer ::Abort, méthode

Annule l’opération d’analyse actuelle.

Syntaxe

HRESULT Abort(
  [out] IAnalysisRegion **ppAbortedRegion
);

Paramètres

ppAbortedRegion [out]

Pointeur vers un IAnalysisRegion qui représente la région sale (voir IInkAnalyzer ::GetDirtyRegion, méthode) de l’opération d’analyse actuelle.

Valeur retournée

Pour obtenir une description des valeurs de retour, consultez Classes et interfaces - Analyse manuscrite.

Remarques

Appelez IUnknown ::Release sur ppAbortedRegion quand vous n’avez plus besoin d’utiliser l’objet.

Cette méthode annule l’opération d’analyse actuelle.

Lorsque ppAbortedRegion a la valeur NULL, cette méthode effectue l’abandon comme normal, car cela indique que l’appelant n’a aucun intérêt dans la valeur de retour.

La méthode IInkAnalyzer ::Abort silencee les événements _IAnalysisEvents ::Results et _IAnalysisEvents ::Activity pour l’opération d’analyse actuelle.

La méthode IInkAnalyzer ::Abort s’exécute de manière asynchrone jusqu’à ce que l’opération d’analyse en arrière-plan actuelle soit annulée. Étant donné que le processus d’annulation est asynchrone, l’application peut effectuer d’autres tâches pendant que les opérations d’analyse actuelles sont annulées.

Si aucune opération d’analyse n’est en cours, cette méthode retourne une région d’analyse vide.

Si une opération d’analyse est en cours, cette méthode annule l’opération.

Si les opérations d’analyse synchrone et asynchrone sont en cours, cette méthode annule l’opération synchrone.

Si cette méthode est appelée plusieurs fois pour la même opération d’analyse, le premier appel retourne la région sale de l’opération et les appels suivants retournent une région vide.

Si votre application conserve sa propre structure de données synchronisée avec celle de IInkAnalyzer, l’appel de la méthode IInkAnalyzer ::Abort peut laisser votre document avec des résultats partiels. Pour éviter cela, n’appelez pas la méthode IInkAnalyzer ::Abort entre le moment où IInkAnalyzer reçoit l’événement _IAnalysisProxyEvents ::InkAnalyzerStateChanging et l’heure à laquelle IInkAnalyzer reçoit l’événement _IAnalysisEvents ::IntermediateResults ou _IAnalysisEvents ::Results .

Pour plus d’informations sur la synchronisation des données de votre application avec l’analyseur d’encre, consultez Proxy de données avec l’analyse manuscrite.

Spécifications

Voir aussi

IInkAnalyzer

IInkAnalyzer ::Analyze, méthode

IInkAnalyzer ::BackgroundAnalyze, méthode

IInkAnalyzer ::GetDirtyRegion, méthode

IInkAnalyzer ::SetDirtyRegion, méthode

informations de référence sur l’analyse manuscrite