Prev Next

WM_HSCROLL Overview  Group

The WM_HSCROLL message is sent to a window when a scroll event occurs in the window’s standard horizontal scroll bar. This message is also sent to the owner of a horizontal scroll bar control when a scroll event occurs in the control. 

WM_HSCROLL 

nScrollCode = (int) LOWORD(wParam);  // scroll bar value 

nPos = (short int) HIWORD(wParam);   // scroll box position 

hwndScrollBar = (HWND) lParam;       // handle of scroll bar 

 

Parameters

nScrollCode
Value of the low-order word of wParam. Specifies a scroll bar value that indicates the user’s scrolling request. This parameter can be one of the following values:

Value

Meaning

SB_BOTTOM

Scrolls to the lower right.

SB_ENDSCROLL

Ends scroll.

SB_LINELEFT

Scrolls left by one unit.

SB_LINERIGHT

Scrolls right by one unit.

SB_PAGELEFT

Scrolls left by the width of the window.

SB_PAGERIGHT

Scrolls right by the width of the window.

SB_THUMBPOSITION

The user has dragged the scroll box (thumb) and released the mouse button. The nPos parameter indicates the position of the scroll box at the end of the drag operation.

SB_THUMBTRACK

The user is dragging the scroll box. This message is sent repeatedly until the user releases the mouse button. The nPos parameter indicates the position that the scroll box has been dragged to.

SB_TOP

Scrolls to the upper left.

nPos
Value of the high-order word of wParam. Specifies the current position of the scroll box if the nScrollCode parameter is SB_THUMBPOSITION or SB_THUMBTRACK; otherwise, nPos is not used.
hwndScrollBar
Value of lParam. If the message is sent by a scroll bar, then hwndScrollBar is the handle of the scroll bar control. If the message is not sent by a scroll bar, hwndScrollBar is NULL.

Return Values

If an application processes this message, it should return zero.

Remarks

The SB_THUMBTRACK notification message is typically used by applications that provide feedback as the user drags the scroll box.

If an application scrolls the content of the window, it must also reset the position of the scroll box by using the SetScrollPos function.

Note that the WM_HSCROLL message carries only 16 bits of scroll box position data. Thus, applications that rely solely on WM_HSCROLL (and WM_VSCROLL) for scroll position data have a practical maximum position value of 65,535.

However, because the SetScrollInfo, SetScrollPos, SetScrollRange, GetScrollInfo, GetScrollPos, and GetScrollRange functions support 32-bit scroll bar position data, there is a way to circumvent the 16-bit barrier of the WM_HSCROLL and WM_VSCROLL messages. See GetScrollInfo for a description of the technique.

See Also

GetScrollInfo, GetScrollPos, GetScrollRange, SetScrollInfo, SetScrollPos, SetScrollRange, WM_VSCROLL