卷动列文件（在/Platform SDK/User Interface Services/Controls/Scroll Bars中）指出SetScrollRange、SetScrollPos、GetScrollRange和GetScrollPos函式是「过时的」，但这并不完全正确。这些函式在Windows 1.0中就出现了，在Win32 API中升级以处理32位元参数。它们仍然具有良好的功能。而且，它们不与Windows程式设计中新函式相冲突。

特点

功能

用法

定义

结构

特点

Win32 API介绍的两个卷动列函式称作SetScrollInfo和GetScrollInfo。这些函式可以完成以前函式的全部功能，并增加了两个新特性。

第一个功能涉及卷动方块的大小。您可能注意到，卷动方块大小在SYSMETS2程式中是固定的。然而，在您可能使用到的一些Windows应用程式中，卷动方块大小与在视窗中显示的文件大小成比例。显示的大小称作「页面大小」。

可以使用SetScrollInfo来设置页面大小（从而设置了卷动方块的大小），如将要看到的SYSMETS3程式所示。

功能

GetScrollInfo函式增加了第二个重要的功能，或者说它改进了目前API的不足。假设您要使用65,536或更大单位的范围，这在16位元Windows中是不可能的。当然在Win32中，函式被定义为可接受32位元参数，因此是没有问题的。（记住如果使用这样大的范围，卷动方块的实际物理位置数仍然由卷动列的图素大小限制）。然而，当使用SB_THUMBTRACK或SB_THUMBPOSITION通知码得到WM_VSCROLL或WM_HSCROLL讯息时，只提供了16位元资料来指出卷动方块的目前位置。通过GetScrollInfo函式可以取得真实的32位元值。

用法

SetScrollInfo和GetScrollInfo函式的语法是

SetScrollInfo (hwnd, iBar, &si, bRedraw) ;

GetScrollInfo (hwnd, iBar, &si) ;

像在其他卷动列函式中那样，iBar参数是SB_VERT或SB_HORZ，它还可以是用於卷动列控制的SB_CTL。SetScrollInfo的最後一个参数可以是TRUE或FALSE，指出了是否要Windows重新绘制计算了新资讯後的卷动列。

定义

两个函式的第三个参数是SCROLLINFO结构，定义为：

typedef struct tagSCROLLINFO

{

UINT cbSize ; // set to sizeof (SCROLLINFO)

UINT fMask ; // values to set or get

int nMin ; // minimum range value

int nMax ; // maximum range value

UINT nPage ; // page size

int nPos ; // current position

int nTrackPos ;// current tracking position

}

SCROLLINFO, * PSCROLLINFO ;

结构

在程式中，可以定义如下的SCROLLINFO结构型态：

SCROLLINFO si ;

在呼叫SetScrollInfo或GetScrollInfo之前，必须将cbSize栏位设定为结构的大小：

si.cbSize = sizeof (si) ;

或

si.cbSize = sizeof (SCROLLINFO) ;

逐渐熟悉Windows後，您就会发现另外几个结构像这个结构一样，第一个栏位指出了结构大小。这个栏位使将来的Windows版本可以扩充结构并添加新的功能，并且仍然与以前编译的版本相容。

把fMask栏位设定为一个以上以SIF字首开头的旗标，并且可以使用C的位元操作OR运算子(|)组合这些旗标。

SetScrollInfo函式使用SIF_RANGE旗标时，必须把nMin和nMax栏位设定为所需的卷动列范围。GetScrollInfo函式使用SIF_RANGE旗标时，应把nMin和nMax栏位设定为从函式传回的目前范围。

SIF_POS旗标也一样。当通过SetScrollInfo使用它时，必须把结构的nPos栏位设定为所需的位置。可以通过GetScrollInfo使用SIF_POS旗标来取得目前位置。

使用SIF_PAGE旗标能够取得页面大小。用SetScrollInfo函式把nPage设定为所需的页面大小。GetScrollInfo使用SIF_PAGE旗标可以取得目前页面的大小。如果不想得到比例化的卷动列，就不要使用该旗标。

当处理带有SB_THUMBTRACK或SB_THUMBPOSITION通知码的WM_VSCROLL或WM_HSCROLL讯息时，通过GetScrollInfo只使用SIF_TRACKPOS旗标。从函式的传回中，SCROLLINFO结构的nTrackPos栏位将指出目前的32位元的卷动方块位置。

在SetScrollInfo函式中仅使用SIF_DISABLENOSCROLL旗标。如果指定了此旗标，而且新的卷动列参数使卷动列消失，则该卷动列就不能使用了（下面会有更多的解释）。

SIF_ALL旗标是SIF_RANGE、SIF_POS、SIF_PAGE和SIF_TRACKPOS的组合。在WM_SIZE讯息处理期间设置卷动列参数时，这是很方便的（在SetScrollInfo函式中指定SIF_TRACKPOS後，它会被忽略）。这在处理卷动列讯息时也是很方便的。