跳轉到主要內容
此方法是在用戶端實作。ABBYY FineReader Engine 會在新增使用下列 Image Viewer 工具之一繪製的新區塊之前呼叫此方法: 請參閱 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 Parameter 的值。

備註

此 方法 的用戶端實作必須確保:在 方法 內擲出的所有例外狀況都會被攔截並妥善處理,且不會傳播到 方法 外部。若例外狀況傳播到 方法 外部,可能會導致無法預期的結果 (例如程式終止) 。

請參閱

IImageViewerEvents