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

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

• 認識領域を描画 (MI_ChooseTool_DrawRecognitionArea)
• テキスト領域を描画 (MI_ChooseTool_DrawTextBlock)
• 表領域を描画 (MI_ChooseTool_DrawTableBlock)
• 画像領域を描画 (MI_ChooseTool_DrawPictureBlock)
• 背景画像領域を描画 (MI_ChooseTool_DrawBackgroundPictureBlock)
• バーコード領域を描画 (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 パラメーターの値は考慮されません。

​

注記

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

​

関連項目

IZoomViewerEvents