getScrollRange 函数 (winuser.h)

项目
08/27/2023

GetScrollRange 函数检索当前最小和最大滚动框 (thumb) 指定滚动条的位置。

注意提供 GetScrollRange 函数仅用于兼容性。新应用程序应使用 GetScrollInfo 函数。

语法

BOOL GetScrollRange(
  [in]  HWND  hWnd,
  [in]  int   nBar,
  [out] LPINT lpMinPos,
  [out] LPINT lpMaxPos
);

参数

[in] hWnd

类型： HWND

滚动条控件或具有标准滚动条的窗口的句柄，具体取决于 nBar 参数的值。

[in] nBar

类型： int

指定从中检索位置的滚动条。此参数的取值可为下列值之一：

值	含义
SB_CTL	检索滚动条控件的位置。 hWnd 参数必须是滚动条控件的句柄。
SB_HORZ	检索窗口的标准水平滚动条的位置。
SB_VERT	检索窗口的标准垂直滚动条的位置。

[out] lpMinPos

类型： LPINT

指向接收最小位置的整数变量的指针。

[out] lpMaxPos

类型： LPINT

指向接收最大位置的整数变量的指针。

返回值

类型： BOOL

如果该函数成功，则返回值为非零值。

如果函数失败，则返回值为零。要获得更多的错误信息，请调用 GetLastError。

注解

如果指定的窗口没有标准滚动条或不是滚动条控件， 则 GetScrollRange 函数会将零复制到 lpMinPos 和 lpMaxPos 参数。

标准滚动条的默认范围为 0 到 100。滚动条控件的默认范围为空， (两个值都是零) 。

指示滚动条位置的消息（WM_HSCROLL 和 WM_VSCROLL）限制为 16 位位置数据。但是，由于 SetScrollInfo、 SetScrollPos、 SetScrollRange、 GetScrollInfo、 GetScrollPos 和 GetScrollRange 支持 32 位滚动条位置数据，因此有一种方法可以绕过 WM_HSCROLL 和 WM_VSCROLL 消息的 16 位屏障。有关技术的说明，请参阅 GetScrollInfo 函数。

如果 nBar 参数SB_CTL并且 hWnd 参数指定的窗口不是系统滚动条控件，则系统会将 SBM_GETRANGE 消息发送到窗口以获取滚动条信息。这允许 GetScrollRange 在模拟滚动条的自定义控件上运行。如果窗口不处理 SBM_GETRANGE 消息， 则 GetScrollRange 函数将失败。

要求


最低受支持的客户端	Windows Vista [仅限桌面应用]
最低受支持的服务器	Windows Server 2003 [仅限桌面应用]
目标平台	Windows
标头	winuser.h (包括 Windows.h)
Library	User32.lib
DLL	User32.dll