WM_HSCROLL メッセージ

WM_HSCROLL メッセージは、ウィンドウの標準水平スクロール バーでスクロール イベントが発生したときにウィンドウに送信されます。 このメッセージは、コントロールでスクロール イベントが発生したときに、水平スクロール バー コントロールの所有者にも送信されます。

ウィンドウは、 WindowProc 関数を介してこのメッセージを受信します。

WM_HSCROLL

    WPARAM wParam
    LPARAM lParam; 

パラメーター

wParam

LOWORD がSB_THUMBPOSITIONまたはSB_THUMBTRACKの場合、HIWORD はスクロール ボックスの現在位置を指定します。それ以外の場合、この単語は使用されません。

LOWORD は、ユーザーのスクロール要求を示すスクロール バー値を指定します。 この単語には、次のいずれかの値を指定できます。

説明
SB_ENDSCROLL
スクロールを終了します。
SB_LEFT
左上にスクロールします。
SB_RIGHT
右下にスクロールします。
SB_LINELEFT
1 単位ずつ左にスクロールします。
SB_LINERIGHT
1 単位ずつ右にスクロールします。
SB_PAGELEFT
ウィンドウの幅を左にスクロールします。
SB_PAGERIGHT
ウィンドウの幅を右にスクロールします。
SB_THUMBPOSITION
ユーザーがスクロール ボックス (親指) をドラッグし、マウス ボタンを離しました。 HIWORD は、ドラッグ操作の最後にあるスクロール ボックスの位置を示します。
SB_THUMBTRACK
ユーザーがスクロール ボックスをドラッグしています。 このメッセージは、ユーザーがマウス ボタンを離すまで繰り返し送信されます。 HIWORD は、スクロール ボックスがドラッグされた位置を示します。

lParam

メッセージがスクロール バー コントロールによって送信される場合、このパラメーターはスクロール バー コントロールへのハンドルです。 メッセージが標準のスクロール バーによって送信される場合、このパラメーターは NULL です

戻り値

アプリケーションがこのメッセージを処理すると、0 が返されます。

解説

SB_THUMBTRACK要求コードは、通常、ユーザーがスクロール ボックスをドラッグするとフィードバックを提供するアプリケーションで使用されます。

アプリケーションがウィンドウの内容をスクロールする場合は、 SetScrollPos 関数を使用してスクロール ボックスの位置もリセットする必要があります。

WM_HSCROLL メッセージには、スクロール ボックス位置データの 16 ビットのみが含まれます。 したがって、スクロール位置データの WM_HSCROLL (および WM_VSCROLL) のみに依存するアプリケーションの実際の最大位置値は 65,535 です。

ただし、 SetScrollInfoSetScrollPosSetScrollRangeGetScrollInfoGetScrollPosおよび GetScrollRange 関数は 32 ビットのスクロール バー位置データをサポートしているため、 WM_HSCROLL メッセージと WM_VSCROLL メッセージの 16 ビット バリアを回避する方法があります。 この手法の説明については、 GetScrollInfo を参照してください。

必要条件

要件
サポートされている最小のクライアント
Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー
Windows Server 2003 [デスクトップ アプリのみ]
Header
Winuser.h (Windows.h を含む)

関連項目

参照

GetScrollInfo

GetScrollPos

GetScrollRange

SetScrollInfo

SetScrollPos

SetScrollRange

WM_HSCROLL (トラックバー)

WM_VSCROLL