跳轉到主要內容
這個方法是在用戶端實作。ABBYY FineReader Engine 會在 Zoom Viewer 中，使用 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++] 如果此 method 回傳的值不是 S_OK，則表示用戶端發生了錯誤；在這種情況下，Cancel 參數的值不會納入考量。

​
備註

此方法的客戶端實作必須確保，凡是在方法內部擲出的所有例外都會被攔截並處理，且不會有任何例外傳播到方法外部。若例外傳播到方法外部，可能會導致不可預期的結果 (例如程式終止) 。

​
另請參閱

IZoomViewerEvents