Méthode OnProgress de l’interface IImageViewerEvents

Cette méthode est implémentée côté client. Elle est appelée par ABBYY FineReader Engine pendant l’analyse ou la reconnaissance de la page active dans Image Viewer. Le traitement peut être déclenché de l’une des façons suivantes :

• à l’aide des commandes suivantes de Image Viewer :
  • MI_Read
  • MI_ReadBlock
  • MI_AnalyzeLayout
  • MI_AnalyzeLayoutInBlock

Pour savoir comment appeler ces commandes, consultez la liste Image Viewer Commands.

• à l’aide des commandes suivantes de Zoom Viewer, lorsqu’il est synchronisé avec Image Viewer :
  • MI_Read
  • MI_ReadBlock
  • MI_AnalyzeLayout
  • MI_AnalyzeLayoutInBlock

Pour savoir comment appeler ces commandes, consultez la liste Zoom Viewer Commands.

• à l’aide des commandes de Document Viewer, lorsqu’il est synchronisé avec Image Viewer :
  • MI_Read
  • MI_AnalyzeLayout

Pour savoir comment appeler ces commandes, consultez la liste Document Viewer Commands.

• via l’API FineReader Engine

Elle fournit au client un pourcentage approximatif de progression de l’opération. Son implémentation peut afficher un indicateur de progression. Elle peut également traiter les messages système afin d’éviter que l’application ne paraisse ne plus répondre pendant les opérations longues. Cela peut être utile dans les applications dotées d’une interface utilisateur. Cette méthode permet également d’annuler l’opération.

​

Syntaxe

​

C++

HRESULT OnProgress(
  int           Percentage,
  VARIANT_BOOL* Cancel
);

​

C#

void OnProgress(
  int      Percentage,
  out bool Cancel
);

​

Visual Basic .NET

Sub OnProgress( _
  Percentage As Integer, _
  ByRef Cancel As Boolean _
)

​

Paramètres

Percentage

[in] Contient le pourcentage de travail actuellement effectué. La valeur est comprise entre 0 et 100.

Cancel

[out] Vous pouvez définir cette variable sur TRUE pour indiquer que le processus doit être arrêté. Dans ce cas, le processus d’analyse ou de reconnaissance sera interrompu.

​

Valeurs de retour

[C++ uniquement] Si cette méthode renvoie une valeur autre que S_OK, cela signifie qu’une erreur s’est produite côté client et, dans ce cas, la valeur du paramètre Cancel n’est pas prise en compte.

​

Remarques

L’implémentation côté client de cette méthode doit garantir que toutes les exceptions levées à l’intérieur de la méthode sont interceptées et gérées, et qu’aucune exception n’est propagée en dehors de la méthode. La propagation d’une exception en dehors de la méthode peut entraîner des résultats imprévisibles (comme l’arrêt du programme).

​

Voir aussi

ImageViewer

IImageViewerEvents