> ## 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 IProcessingEvents-Schnittstelle

> OnProgress-Methode der IProcessingEvents-Schnittstelle in der ABBYY FineReader Engine API — clientseitige Methode, die von Engine.InjectTextLayer aufgerufen wird, um Informationen zum prozentualen Fortschritt bereitzustellen und einen Abbruch zu ermöglichen.

Diese Methode wird clientseitig implementiert. Sie wird von ABBYY FineReader Engine für die Methode [InjectTextLayer](/de/fine-reader/engine/api-reference/engine-object-iengine-interface/processing-methods/injecttextlayer-method) des Objekts [Engine](/de/fine-reader/engine/api-reference/engine-object-iengine-interface) aufgerufen. Sie übermittelt dem Client Informationen über den ungefähren Fortschritt der abgeschlossenen Operation in Prozent. Die Implementierung kann eine Fortschrittsanzeige einblenden, wie es auch in ABBYY FineReader der Fall ist. Außerdem kann sie beliebige Systemmeldungen verarbeiten, damit die Anwendung bei längeren Vorgängen nicht den Eindruck erweckt, nicht mehr zu reagieren.

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

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

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

### C\#

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

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

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

<div id="parameters">
  ## Parameters
</div>

Percentage

\[in] Dieser Parameter enthält den aktuellen Fortschritt in Prozent. Der Wert liegt zwischen 0 und 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, die den Fortschritt meldet, E\_ABORT zurück.

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

\[Nur für C++] Wenn diese Methode einen anderen Wert als S\_OK zurückgibt, weist dies darauf hin, 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 behandelt werden und keine Ausnahmen aus der Methode nach außen weitergegeben werden. Die Weitergabe einer Ausnahme aus der Methode nach außen kann zu unvorhersehbaren Ergebnissen führen (z. B. zum Programmabbruch).

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

[IProcessingEvents](/de/fine-reader/engine/api-reference/supplementary-objects-and-methods/iprocessingevents)

[IEngine::InjectTextLayer](/de/fine-reader/engine/api-reference/engine-object-iengine-interface/processing-methods/injecttextlayer-method)