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

このメソッドはクライアント側で実装されます。Image Viewer の次のいずれかのツールを使って Zoom Viewer で変更したブロック領域を変更する前に、ABBYY FineReader Engine によって呼び出されます。

• ブロック部分を追加 (MI_ChooseTool_AddBlockPart)
• ブロック部分を切り取る (MI_ChooseTool_CutBlockPart)

これらのツールの選択方法については、Image Viewer Commands の説明を参照してください。

このメソッドは、領域が変更されたブロックと、変更後のブロックの新しい領域に関する情報をクライアントに渡します。また、このメソッドを使用して操作をキャンセルすることもできます。

​

構文

​

C++

HRESULT OnToolChangeBlockRegion(
  IIntsCollection*  blocksToChange,
  IRegion*          NewRegion,
  VARIANT_BOOL*     Cancel
);

​

C#

void OnToolChangeBlockRegion(
  IIntsCollection  blocksToChange,
  Region          NewRegion,
  out bool        Cancel
);

​

Visual Basic .NET

Sub OnToolChangeBlockRegion( _
  blocksToChange As IIntsCollection, _
  NewRegion As Region, _
  ByRef Cancel As Boolean _
)

​

パラメーター

blocksToChange

[in] 変更されたブロックのインデックスを IntsCollection オブジェクトとして格納します。

NewRegion

[in] 変更後のブロックの新しい領域を Region オブジェクトとして格納します。

Cancel

[out] この変数を TRUE に設定すると、処理を中止するよう指定できます。この場合、ブロックの領域は変更されません。

​

戻り値

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

​

注記

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

​

関連項目

IZoomViewerEvents