CWnd::OnVScroll

[アーティクル]
09/17/2008

更新 : 2007 年 11 月

ウィンドウの垂直スクロールバーをクリックしたとき、フレームワークからこのメンバ関数が呼び出されます。

afx_msg void OnVScroll(
   UINT nSBCode,
   UINT nPos,
   CScrollBar* pScrollBar 
);

パラメータ

nSBCode
スクロール要求を示すスクロールバーのコードを指定します。このパラメータには、次のいずれかの値を指定できます。
- SB_BOTTOM 一番下までスクロール。
- SB_ENDSCROLL スクロール終了。
- SB_LINEDOWN 1 行下へスクロール。
- SB_LINEUP 1 行上へスクロール。
- SB_PAGEDOWN 1 ページ下へスクロール。
- SB_PAGEUP 1 ページ上へスクロール。
- SB_THUMBPOSITION 絶対位置へスクロール。現在位置はパラメータ nPos で指定されます。
- SB_THUMBTRACK スクロールボックスを指定位置へドラッグ。現在位置はパラメータ nPos で指定されます。
- SB_TOP 一番上までスクロール。
nPos
スクロールバーのコードが SB_THUMBPOSITION または SB_THUMBTRACK の場合は、スクロールボックスの現在位置を指定します。それ以外の場合は使いません。初期スクロール範囲によっては、nPos が負になることもあるので、必要に応じて int にキャストします。
pScrollBar
スクロールバーコントロールからメッセージが送られた場合は、コントロールへのポインタになります。ユーザーがウィンドウのスクロールバーをクリックした場合は、このパラメータは NULL になります。このポインタは一時的である場合があるので、後で使用するために保持しておくことはできません。

解説

OnVScroll は、通常、スクロールボックスがドラッグされているときに、アプリケーションがフィードバックを行うために使用されます。

OnVScroll 関数で CWnd オブジェクトの内容をスクロールする場合は、SetScrollPos メンバ関数を使ってスクロールボックスの位置をリセットする必要があります。

メモ :
このメンバ関数は、アプリケーションが Windows メッセージを処理できるようにするためにフレームワークによって呼び出されます。この関数に渡されるパラメータの値は、フレームワークがメッセージ受信時に受け取ったパラメータの値に基づいています。この関数の基本クラスの実装を呼び出した場合は、関数に渡したパラメータではなく、メッセージと共に渡されたパラメータ自体が使用されます。

このメンバ関数は、アプリケーションが Windows メッセージを処理できるようにするためにフレームワークによって呼び出されます。この関数に渡されるパラメータの値は、フレームワークがメッセージ受信時に受け取ったパラメータの値に基づいています。この関数の基本クラスの実装を呼び出した場合は、関数に渡したパラメータではなく、メッセージと共に渡されたパラメータ自体が使用されます。