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 (デスクトップ アプリのみ)
ヘッダー	Winuser.h (Windows.h を含む)

関連項目

リファレンス

GetScrollInfo

GetScrollPos

GetScrollRange

SetScrollInfo

SetScrollPos

SetScrollRange

WM_HSCROLL

WM_VSCROLL (トラックバー)