IImageViewerEvents インターフェイスの OnCropImages メソッド

このメソッドはクライアント側で実装されます。Image Viewer で画像を切り抜く前に、ABBYY FineReader Engine によって呼び出されます。この処理は、Image Editor ダイアログの Crop セクションで Crop Image ボタンがクリックされると実行されます。

このメソッドは、切り抜き対象となるページのインデックスと、切り抜き矩形の座標をクライアントに渡します。このメソッドを使用すると、この処理をキャンセルできます。

図を見る

​

構文

​

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 Parameter の値は考慮されません。

​

注記

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

​

関連項目

IImageViewerEvents