メインコンテンツへスキップ
このメソッドはクライアント側で実装されます。Image ViewerZoom ViewerText EditorText Validator、または Document Viewer で、マウスまたはキーボード操作によってスクロールボックスが移動されると、ABBYY FineReader Engine から呼び出されます。 このメソッドは、スクロールバーのコード、スクロールボックスの位置、およびスクロールされた行数をクライアントに渡します。このメソッドを使用すると、操作をキャンセルできます。

構文

C++

HRESULT OnScroll(
  int           HorzScrollBarCode,
  int           VertScrollBarCode,
  int           Position,
  int           Count,
  VARIANT_BOOL* Cancel
);

C#

void OnScroll(
  int      HorzScrollBarCode,
  int      VertScrollBarCode,
  int      Position,
  int      Count,
  out bool Cancel
);

Visual Basic .NET

Sub OnScroll( _
  HorzScrollBarCode As Integer, _
  VertScrollBarCode As Integer, _
  Position As Integer, _
  Count As Integer, _
  ByRef Cancel As Boolean _
)

Parameter

HorzScrollBarCode [in] ユーザーのスクロール要求を示すスクロール バー コードを指定します。このParameterには、次のいずれかの値を指定できます。
  • SB_LEFT (6) — 左端までスクロールします。
  • SB_ENDSCROLL (8) — スクロールを終了します。
  • SB_LINELEFT (0) — 左にスクロールします。
  • SB_LINERIGHT (1) — 右にスクロールします。
  • SB_PAGELEFT (2) — 左に 1 ページ分スクロールします。
  • SB_PAGERIGHT (3) — 右に 1 ページ分スクロールします。
  • SB_RIGHT (7) — 右端までスクロールします。
  • SB_THUMBPOSITION (4) — 絶対位置までスクロールします。現在の位置は Position Parameterで指定します。
  • SB_THUMBTRACK (5) — スクロール ボックスを指定した位置までドラッグします。現在の位置は Position Parameterで指定します。
これらの定数は Winuser.h で定義されています。水平スクロールがなかった場合、このParameterは -1 になります。 VertScrollBarCode [in] ユーザーのスクロール要求を示すスクロール バー コードを指定します。このParameterには、次のいずれかの値を指定できます。
  • SB_BOTTOM (7) — 下端までスクロールします。
  • SB_ENDSCROLL (8) — スクロールを終了します。
  • SB_LINEDOWN (1) — 1 行下にスクロールします。
  • SB_LINEUP (0) — 1 行上にスクロールします。
  • SB_PAGEDOWN (3) — 1 ページ下にスクロールします。
  • SB_PAGEUP (2) — 1 ページ上にスクロールします。
  • SB_THUMBPOSITION (4) — 絶対位置までスクロールします。現在の位置は Position Parameterで指定します。
  • SB_THUMBTRACK (5) — スクロール ボックスを指定した位置までドラッグします。現在の位置は Position Parameterで指定します。
  • SB_TOP (6) — 上端までスクロールします。
これらの定数は Winuser.h で定義されています。垂直スクロールがなかった場合、このParameterは -1 になります。 Position [in] スクロール バー コードが SB_THUMBPOSITION または SB_THUMBTRACK の場合は、スクロール ボックスの位置を指定します。それ以外の場合は使用されません。 Count [in] スクロールがマウス ホイールで行われた場合、スクロールした行数が格納されます。 Cancel [out] この変数を TRUE に設定すると、処理を終了するよう指定できます。

戻り値

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

注記

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

関連項目

IInputEvents