メインコンテンツへスキップ
このメソッドはクライアント側で実装されます。Zoom Viewer から次のいずれかの方法で開始されたページ認識処理が始まる前に、ABBYY FineReader Engine によって呼び出されます。
  • コンテキストメニューの Read Page 項目がクリックされた場合
  • Ctrl+R ホットキーが押された場合
  • IZoomViewer::Commands の DoCommand メソッドを使用して MI_Read コマンドが呼び出された場合
このメソッドは、アクティブなページが認識されることをクライアントに通知します。このメソッドを使用すると、処理をキャンセルできます。

構文

C++

HRESULT OnReadPage( VARIANT_BOOL* Cancel );

C#

void OnReadPage( out bool Cancel );

Visual Basic .NET

Sub OnReadPage(ByRef Cancel As Boolean)

Parameter

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

戻り値

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

備考

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

関連項目

IZoomViewerEvents OnReadBlocks