跳轉到主要內容
此方法是在用戶端實作的。在 Image Viewer 中裁切影像之前，ABBYY FineReader Engine 會呼叫此方法。當在 Image Editor 對話方塊的 Crop 區段中按一下 Button_CropImage Crop Image 按鈕時，就會啟動此程序。 此方法會將即將裁切的頁面索引，以及裁切矩形的座標傳送給用戶端。也可以利用此方法取消此作業。
EditImage_Crop

​
語法

​
C++

HRESULT OnCropImages(
  IIntsCollection* PageIndices,
  IFRRectangle*    Rect,
  VARIANT_BOOL*    Cancel
);

​
C#

void OnCropImages(
  IIntsCollection PageIndices,
  FRRectangle    Rect,
  out bool       Cancel
);

​
Visual Basic .NET

Sub OnCropImages( _
  PageIndices As IIntsCollection, _
  Rect As FRRectangle, _
  ByRef Cancel As Boolean _
)

​
參數

PageIndices [in] 包含要裁剪之頁面的索引，以 IntsCollection 物件表示。 Rect [in] 包含裁切矩形，以 FRRectangle 物件表示。座標會以相對於文件影像的像素值指定。 Cancel [out] 您可以將此變數設為 TRUE，表示應終止此程序。在此情況下，頁面將不會被裁剪。

​
回傳值

[僅限 C++] 如果此方法回傳的值不是 S_OK，表示錯誤發生在用戶端，因此在這種情況下，系統不會考量 Cancel 參數的值。

​
備註

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

​
另請參見

IImageViewerEvents