WM_VSCROLL メッセージ
WM_VSCROLL メッセージは、ウィンドウの標準垂直スクロール バーでスクロール イベントが発生すると、ウィンドウに送信されます。 このメッセージは、コントロールでスクロール イベントが発生したときに、垂直スクロール バー コントロールの所有者にも送信されます。
ウィンドウは、WindowProc 関数を介してこのメッセージを受け取ります。
WM_VSCROLL
WPARAM wParam
LPARAM lParam;
パラメーター
-
wParam
-
HIWORD は、LOWORD が SB_THUMBPOSITION または SB_THUMBTRACK である場合、スクロール ボックスの現在の位置を指定し、それ以外の場合はこのワードは使用されません。
LOWORD は、ユーザーのスクロール要求を示すスクロール バー値を指定します。 このパラメーターには、次の値のいずれかを指定できます。
値 意味 - SB_BOTTOM
右下にスクロールします。 - SB_ENDSCROLL
スクロールを終了します。 - SB_LINEDOWN
1 行下にスクロールします。 - SB_LINEUP
1 行上にスクロールします。 - SB_PAGEDOWN
1 ページ下にスクロールします。 - SB_PAGEUP
1 ページ上にスクロールします。 - SB_THUMBPOSITION
ユーザーがスクロール ボックス (つまみ) をドラッグし、マウス ボタンを離しました。 HIWORD は、ドラッグ操作の最後のスクロール ボックスの位置を示します。 - SB_THUMBTRACK
ユーザーがスクロール ボックスをドラッグしています。 このメッセージは、ユーザーがマウス ボタンを離すまで繰り返し送信されます。 HIWORD は、スクロール ボックスのドラッグ先の位置を示します。 - SB_TOP
左上にスクロールします。 -
lParam
-
このメッセージがスクロール バー コントロールによって送信された場合、このパラメーターはスクロール バー コントロールへのハンドルになります。 このメッセージが標準スクロール バーによって送信された場合、このパラメーターは NULL になります。
戻り値
アプリケーションでこのメッセージを処理する場合は、0 を返す必要があります。
解説
SB_THUMBTRACK 要求コードは、通常、ユーザーがスクロール ボックスをドラッグしたときのフィードバックを提供するアプリケーションで使用されます。
アプリケーションがウィンドウの内部をスクロールする場合は、SetScrollPos 関数を使用してスクロール ボックスの位置もリセットする必要があります。
WM_VSCROLL メッセージが伝達するのは、16 ビットのスクロール ボックス位置データだけであることに注意してください。 したがって、スクロール位置データに関して WM_VSCROLL (および WM_HSCROLL) にのみ頼るアプリケーションが持つ実用上の最大の位置の値は 65,535 です。
ただし、SetScrollInfo、SetScrollPos、SetScrollRange、GetScrollInfo、GetScrollPos、GetScrollRange 関数は 32 ビットのスクロール バー位置データをサポートするため、WM_HSCROLL と WM_VSCROLL メッセージの 16 ビットのバリアを回避する方法が存在します。 この手法の説明については、GetScrollInfo を参照してください。
要件
| 要件 | Value |
|---|---|
| サポートされている最小のクライアント |
Windows Vista [デスクトップ アプリのみ] |
| サポートされている最小のサーバー |
Windows Server 2003 (デスクトップ アプリのみ) |
| ヘッダー |
|