函数功能:
GetScrollRange 函数获得指定滚动条的范围。
注意:GetScrollRange 函数提供了向后的兼容性。但新的应用程序应该提倡使用 GetScrollInfo 函数代替。
API 函数原型:
注释:_In_ 说明该参数是输入的,_opt_ 说明该参数是可选参数。
BOOL GetScrollRange( _In_ HWND hWnd, _In_ int nBar, _Out_ LPINT lpMinPos, _Out_ LPINT lpMaxPos );
参数解析:
|
参数 |
含义 |
|
hWnd |
1. 滚动条控件的句柄或带有标准滚动条窗体的句柄 |
|
nBar |
指定将要设置哪类滚动条的参数: |
|
lpMinPos |
指向存放最小位置的整型变量 |
|
lpMaxPos |
指向存放最大位置的整型变量 |
返回值:
1. 如果函数调用成功,返回值是非 0;
2. 如果函数调用失败,返回值是 0。
备注:
1. 如果指定的窗口没有标准的滚动条或不是滚动条控件,GetScrollRange 函数将零复制到 lpMinPos 和 lpMaxPos 参数中。
2. 标准滚动条的默认范围是 0 到 100。滚动条控件的缺省值为空。
3. 因为说明滚动条位置的消息 WM_HSCROLL 和 WM_VSCROLL 是 16 位数据,所以那些只依赖于说明位置数据消息的应用程序在 SetScrollRange 函数的参数 nMaxPos 中有一个实际最大值 65,535。但是,因为 SetScrolllnfo,SetScrollPos, SetScrollRange,GetScrolllnfo,GetScrollPos 和 GetScrollRange 函数都支持 32 位的滚动条位置数据,所以有一个解决 16 位 WM_HSCROLL 和 WM_VSCROLL 消息阻碍的途径,请参见函数 GetScrolllnfo 的有关技术说明。
4. 如果参数 nBar 设置为 SB_CTL 并且参数 hWnd 所标识的不是一个标准的滚动条控件。系统将发送一个 SBM_GETRANGE 消息到窗体用以设置滚动条消息。这将允许 GetScrollRange 函数操作一个定制的伪滚动条控件。如果窗体没有处理 SBM_GETRANGE 消息,GetScrollRange 函数将调用失败。




