> ## Documentation Index
> Fetch the complete documentation index at: https://docs.abbyy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Méthode OnProgress de l’interface IFRDocumentEvents

> Méthode OnProgress de l’interface IFRDocumentEvents dans l’API ABBYY FineReader Engine — méthode côté client appelée pour signaler le pourcentage approximatif d’avancement des opérations de FRDocument (chargement d’image, analyse, reconnaissance, etc.).

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 [FRDocument](/fr/fine-reader/engine/api-reference/document-related-objects/frdocument). Elle fournit au client des informations sur le pourcentage approximatif de l’opération en cours (chargement d’image, analyse, reconnaissance, etc.). Son implémentation peut afficher un indicateur de progression, comme dans ABBYY FineReader.

<Note>
  Sous Windows, elle peut également traiter les messages système afin d’éviter que l’application ne semble ne plus répondre pendant les opérations longues. Cela peut être utile dans les applications dotées d’une interface utilisateur.
</Note>

<div id="syntax">
  ## Syntaxe
</div>

<div id="c">
  ### C++
</div>

```csharp theme={null}
HRESULT OnProgress(
  IFRDocument*  Sender,
  int           Percentage,
  VARIANT_BOOL* Cancel
);
```

### C\#

```csharp theme={null}
void OnProgress(
  IFRDocument Sender,
  int        Percentage,
  ref bool   Cancel
);
```

<div id="visual-basic-net">
  ### Visual Basic .NET
</div>

```csharp theme={null}
Sub OnProgress( _
  Sender As IFRDocument, _
  Percentage As Integer, _
  ByRef Cancel As Boolean _
)
```

<div id="parameters">
  ## Paramètres
</div>

Sender

\[in] Ce paramètre fait référence à l'objet [FRDocument](/fr/fine-reader/engine/api-reference/document-related-objects/frdocument) qui envoie les notifications.

Percentage

\[in] Ce paramètre contient le pourcentage de travail déjà effectué. Il est compris 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 renvoie E\_ABORT.

<div id="return-values">
  ## Valeurs de retour
</div>

\[C++ uniquement] Si cette méthode renvoie une valeur autre que S\_OK, cela indique 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.

<div id="remarks">
  ## Remarques
</div>

L’implémentation du client pour cette méthode doit garantir que toutes les exceptions levées à l’intérieur de la méthode sont interceptées et traité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).

<div id="see-also">
  ## Voir aussi
</div>

[IFRDocumentEvents](/fr/fine-reader/engine/api-reference/document-related-objects/ifrdocumentevents)

[FRDocument](/fr/fine-reader/engine/api-reference/document-related-objects/frdocument)