Méthode IInkAnalyzer::Abort

Annule l’opération d’analyse en cours.

Syntaxe

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

Paramètres

ppAbortedRegion [out]

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

Valeur retournée

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

Notes

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

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

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

La méthode IInkAnalyzer::Abort réduit au silence 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 des opérations d’analyse synchrones et asynchrones 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 pour l’opération, et les appels suivants retournent une région vide.

Si votre application conserve sa propre structure de données qui est 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 le moment où IInkAnalyzer reçoit l’événement _IAnalysisEvents::IntermediateResults ou _IAnalysisEvents::Results .

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

Spécifications

Condition requise	Valeur
Client minimal pris en charge	Windows XP Édition Tablet PC [applications de bureau uniquement]
Serveur minimal pris en charge	Aucun pris en charge
En-tête	IACom.h (nécessite également IACom_i.c)
DLL	IACom.dll

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