The GetScrollRange function retrieves the current minimum and maximum scroll box (thumb) positions for the specified scroll bar.
The GetScrollRange function is provided for compatibility only. New applications should use the GetScrollInfo function.
BOOL GetScrollRange(
HWND hWnd, // handle to window with scroll bar
int nBar, // scroll bar flags
LPINT lpMinPos,
// address of variable that receives minimum position
LPINT lpMaxPos
// address of variable that receives maximum position
);
Value | Meaning |
---|---|
SB_CTL | Retrieves the positions of a scroll bar control. The hWnd parameter must be the handle to the scroll bar control. |
SB_HORZ | Retrieves the positions of the window's standard horizontal scroll bar. |
SB_VERT | Retrieves the positions of the window's standard vertical scroll bar. |
If the function succeeds, the return value is nonzero.
If the function fails, the return value is zero. To get extended error information, call GetLastError.
If the specified window does not have standard scroll bars or is not a scroll bar control, the GetScrollRange function copies zero to the lpMinPos and lpMaxPos parameters.
The default range for a standard scroll bar is 0 through 100. The default range for a scroll bar control is empty (both values are zero).
The messages that indicate scroll bar position, WM_HSCROLL and WM_VSCROLL, are limited to 16 bits of position data. However, because SetScrollInfo, SetScrollPos, SetScrollRange, GetScrollInfo, GetScrollPos, and GetScrollRange 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 the GetScrollInfo function for a description of the technique.
Windows NT: Requires version 3.1 or later.
Windows: Requires Windows 95 or later.
Windows CE: Unsupported.
Header: Declared in winuser.h.
Import Library: Use user32.lib.
Scroll Bars Overview, Scroll Bar Functions, GetScrollInfo, GetScrollPos, SetScrollInfo, SetScrollPos, SetScrollRange, WM_HSCROLL, WM_VSCROLL