Zum Hauptinhalt springen
Diese Methode wird auf der Client-Seite implementiert. Sie wird von ABBYY FineReader Engine für die Methode InjectTextLayer des Objekts Engine 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.

​
Syntax

​
C++

HRESULT OnProgress(
  int           Percentage,
  VARIANT_BOOL* Cancel
);

​
C#

void OnProgress(
  int      Percentage,
  ref bool Cancel
);

​
Visual Basic .NET

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

​
Parameters

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.

​
Rückgabewerte

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

​
Hinweise

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

​
Siehe auch

IProcessingEvents IEngine::InjectTextLayer