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

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

このメソッドは、これから解析される領域に関する情報をクライアントに渡します。また、このメソッドを使用して処理をキャンセルすることもできます。

構文

HRESULT OnAnalyzeRegion(
  IRegion*      Region,
  VARIANT_BOOL* Cancel
);

void OnAnalyzeRegion(
  IRegion   Region,
  out bool Cancel
);

Sub OnAnalyzeRegion( _
  Region As IRegion, _
  ByRef Cancel As Boolean _
)

Region [in] 解析対象の領域を Region オブジェクトとして格納します。 Cancel [out] 処理を中止する必要があることを示すには、この変数を TRUE に設定します。この場合、領域は解析されません。

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

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