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

このメソッドはクライアント側で実装されます。Image Viewer の以下のいずれかのツールを使用して描画した新しいブロックを追加する前に、ABBYY FineReader Engine によって呼び出されます。

• 認識領域を描画 (MI_ChooseTool_DrawRecognitionArea)
• テキスト領域を描画 (MI_ChooseTool_DrawTextBlock)
• 表領域を描画 (MI_ChooseTool_DrawTableBlock)
• 画像領域を描画 (MI_ChooseTool_DrawPictureBlock)
• 背景画像領域を描画 (MI_ChooseTool_DrawBackgroundPictureBlock)
• Barcode 領域を描画 (MI_ChooseTool_DrawBarcodeBlock)

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

このメソッドは、描画されたブロックに関する情報 (種類と領域) をクライアントに渡します。また、このメソッドを使用してこの操作をキャンセルすることもできます。

​

構文

​

C++

HRESULT OnToolAddBlock(
  BlockTypeEnum type,
  IFRRectangle* BlockRect,
  VARIANT_BOOL* Cancel
);

​

C#

void OnToolAddBlock(
  BlockTypeEnum type,
  IFRRectangle   BlockRect,
  out bool      Cancel
);

​

Visual Basic .NET

Sub OnToolAddBlock( _
  type As BlockTypeEnum, _
  BlockRect As IFRRectangle, _
  ByRef Cancel As Boolean _
)

​

パラメーター

type

[in] ブロックのタイプを指定します。BlockTypeEnum 定数の説明を参照してください。

BlockRect

[in] ブロックの座標を指定します。座標は FRRectangle オブジェクトで表されます。座標は、ドキュメント画像を基準としたピクセル単位で指定します。

Cancel

[out] 処理を中止する必要があることを示すには、この変数を TRUE に設定します。この場合、ブロックは作成されません。

​

戻り値

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

​

注記

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

​

関連項目

IImageViewerEvents