IDocumentViewerEvents Interface の OnAnalyzePages メソッド

このメソッドはクライアント側で実装されます。ABBYY FineReader Engine は、Document Viewer で次のいずれかの方法によって開始されたページ解析処理を始める前に、このメソッドを呼び出します。

このメソッドは、アクティブなページがこれから解析されることをクライアントに通知します。このメソッドを使用すると、この操作をキャンセルできます。

構文

HRESULT OnAnalyzePages( VARIANT_BOOL* Cancel );

void OnAnalyzePages( out bool Cancel );

Sub OnAnalyzePages(ByRef Cancel As Boolean)

Cancel [out] プロセスを終了する必要があることを示すには、この変数を TRUE に設定します。この場合、ページは解析されません。

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

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