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

このメソッドはクライアント側で実装されます。Document Viewer でページ番号を振り直す前に、ABBYY FineReader Engine によって呼び出されます。この処理は、次の状況で開始されることがあります。

このメソッドは、ページの新しい順序をクライアントに渡します。このメソッドを使用すると、この操作をキャンセルできます。

構文

HRESULT OnRenumberingPages(
  IIntsCollection* NewOrder,
  VARIANT_BOOL*    Cancel
);

void OnRenumberingPages(
  IIntsCollection NewOrder,
  out bool       Cancel
);

Sub OnRenumberingPages( _
  NewOrder As IIntsCollection, _
  ByRef Cancel As Boolean _
)

NewOrder [in] IntsCollection オブジェクトとして、新しいページ順を指定します。 Cancel [out] 処理を終了する必要があることを示すには、この変数を TRUE に設定できます。この場合、解析処理または認識処理は中止されます。

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

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