Zum Hauptinhalt springen
Diese Methode ist clientseitig implementiert. Sie wird von ABBYY FineReader Engine aufgerufen, bevor die aktive Seite im Document Viewer geändert wird. Der Vorgang wird ausgelöst, wenn die Seite über die grafische Benutzeroberfläche des Document Viewer oder einer beliebigen synchronisierten Komponente geändert wird. Der Vorgang wird nicht ausgelöst, wenn die aktive Seite über die API des Document Viewer geändert wird oder wenn die aktive Seite gelöscht wurde. Die Methode übergibt dem Client eine Referenz auf die neue aktive Seite. Mit dieser Methode kann der Vorgang abgebrochen werden.

​
Syntax

​
C++

HRESULT OnActivePageChanging(
  IFRPage*      Page,
  VARIANT_BOOL* Cancel
);

​
C#

void OnActivePageChanging(
  IFRPage   Page,
  out bool Cancel
);

​
Visual Basic .NET

Sub OnActivePageChanging( _
  Page As IFRPage, _
  ByRef Cancel As Boolean _
)

​
Parameter

Page [in] Verweist auf das Objekt FRPage, das die neue aktive Seite enthält. Dieser Parameter kann NULL sein; das bedeutet, dass das Dokument keine aktive Seite hat (zum Beispiel, wenn alle Seiten gelöscht wurden). Cancel [out] Sie können diese Variable auf TRUE setzen, um anzugeben, dass der Vorgang abgebrochen werden soll. In diesem Fall wird die aktive Seite nicht geändert.

​
Rückgabewerte

[Nur C++] Wenn diese Methode einen anderen Wert als S_OK zurückgibt, bedeutet dies, 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 gewährleisten, 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

IDocumentViewerEvents