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

このメソッドはクライアント側で実装されます。Zoom Viewer から次のいずれかの方法で開始されたブロック認識処理が始まる前に、ABBYY FineReader Engine によって呼び出されます。

コンテキストメニューで Read Area 項目を選択する
Ctrl+Shift+B のホットキーを押す
IZoomViewer::Commands の DoCommand メソッドを使用して MI_ReadBlock コマンドを呼び出す

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

構文

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 パラメーターの値は考慮されません。

注記

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

Overview

ImageViewer

ZoomViewer

DocumentViewer

TextEditor

TextValidator

IImageViewerEvents