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

このメソッドはクライアント側で実装されます。Image Viewer の画像ページで遠近歪みを補正する前に、ABBYY FineReader Engine によって呼び出されます。この処理は、Image Editor ダイアログの 台形歪みの補正 セクションで Correct this image ボタンをクリックすると実行されます。

このメソッドは、変更されるページのインデックスと、新しいページ四隅の座標をクライアントに渡します。このメソッドを使用すると、この処理をキャンセルできます。

図を参照

​

構文

​

C++

HRESULT OnCorrectPerspective(
  int           PageIndex,
  IPoint*       TopLeft,
  IPoint*       TopRight,
  IPoint*       BottomRight,
  IPoint*       BottomLeft,
  VARIANT_BOOL* Cancel
);

​

C#

void OnCorrectPerspective(
  int      PageIndex,
  IPoint    TopLeft,
  IPoint    TopRight,
  IPoint    BottomRight,
  IPoint    BottomLeft,
  out bool Cancel
);

​

Visual Basic .NET

Sub OnCorrectPerspective( _
  PageIndex As Integer, _
  TopLeft As IPoint, _
  TopRight As IPoint, _
  BottomRight As IPoint, _
  BottomLeft As IPoint, _
  ByRef Cancel As Boolean _
)

​

パラメータ

PageIndex

[in] 台形歪みを補正する対象ページのインデックスを格納します。

TopLeft

[in] 補正後の画像の新しい左上隅となる、画像上の点の座標を格納します。Point オブジェクトの説明を参照してください。

TopRight

[in] 補正後の画像の新しい右上隅となる、画像上の点の座標を格納します。Point オブジェクトの説明を参照してください。

BottomRight

[in] 補正後の画像の新しい右下隅となる、画像上の点の座標を格納します。Point オブジェクトの説明を参照してください。

BottomLeft

[in] 補正後の画像の新しい左下隅となる、画像上の点の座標を格納します。Point オブジェクトの説明を参照してください。

Cancel

[out] 処理を中止する必要があることを示すには、この変数を TRUE に設定します。この場合、遠近歪みの補正は行われません。

​

戻り値

[C++ のみ] このメソッドが S_OK 以外の値を返した場合は、クライアント側でエラーが発生したことを示します。この場合、Cancel パラメーターの値は考慮されません。

​

注記

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

​

関連項目

IImageViewerEvents