Passer au contenu principal
Cette méthode est implémentée côté client. Elle est appelée par ABBYY FineReader Engine lors de l’exécution de la méthode InjectTextLayer de l’objet Engine. Elle fournit au client des informations sur le pourcentage approximatif d’avancement de l’opération. Son implémentation peut afficher un indicateur de progression, comme dans ABBYY FineReader. Elle peut également traiter les messages système afin d’éviter que l’application semble ne plus répondre pendant les opérations longues.

​
Syntaxe

​
C++

HRESULT OnProgress(
  int           Percentage,
  VARIANT_BOOL* Cancel
);

​
C#

void OnProgress(
  int      Percentage,
  ref bool Cancel
);

​
Visual Basic .NET

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

​
Paramètres

Percentage [in] Ce paramètre indique le pourcentage de travail déjà effectué. Sa valeur est comprise entre 0 et 100. Cancel [in, out] Vous pouvez définir cette variable sur TRUE pour indiquer que le processus doit être interrompu. Dans ce cas, la fonction de traitement qui signale le pourcentage renvoie E_ABORT.

​
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 cliente 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 n’est propagée à l’extérieur de la méthode. La propagation d’une exception hors de la méthode peut entraîner des résultats imprévisibles (tels que l’arrêt du programme).

​
Voir aussi

IProcessingEvents IEngine::InjectTextLayer