OnProgress-Methode der IImageViewerEvents-Schnittstelle

OnProgress-Methode der IImageViewerEvents-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 in Image Viewer aufgerufen. Der Prozess kann auf eine der folgenden Arten ausgelöst werden:

• mit den folgenden Befehlen von Image Viewer:
  • MI_Read
  • MI_ReadBlock
  • MI_AnalyzeLayout
  • MI_AnalyzeLayoutInBlock

Wie diese Befehle aufgerufen werden können, finden Sie in der Liste Image Viewer Commands.

• mit den folgenden Befehlen von Zoom Viewer, synchronisiert mit Image Viewer:
  • MI_Read
  • MI_ReadBlock
  • MI_AnalyzeLayout
  • MI_AnalyzeLayoutInBlock

Wie diese Befehle aufgerufen werden können, finden Sie in der Liste Zoom Viewer Commands.

• mit den Befehlen von Document Viewer, synchronisiert mit Image Viewer:
  • MI_Read
  • MI_AnalyzeLayout

Wie diese Befehle aufgerufen werden können, finden Sie in der Liste Document Viewer Commands.

• über die FineReader Engine API

Sie übermittelt dem Client den ungefähren Fortschritt des Vorgangs in Prozent. In ihrer Implementierung kann ein Fortschrittsindikator angezeigt werden. Außerdem können Systemmeldungen verarbeitet werden, damit die Anwendung bei lang andauernden Vorgängen nicht den Eindruck macht, nicht mehr zu reagieren. Dies kann in Anwendungen mit Benutzeroberfläche nützlich sein. Mithilfe dieser Methode kann der Vorgang abgebrochen werden.

​

Syntax

​

C++

HRESULT OnProgress(
  int           Percentage,
  VARIANT_BOOL* Cancel
);

​

C#

void OnProgress(
  int      Percentage,
  out bool Cancel
);

​

Visual Basic .NET

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

​

Parameter

Percentage

[in] Enthält den Prozentsatz der bereits abgeschlossenen 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.

​

Rückgabewerte

[Nur C++] Wenn diese Methode einen anderen Wert als S_OK zurückgibt, bedeutet dies, dass auf der Clientseite 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 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

ImageViewer

IImageViewerEvents