windows_programming_notes.nbk: Home | Index | Next Page: Scroll Bar Controls in Win32 | Previous Page: Sandbox

 SBM_SETRANGE

The SBM_SETRANGE message is sent to set the minimum and maximum position values for the scroll bar control.

Applications should not send this message directly. Instead, they should use the SetScrollRange function. A window receives this message through its WindowProc function. Applications which implement a custom scroll bar control must respond to these messages for the SetScrollRange function to work properly.

Syntax

To send this message, call the SendMessage function as follows.

    lResult = SendMessage(      // returns LRESULT in lResult     
        (HWND) hWndControl,     // handle to destination control     
        (UINT) SBM_SETRANGE,    // message ID     
        (WPARAM) wParam,        // = (WPARAM) () wParam;    
        (LPARAM) lParam         // = (LPARAM) () lParam; 
    );   

Parameters

• wParam
  Specifies the minimum scrolling position.
• lParam
  Specifies the maximum scrolling position.

Return Value

ComCtl32.dll version 5.0: If the position of the scroll box changed, the return value is the previous position of the scroll box; otherwise, it is zero. ComCtl32.dll version 6.0: The current position of the scroll box, regardless of whether it has changed.

Remarks

The default minimum and maximum position values are zero. The difference between the values specified by the wParam and lParam parameters must not be greater than MAXLONG.

If the minimum and maximum position values are equal, the scroll bar control is hidden and, in effect, disabled.

Message Information

• Header Declared in Winuser.h, include Windows.h
• Minimum operating systems Windows 95, Windows NT 3.1

windows_programming_notes.nbk: Home | Index | Next Page: Scroll Bar Controls in Win32 | Previous Page: Sandbox

Notebook exported on Monday, 7 July 2008, 18:56:50 PM Eastern Daylight Time