IFRPageEvents-Schnittstelle

IFRPageEvents-Schnittstelle in der ABBYY FineReader Engine API — clientseitige Callback-Schnittstelle zur Meldung von Ereignissen (OnPageProcessed, OnProgress, OnRegionProcessed, OnWarning) von einem FRPage an Listener.

Dies ist eine Callback-Schnittstelle, die verwendet wird, um Ereignisse vom Objekt FRPage an Listener zu übermitteln. Diese Schnittstelle wird clientseitig implementiert. Ausführliche Hinweise zur Implementierung für Ihr Entwicklungstool finden Sie unter Arbeiten mit verknüpfbaren Objekten. Nachfolgend finden Sie eine Kurzbeschreibung:

C++-Benutzer müssen die Schnittstelle IFRPageEvents implementieren, einen Connection Point (Windows) abrufen und das Objekt, das die Schnittstelle implementiert, beim FRPage-Objekt „advise“. Da die Schnittstelle von der IUnknown-Schnittstelle abgeleitet ist, sollte das Client-Objekt auch die IUnknown-Methoden implementieren.

Visual-Basic-Benutzer, die Benachrichtigungen vom FRPage-Objekt erhalten möchten, sollten es mit WithEvents deklarieren und Prozeduren ähnlich den folgenden implementieren:

Public WithEvents page As FREngine.FRPage
Private Sub page_OnPageProcessed(ByVal sender As FRPage, _
                                 ByVal stage As PageProcessingStageEnum)
...
End Sub

Ein Objekt, das über die Methoden dieser Schnittstelle Benachrichtigungen empfängt, kann innerhalb der Methodenimplementierung Folgendes tun:

• Den prozentualen Fortschritt der Dokumentanalyse, der Erkennung und des Exports melden.
• Hinweise und Warnungen des Erkennungsmoduls an den Benutzer weitergeben.
• Informationen über den Abschluss des Vorgangs melden.
• Unter Windows: Systemmeldungen verarbeiten, damit die Anwendung bei lang andauernden Vorgängen nicht den Eindruck erweckt, nicht mehr zu reagieren. Dies kann bei Anwendungen mit einer Benutzeroberfläche hilfreich sein.

​

Methoden

Name	Beschreibung
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 in Prozent (Analyse, Erkennung und Export).
OnRegionProcessed	Übermittelt dem Client Informationen über die verarbeitete Region.
OnWarning	Übermittelt dem Client Hinweise und Warnungen, die während der Verarbeitung aufgetreten sind.

​

Hinweise

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

​

Siehe auch

FRPage

Arbeiten mit verknüpfbaren Objekten