IImageViewerEvents インターフェイスの OnReadBlocks メソッド

このメソッドはクライアント側で実装されます。Image Viewer から MI_ReadBlock コマンドを呼び出して開始されるブロック認識処理の前に、ABBYY FineReader Engine によって呼び出されます。このコマンドの呼び出し方法については、Image Viewer Commands の一覧を参照してください。

このメソッドは、これから認識されるブロックのインデックスをクライアントに渡します。このメソッドを使用すると、処理をキャンセルできます。

​

構文

​

C++

HRESULT OnReadBlocks(
  IIntsCollection* BlocksIndices,
  VARIANT_BOOL*    Cancel
);

​

C#

void OnReadBlocks(
  IIntsCollection   BlocksIndices,
  out bool       Cancel
);

​

Visual Basic .NET

Sub OnReadBlocks( _
  BlocksIndices As IIntsCollection, _
  ByRef Cancel As Boolean _
)

​

パラメータ

BlocksIndices

[in] IntsCollection オブジェクトとして認識されるブロックのインデックスが含まれます。

Cancel

[out] この変数を TRUE に設定すると、処理を中止する必要があることを示せます。この場合、認識は実行されません。

​

戻り値

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

​

注記

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

​

関連項目

IImageViewerEvents

OnReadPage