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

> OnProgress-Methode der IDocumentViewerEvents-Schnittstelle in ABBYY FineReader Engine Visual Components unter Windows — Diese Methode wird clientseitig implementiert.

Diese Methode wird clientseitig implementiert. Sie wird von ABBYY FineReader Engine während der Analyse oder Erkennung der aktiven Seite im [Document Viewer](/de/fine-reader/engine/visual-components-reference/documentviewer) aufgerufen. Der Vorgang kann auf eine der folgenden Arten ausgelöst werden:

* mithilfe der Befehle von Document Viewer:
  * [MI\_Read](/de/fine-reader/engine/visual-components-reference/documentviewer/document-viewer-commands#mi_read)
  * [MI\_AnalyzeLayout](/de/fine-reader/engine/visual-components-reference/documentviewer/document-viewer-commands#mi_analyzelayout)

Informationen dazu, wie diese Befehle aufgerufen werden können, finden Sie in der Liste [Document Viewer-Befehle](/de/fine-reader/engine/visual-components-reference/documentviewer/document-viewer-commands).

* mithilfe der folgenden Befehle von [Image Viewer](/de/fine-reader/engine/visual-components-reference/imageviewer), synchronisiert mit Document Viewer:
  * [MI\_Read](/de/fine-reader/engine/visual-components-reference/imageviewer/image-viewer-commands#mi_read)
  * [MI\_ReadBlock](/de/fine-reader/engine/visual-components-reference/imageviewer/image-viewer-commands#mi_readblock)
  * [MI\_AnalyzeLayout](/de/fine-reader/engine/visual-components-reference/imageviewer/image-viewer-commands#mi_analyzelayout)
  * [MI\_AnalyzeLayoutInBlock](/de/fine-reader/engine/visual-components-reference/imageviewer/image-viewer-commands#mi_analyzelayoutinblock)

Informationen dazu, wie diese Befehle aufgerufen werden können, finden Sie in der Liste [Image Viewer-Befehle](/de/fine-reader/engine/visual-components-reference/imageviewer/image-viewer-commands).

* mithilfe der folgenden Befehle von [Zoom Viewer](/de/fine-reader/engine/visual-components-reference/zoomviewer), synchronisiert mit Image Viewer:
  * [MI\_Read](/de/fine-reader/engine/visual-components-reference/zoomviewer/zoom-viewer-commands#mi_read)
  * [MI\_ReadBlock](/de/fine-reader/engine/visual-components-reference/zoomviewer/zoom-viewer-commands#mi_readblock)
  * [MI\_AnalyzeLayout](/de/fine-reader/engine/visual-components-reference/zoomviewer/zoom-viewer-commands#mi_analyzelayout)
  * [MI\_AnalyzeLayoutInBlock](/de/fine-reader/engine/visual-components-reference/zoomviewer/zoom-viewer-commands#mi_analyzelayoutinblock)

Informationen dazu, wie diese Befehle aufgerufen werden können, finden Sie in der Liste [Zoom Viewer-Befehle](/de/fine-reader/engine/visual-components-reference/zoomviewer/zoom-viewer-commands).

* über die FineReader Engine API

Sie übermittelt dem Client den ungefähren Fortschritt des Vorgangs in Prozent. In ihrer Implementierung kann eine Fortschrittsanzeige angezeigt werden. Verarbeiten Sie Systemmeldungen, damit die Anwendung bei lang andauernden Vorgängen nicht den Eindruck erweckt, nicht mehr zu reagieren. Dies kann in Anwendungen mit einer Benutzeroberfläche hilfreich sein. Mithilfe dieser Methode kann der Vorgang abgebrochen werden.

<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,
  out 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">
  ## Parameter
</div>

Percentage

\[in] Enthält den Prozentsatz der bisher erledigten Arbeit. Der Wert liegt im Bereich von 0 bis 100.

Cancel

\[out] Sie können diese Variable auf TRUE setzen, um anzugeben, dass der Prozess beendet werden soll. In diesem Fall wird der Analyse- oder Erkennungsvorgang abgebrochen.

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

\[Nur in C++] Wenn diese Methode einen anderen Wert als S\_OK zurückgibt, bedeutet dies, dass ein clientseitiger 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 dass keine Ausnahmen über die Methode hinaus propagiert werden. Die Propagierung 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>

[DocumentViewer](/de/fine-reader/engine/visual-components-reference/documentviewer)

[IDocumentViewerEvents](/de/fine-reader/engine/visual-components-reference/idocumentviewerevents)