SCROLLINFO

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

This structure contains scroll bar parameters to be set by the SetScrollInfo function or retrieved by the GetScrollInfo function.

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 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 message. An application cannot set the immediate scroll position; the SetScrollInfo function 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

Reference

SBM_GETSCROLLINFO
SBM_SETSCROLLINFO
GetScrollInfo
SetScrollInfo
Scroll Bars Structures