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

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

構文

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 パラメーターの値は無視されます。

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