SetScrollRange

【勇芳软件工作室】汉化HomePreviousNext

SetScrollRange函数设置指定滚动条的最小和最大位置值。它也可用于隐藏或显示标准滚动条。SetScrollRange功能用于与Windows 3兼容。【x】.基于Win32的应用程序应使用SetScrollInfo功能。

BOOL SetScrollRange(

HWND 【的hWnd】,//用滚动条来处理窗口
INT 【NBAR】,//滚动条标志
INT 【nMinPos】,//最小滚动位置
INT 【nMaxPos】,//最大滚动位置
BOOL 【bRedraw】//重绘旗帜
); 

参数

【的hWnd】

根据【NBAR】参数的值,标识滚动条控件或带有标准滚动条的窗口。

【NBAR】

指定要设置的滚动条。此参数可以是以下值之一:

含义
SB_CTL设置滚动条控件的范围。【的hWnd】参数必须是滚动条控件的句柄。
SB_HORZ设置窗口标准水平滚动条的范围。
SB_VERT设置窗口的标准垂直滚动条的范围。

【nMinPos】

指定最小滚动位置。

【nMaxPos】

指定最大滚动位置。

【bRedraw】

指定滚动条是否应重新绘制以反映更改。如果此参数为TRUE,则重新绘制滚动条。如果为FALSE,则不重绘滚动条。

返回值

如果函数成功,返回值不为零。

如果函数失败,返回值为零。要获取扩展错误信息,请调用GetLastError.

备注

处理滚动条消息时,应用程序不应调用SetScrollRange功能来隐藏滚动条。

如果对SetScrollPos功能的呼叫立即进行调用,则SetScrollPos中的【bRedraw】参数必须为零,以防止滚动条被绘制两次。

标准滚动条的默认范围为0到100。滚动条控件的默认范围为空(【nMinPos】【nMaxPos】参数值都为零)。由【nMinPos】【nMaxPos】参数指定的值之间的差值不得大于MAXLONG的值。

因为指示滚动条位置的消息WM_HSCROLL和WM_VSCROLL被限制为16位的位置数据,所以仅依赖这些消息的位置数据的应用程序对SetScrollRange函数的【nMaxPos】参数具有65,535的实际最大值。

但是,由于SetScrollPosSetScrollRangeGetScrollPosGetScrollRange功能支持32位滚动条位置数据,因此可以避免WM_HSCROLL和WM_VSCROLL消息的16位屏障。有关技术及其限制的描述,请参阅GetScrollPos.

也可以看看

GetScrollPos, GetScrollRange, SetScrollPos