WM_HSCROLL メッセージ

  • [アーティクル]

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

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

WM_HSCROLL

    WPARAM wParam
    LPARAM lParam;

パラメーター

wParam

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

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

Value 意味
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 です。

ただし、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