Zum Hauptinhalt springen
Diese Methode wird clientseitig implementiert. Sie wird von ABBYY FineReader Engine aufgerufen, bevor die aktive Seite im Text Editor geändert wird. Der Vorgang wird ausgelöst, wenn die Seite über die grafische Benutzeroberfläche von Text Editor oder eine andere synchronisierte Komponente geändert wird. Der Vorgang wird nicht ausgelöst, wenn die aktive Seite über die API von Text Editor geändert wird oder wenn die aktive Seite gelöscht wurde. Die Methode übergibt dem Client einen Verweis auf die neue aktive Seite. Mithilfe dieser Methode kann der Vorgang abgebrochen werden.

​
Syntax

​
C++

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

​
C#

void OnActivePageChanging(
  IFRPage   Seite,
  out bool Cancel
);

​
Visual Basic .NET

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

​
Parameter

Seite [in] Verweist auf das FRPage-Objekt, das die neue aktive Seite enthält. Dieser Parameter kann NULL sein. Das bedeutet, dass es im Document keine aktive Seite gibt (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 für C++] Wenn diese Methode einen anderen Wert als S_OK zurückgibt, bedeutet dies, dass auf der Client-Seite ein Fehler aufgetreten ist. In diesem Fall wird der Wert des Parameters Cancel nicht berücksichtigt.

​
Bemerkungen

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

ITextEditorEvents