IFRPagesEvents-Schnittstelle

IFRPagesEvents-Schnittstelle in der ABBYY FineReader Engine API — clientseitige Callback-Schnittstelle zur Meldung von Ereignissen (PageAdded, PageRemoved, PagesRenumbered) aus einer FRPages-Sammlung an Listener.

Dies ist eine Callback-Schnittstelle, die verwendet wird, um Ereignisse vom Objekt FRPages 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 kurze Beschreibung:

C++-Benutzer müssen die Schnittstelle IFRPagesEvents implementieren, einen Verbindungspunkt (Windows) abrufen und ein Objekt, das die Schnittstelle implementiert, per “advise” beim FRPages-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 FRPages-Objekt erhalten möchten, sollten es mit WithEvents deklarieren und Prozeduren implementieren, die dem folgenden Beispiel ähneln:

Public WithEvents pages As FREngine.FRPages
Private Sub pages_PageRemoved(ByVal sender As FRPages, _
                              ByVal page As FRPage, _
                              ByVal index  As Integer)
...
End Sub

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

• Melden, dass das Entfernen und Hinzufügen von Seiten abgeschlossen ist.
• Melden, dass die Neunummerierung von Seiten abgeschlossen ist.
• Unter Windows: Systemmeldungen verarbeiten, damit die Anwendung bei lang andauernden Vorgängen nicht als nicht reagierend erscheint. Dies kann bei Anwendungen mit Benutzeroberfläche hilfreich sein.

​

Methoden

Name	Beschreibung
PageAdded	Übermittelt dem Client Informationen über das abgeschlossene Hinzufügen einer Seite.
PageRemoved	Übermittelt dem Client Informationen über das abgeschlossene Entfernen einer Seite.
PagesRenumbered	Übermittelt dem Client Informationen über die abgeschlossene Neunummerierung von Seiten.

​

Hinweise

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

​

Siehe auch

FRPages

Arbeiten mit verknüpfbaren Objekten