> ## 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.

# OnProgress-Methode der IFRDocumentEvents-Schnittstelle

> OnProgress-Methode der IFRDocumentEvents-Schnittstelle in der ABBYY FineReader Engine API — clientseitige Methode, die aufgerufen wird, um den ungefähren prozentualen Fortschritt für FRDocument-Vorgänge zu melden (Laden von Bildern, Analyse, Erkennung usw.).

Diese Methode wird clientseitig implementiert. Sie wird von ABBYY FineReader Engine für einige Methoden des [FRDocument](/de/fine-reader/engine/api-reference/document-related-objects/frdocument)-Objekts aufgerufen. Sie liefert dem Client Informationen über den ungefähren Fortschritt des aktuellen Vorgangs (Laden von Bildern, Analyse, Erkennung usw.). Die Implementierung kann einen Fortschrittsindikator anzeigen, wie es auch in ABBYY FineReader geschieht.

<Note>
  Unter Windows kann sie außerdem Systemmeldungen verarbeiten, damit die Anwendung bei längeren Vorgängen nicht den Eindruck erweckt, nicht mehr zu reagieren. Dies kann in Anwendungen mit Benutzeroberfläche hilfreich sein.
</Note>

<div id="syntax">
  ## Syntax
</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">
  ## Parameter
</div>

Sender

\[in] Dieser Parameter bezieht sich auf das Objekt [FRDocument](/de/fine-reader/engine/api-reference/document-related-objects/frdocument), das Benachrichtigungen sendet.

Percentage

\[in] Dieser Parameter enthält den aktuellen Fortschritt in Prozent. Der Wert liegt im Bereich von 0 bis 100.

Cancel

\[in, out] Sie können diese Variable auf TRUE setzen, um anzugeben, dass der Vorgang abgebrochen werden soll. In diesem Fall gibt die Verarbeitungsfunktion E\_ABORT zurück.

<div id="return-values">
  ## Rückgabewerte
</div>

\[Nur C++] Wenn diese Methode einen anderen Wert als S\_OK zurückgibt, bedeutet das, dass clientseitig ein Fehler aufgetreten ist; in diesem Fall wird der Wert des Parameters Cancel nicht berücksichtigt.

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

Die Client-Implementierung dieser Methode muss sicherstellen, dass alle innerhalb der Methode ausgelösten Ausnahmen abgefangen und verarbeitet werden und dass keine Ausnahmen über die Methode hinaus weitergegeben werden. Die Weitergabe einer Ausnahme über die Methode hinaus kann zu unvorhersehbaren Ergebnissen führen (z. B. zur Beendigung des Programms).

<div id="see-also">
  ## Siehe auch
</div>

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

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