IDocumentViewerEvents インターフェイスの OnActivePageChanging メソッド

このメソッドはクライアント側で実装されます。Document Viewer でアクティブページが変更される前に、ABBYY FineReader Engine によって呼び出されます。この処理は、ページが Document Viewer のグラフィカルユーザーインターフェース、またはいずれかの同期コンポーネントを介して変更された場合に実行されます。アクティブページが Document Viewer の API を介して変更された場合、またはアクティブページが削除された場合には、この処理は実行されません。このメソッドは、新たなアクティブページへの参照をクライアントに渡します。このメソッドを使用すると、この操作を取り消すことができます。

構文

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 _
)

パラメーター

Page [in] 新しいアクティブページを含む FRPage オブジェクトを参照します。このパラメーターは NULL の場合があり、その場合はドキュメント内にアクティブページが存在しないことを意味します (たとえば、すべてのページが削除されている場合) 。 Cancel [out] この変数を TRUE に設定すると、処理を中止するよう示すことができます。この場合、アクティブページは変更されません。

戻り値

[C++ のみ] このメソッドが S_OK 以外の値を返した場合は、クライアント側でエラーが発生したことを示します。その場合、Cancel パラメーターの値は考慮されません。

注記

このメソッドのクライアント実装では、メソッド内でスローされるすべての例外を確実にキャッチして処理し、例外がメソッドの外に伝播しないようにする必要があります。例外がメソッドの外に伝播すると、予期しない結果 (プログラムの終了など) を招くおそれがあります。

Overview

ImageViewer

ZoomViewer

DocumentViewer

TextEditor

TextValidator

IImageViewerEvents

IZoomViewerEvents