跳转到主要内容
此方法在客户端实现。ABBYY FineReader Engine 会在添加使用 图像查看器 的以下某个工具绘制的新块之前调用它： 请参阅 图像查看器命令 的说明，了解如何选择这些工具。 该方法会向客户端提供已绘制块的信息，包括其类型和区域。还可使用此方法取消该操作。

​
语法

​
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