Passer au contenu principal
Cette méthode est implémentée côté client. Elle est appelée par ABBYY FineReader Engine pour certaines méthodes de l’objet FRPage. Elle transmet au client des informations sur le pourcentage approximatif d’avancement de l’opération en cours (analyse, reconnaissance et export). Son implémentation peut afficher un indicateur de progression, comme c’est le cas dans ABBYY FineReader.
Sous Windows, elle peut également traiter les messages système afin d’éviter que l’application ne semble plus répondre lors d’opérations longues. Cela peut s’avérer utile dans les applications dotées d’une interface utilisateur.

​
Syntaxe

​
C++

HRESULT OnProgress(
  IFRPage*      Sender,
  int           Percentage,
  VARIANT_BOOL* Cancel
);

​
C#

void OnProgress(
  IFRPage   Sender,
  int      Percentage,
  ref bool Cancel
);

​
Visual Basic .NET

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

​
Parameters

Sender [in] Ce Parameter fait référence à l’objet FRPage qui envoie les notifications. Percentage [in] Ce Parameter contient le pourcentage du travail effectué à ce stade. Il est compris entre 0 et 100. Cancel [in, out] Vous pouvez définir cette variable sur TRUE pour indiquer que le process doit être interrompu. Dans ce cas, la fonction de traitement qui signale le pourcentage retourne E_ABORT.

​
Return values

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

​
Remarques

L’implémentation client de cette méthode doit garantir que toutes les exceptions levées au sein de la méthode sont interceptées et gérées, et qu’aucune exception ne se propage en dehors de celle-ci. La propagation d’une exception en dehors de la méthode peut entraîner des résultats imprévisibles (tels que l’arrêt du programme).

​
Voir aussi

IFRPageEvents FRPage