ITextValidatorEvents インターフェイスの OnActivePageChanged メソッド

このメソッドはクライアント側で実装されます。Text Validator でアクティブページが変更されると、その後 ABBYY FineReader Engine によって呼び出されます。これは次の状況で発生します。

Text Validator が文書のあるページのスペルチェックを完了して次のページに進んだ場合、または同期されているいずれかのコンポーネントのグラフィカルユーザーインターフェイスからアクティブページが変更された場合
Component Synchronizer または同期されているいずれかのコンポーネントの API を介してアクティブページが変更された場合
アクティブページが削除された場合

このメソッドは、新しいアクティブページへの参照をクライアントに渡します。

構文

HRESULT OnActivePageChanged( IFRPage* Page );

void OnActivePageChanged( IFRPage Page );

Sub OnActivePageChanged(Page As IFRPage)

Page [in] ドキュメント内の新しいアクティブページを表す FRPage オブジェクトを参照します。このパラメーターは NULL の場合があり、その場合はドキュメント内にアクティブページが存在しないことを意味します (たとえば、すべてのページが削除されている場合) 。

[C++ のみ] このメソッドが S_OK 以外の値を返す場合は、クライアント側でエラーが発生していることを示します。

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