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 (デスクトップ アプリのみ) |
| ヘッダー |
|