Share via


SetScrollRange

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

This function sets the minimum and maximum position values for the specified scroll bar. It can also be used to hide or show a standard scroll bar. SetScrollRange is provided for compatibility with Windows 3.x. Win32-based applications should use the SetScrollInfo function.

Syntax

BOOL SetScrollRange( 
  HWND hWnd, 
  int nBar, 
  int nMinPos, 
  int nMaxPos, 
  BOOL bRedraw 
); 

Parameters

  • hWnd
    Handle to a scroll bar control or a window with a standard scroll bar, depending on the value of the nBar parameter.
  • nBar
    Specifies the scroll bar to be set. This parameter can be one of the following values.

    Value Description

    SB_CTL

    Sets the range of a scroll bar control. The hWnd parameter must be the handle to the scroll bar control.

    SB_HORZ

    Sets the range of a window's standard horizontal scroll bar.

    SB_VERT

    Sets the range of a window's standard vertical scroll bar.

  • nMinPos
    Specifies the minimum scrolling position.
  • nMaxPos
    Specifies the maximum scrolling position.
  • bRedraw
    Boolean that specifies whether the scroll bar should be redrawn to reflect the change. If this parameter is TRUE, the scroll bar is redrawn. If it is FALSE, the scroll bar is not redrawn.

Return Value

Nonzero indicates success. Zero indicates failure. To get extended error information, call GetLastError.

Remarks

You can use SetScrollRange to hide the scroll bar by setting nMinPos and nMaxPos to the same value. An application should not call the SetScrollRange function to hide a scroll bar while processing a scroll bar message.

If the call to SetScrollRange immediately follows a call to the SetScrollPos function, the bRedraw parameter in SetScrollPos must be zero to prevent the scroll bar from being drawn twice.

The default range for a standard scroll bar or a scroll bar control is 0 through 100. The difference between the values specified by the nMinPos and nMaxPos parameters must not be greater than the value of MAXLONG.

Because the messages that indicate scroll bar position, WM_HSCROLL and WM_VSCROLL, are limited to 16 bits of position data, applications that rely solely on those messages for position data have a practical maximum value of 65,535 for the SetScrollRange function's nMaxPos parameter.

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.

Requirements

Header winuser.h
Library Sbcmn.lib
Windows Embedded CE Windows CE 2.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also

Reference

GetScrollInfo
SetScrollPos
Scroll Bars Functions