导航:  Windows Controls Wrapper Functions > Scroll Bar Control > Functions >

SetScrollRange

上一页返回章节概述下一页

描述

 

SetScrollRange功能设置指定滚动条的最小和最大滚动框位置。

 

Note SetScrollRange功能用于向后兼容。

 

C/C++ 语法

 

BOOL SetScrollRange(

HWND hwnd,

int nBar,

int nMinPos,

int nMaxPos,

BOOL bRedraw

);

 

PB语法

 

FUNCTION SetScrollRange ( _

BYVAL hwnd AS DWORD, _

BYVAL nBar AS LONG, _

BYVAL nMinPos AS LONG, _

BYVAL nMaxPos AS LONG, _

BYVAL bRedraw AS LONG _

) AS LONG

 

参数

 

hwnd

[in]根据nBar参数的值,处理滚动条控件或带有标准滚动条的窗口。

nBar

[in]指定要设置的滚动条。

 

SB_CTL

在滚动条控件中设置滚动框的位置。

SB_HORZ

在窗口的标准水平滚动条中设置滚动框的位置。

SB_VERT

在窗口的标准垂直滚动条中设置滚动框的位置。

nMinPos

[in]指定最小滚动位置。

nMaxPos

[in]指定最大滚动位置。

bRedraw

[in]指定是否重新绘制滚动条以反映新的滚动框位置。

 

返回值

 

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

 

如果函数失败,返回值为零。

 

备注

 

您可以使用SetScrollRangenMinPosnMaxPos设置为相同的值来隐藏滚动条。

 

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

 

标准滚动条的默认范围为0到100.滚动条控件的默认范围为空(nMinPosnMaxPos参数值均为零)。

 

因为指示滚动条位置的消息WM_HSCROLLWM_VSCROLL被限制为16位的位置数据,所以仅依赖这些位置数据的消息的应用程序对SetScrollRange函数的SetScrollRange函数的实际最大值为65,535

 

但是,由于SetScrollInfoSetScrollPosSetScrollRangeGetScrollInfoGetScrollPosGetScrollRange功能支持32位滚动条位置数据,因此有一种方法来规避16位屏障

 

如果nBar参数是SB_CTL,并且由hWnd参数指定的窗口不是系统滚动条控件,系统会向窗口发送SBM_SETRANGE消息以设置滚动条信息。

 

最低操作系统

 

Windows 95,Windows NT 3.51。

 

引用文件 #INCLUDE Once

 

WinUser.inc