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

このメソッドはクライアント側で実装されます。Image Viewer で画像を拡大・縮小する前に、ABBYY FineReader Engine によって呼び出されます。このメソッドはスケール値をクライアントに渡します。このメソッドを使用すると、この操作をキャンセルできます。

構文

HRESULT OnScale(
  int           ScaleValue,
  VARIANT_BOOL* Cancel
);

void OnScale(
  int      ScaleValue,
  out bool Cancel
);

Sub OnScale( _
  ScaleValue As Integer, _
  ByRef Cancel As Boolean _
)

ScaleValue [in] パーセンテージで指定するスケール値を格納します。 Cancel [out] 処理を終了する必要があることを示すには、この変数を TRUE に設定します。この場合、画像は拡大・縮小されません。

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

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