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 |
|
| DLL |
|