Zum Hauptinhalt springen
Diese Methode wird clientseitig implementiert. Sie wird von ABBYY FineReader Engine für einige Methoden des FRPage-Objekts aufgerufen. Sie liefert dem Client Informationen über den ungefähren Fortschritt des aktuellen Vorgangs in Prozent (Analyse, Erkennung und Export). Die Implementierung kann einen Fortschrittsindikator anzeigen, wie in ABBYY FineReader.
Unter Windows kann sie außerdem beliebige Systemnachrichten verarbeiten, 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.

​
Syntax

​
C++

HRESULT OnProgress(
  IFRPage*      Sender,
  int           Percentage,
  VARIANT_BOOL* Cancel
);

​
C#

void OnProgress(
  IFRPage   Sender,
  int      Percentage,
  ref bool Cancel
);

​
Visual Basic .NET

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

​
Parameter

Sender [in] Dieser Parameter verweist auf das FRPage-Objekt, das Benachrichtigungen sendet. 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 in Prozent meldet, E_ABORT zurück.

​
Rückgabewerte

[Nur 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.

​
Hinweise

Die Client-Implementierung dieser Methode muss sicherstellen, dass alle in der Methode ausgelösten Ausnahmen abgefangen und behandelt 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).

​
Siehe auch

IFRPageEvents FRPage