This structure contains scroll bar parameters to be set by the SetScrollInfo function or retrieved by the GetScrollInfo function.
At a Glance
Header file: | Winuser.h |
Windows CE versions: | 1.0 and later |
Syntax
typedef struct tagSCROLLINFO { // si
UINT cbSize;
UINT fMask;
int nMin;
int nMax;
UINT nPage;
int nPos;
int nTrackPos;
} SCROLLINFO;
typedef SCROLLINFO FAR *LPSCROLLINFO;
Members
cbSize
Specifies the size, in bytes, of this structure.
fMask
Specifies the scroll bar parameters to set or retrieve. It can be a combination of the following values:
Value | Description |
SIF_ALL | Combination of SIF_PAGE, SIF_POS, SIF_RANGE, and SIF_TRACKPOS. |
SIF_DISABLENOSCROLL | This value is used only when setting a scroll bar’s parameters. If the scroll bar’s new parameters make the scroll bar unnecessary, disable the scroll bar instead of removing it. |
SIF_PAGE | The nPage member contains the page size for a proportional scroll bar. |
SIF_POS | The nPos member contains the scroll box position, which is not updated while the user drags the scroll box. |
SIF_RANGE | The nMin and nMax members contain the minimum and maximum values for the scrolling range. |
SIF_TRACKPOS | The nTrackPos member contains the current position of the scroll box while the user is dragging it. |
nMin
Specifies the minimum scrolling position.
nMax
Specifies the maximum scrolling position.
nPage
Specifies the page size. A scroll bar uses this value to determine the appropriate size of the proportional scroll box.
nPos
Specifies the position of the scroll box.
nTrackPos
Specifies the immediate position of a scroll box that the user is dragging. An application can retrieve this value while processing the SB_THUMBTRACK notification message. An application cannot set the immediate scroll position; the SetScrollInfo function ignores this member.
See Also
SBM_GETSCROLLINFO, SBM_SETSCROLLINFO, GetScrollInfo, SetScrollInfo