SCROLLINFO结构的使用

在窗口程序中添加滚动条很容易,只要在CreateWindow中将WS(window style)添加WS_VSCROLL与WS_HSCROLL即可,然后再调用相应的函数就可以使用了。
滚动条有范围和位置(滚动框在滚动条上的位置)属性,设置范围和位置可以使用之前的函数,如:SetScrollRange()、SetScrollPos()、GetScrollRange()、GetScrollPos()等,但目前通常使用SetScrollInfo()与GetScrollInfo(),使用这两个函数就要用到SCROLLINFO结构。
可以先定义一个SCROLLINFO结构变量si,用&si作为以上两个函数的参数。同BeginPaint()中的&ps、GetTextMetrics()中的&tm等,这些结构都是通过这些函数被填充各域或取得各域的值。BeginPaint是填充ps的各域的值,GetTextMetrics是取得tm结构各域的值,而SetScrollInfo()与GetScrollInfo()分别填充和取得。
无论是Set还是Get,都得先设置si结构的第一个域的值,即赋给cbSize结构的大小。之后根据设置的fMask域的值进行Set或Get,当Set时,需要根据fMask的值将相关的域填充后再调用SetScrollInfo(),这样si结构就被Set成功。当Get时,直接调用GetScrollInfo(),具体能使用哪些域的值是根据所设置的fMask域的值定的。
如:当要设置滚动条的范围和页面大小时,可写以下类似的代码:

   si.cbSize = sizeof (SCROLLINFO) ; 
si.cbMask = SIF_RANGE | SIF_PAGE ;
si.nMin = 0 ;
si.nMax = NUMLINES - 1 ;
si.nPage = cyClient / cyChar ;
SetScrollInfo (hwnd, SB_VERT, &si, TRUE) ;
而若要用到滚动条的位置时,可以这样使用:
先si.cbSize = sizeof (si) ;
si.fMask = SIF_ALL ; // 表示Get后将使用si结构的位置、页面大小等量
GetScrollInfo (hwnd, SB_VERT, &si)
然后就可直接使用si.nPos、si.nPage、si.nTrackPos等量,这些量就是从si结构中通过Get函数
获得的,
也是之前通过Set函数设置的值。

SCROLLINFO结构:

The SCROLLINFO structure contains scroll bar parameters to be set by the SetScrollInfo

function (or SBM_SETSCROLLINFO message), or retrieved by the GetScrollInfo function

(or SBM_GETSCROLLINFO message).

typedef struct tagSCROLLINFO {

UINT cbSize;

UINT fMask;

int nMin;

int nMax;

UINT nPage;

int nPos;

int nTrackPos;

} SCROLLINFO, *LPSCROLLINFO;

typedef SCROLLINFO CONST *LPCSCROLLINFO;

成员说明:
cbSize: SCROLLINFO结构长度字节数,该值在设置和查询参数时都必须填写。
fMask: 指定结构中的哪些成员是有效,该值共有如下5种选择,可以选择多种用“OR”组合起来,该值在

设置和查询参数时都必须填写。
SIF_ALL      :整个结构都有效
SIF_DISABLENOSCROLL:该值仅在设定参数时使用,视控件参数设定的需要来对本结构的成员进行取舍。
SIF_PAGE      :nPage成员有效
SIF_POS      :nPos成员有效
SIF_RANGE     :nMin和nMax成员有效
nMin:滚动范围最小值
nMax:滚动范围最大值
nPage:页尺寸,用来确定比例滚动框的大小
nPos:滚动框的位置
nTrackPos:拖动时滚动框的位置,该参数只能查询,不能设置。

你可能感兴趣的:(Windows,程序设计)