Zum Hauptinhalt springen
Dies ist eine Callback-Schnittstelle, die dazu dient, Ereignisse vom Objekt FRDocument an Listener zu übermitteln. Diese Schnittstelle wird clientseitig implementiert. Detaillierte Implementierungshinweise für Ihr Entwicklungstool finden Sie unter Arbeiten mit verknüpfbaren Objekten. Nachfolgend finden Sie eine kurze Beschreibung:
  • C++-Benutzer müssen die IFRDocumentEvents-Schnittstelle implementieren, einen Connection Point (Windows) abrufen und das Objekt, das die Schnittstelle implementiert, beim FRDocument-Objekt “registrieren”. Da die Schnittstelle von der IUnknown-Schnittstelle abgeleitet ist, sollte das Client-Objekt auch die IUnknown-Methoden implementieren.
  • Visual-Basic-Benutzer, die Benachrichtigungen vom FRDocument-Objekt erhalten möchten, sollten es als WithEvents deklarieren und Prozeduren ähnlich den folgenden implementieren:
Ein Objekt, das über die Methoden dieser Schnittstelle Benachrichtigungen erhält, kann innerhalb der Implementierung dieser Methoden Folgendes tun:
  • Den Fortschritt des Bildladens, der Dokumentanalyse, der Erkennung, der Synthese und des Exports in Prozent melden.
  • Informationen über die abgeschlossene Dokumentanalyse, Erkennung, Synthese und den abgeschlossenen Export melden.
  • Unter Windows: Systemmeldungen verarbeiten, um zu verhindern, dass die Anwendung bei lang andauernden Vorgängen den Eindruck erweckt, nicht mehr zu reagieren. Dies kann bei Anwendungen mit Benutzeroberfläche hilfreich sein.

Methoden

NameBeschreibung
OnPageProcessedÜbermittelt dem Client Informationen darüber, dass die Verarbeitung der Seite abgeschlossen ist.
OnProgressÜbermittelt dem Client Informationen über den ungefähren Fortschritt des aktuellen Vorgangs (Laden von Bildern, Analyse, Erkennung usw.).
OnWarningÜbermittelt dem Client Hinweise und Warnungen, die während der Verarbeitung aufgetreten sind.

Beispiele

Dieses Windows-C++-Beispiel zeigt, wie Sie einen Timer implementieren, der die Verarbeitung abbricht, wenn ein Methodenaufruf zu lange dauert.
Dieses Objekt wird in den folgenden Codebeispielen verwendet: EventsHandling (Windows und Linux).

Hinweise

Unter Linux funktioniert diese Schnittstelle nicht, wenn das Engine-Objekt als Out-of-Process-Server geladen ist.

Siehe auch

FRDocument Arbeiten mit verknüpfbaren Objekten