Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
A version of this page is also available for
4/8/2010

This structure contains scroll bar parameters to be set by the SetScrollInfofunction or retrieved by the GetScrollInfofunction.

Syntax

typedef struct tagSCROLLINFO {
  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 nPagemember contains the page size for a proportional scroll bar.

SIF_POS

The nPosmember contains the scroll box position, which is not updated while the user drags the scroll box.

SIF_RANGE

The nMinand nMaxmembers contain the minimum and maximum values for the scrolling range.

SIF_TRACKPOS

The nTrackPosmember 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 message. An application cannot set the immediate scroll position; the SetScrollInfofunction ignores this member.

Requirements

Header winuser.h
Windows Embedded CE Windows CE 1.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also