GetScrollBarInfo 函数 (winuser.h)

  • 项目

GetScrollBarInfo 函数检索有关指定滚动条的信息。

语法

BOOL GetScrollBarInfo(
  [in]  HWND           hwnd,
  [in]  LONG           idObject,
  [out] PSCROLLBARINFO psbi
);

参数

[in] hwnd

类型： HWND

与要检索其信息的滚动条关联的窗口的句柄。 如果 idObject 参数OBJID_CLIENT， 则 hwnd 是滚动条控件的句柄。 否则， hwnd 是使用 WS_VSCROLL 和/或WS_HSCROLL样式创建的窗口 的 句柄。

[in] idObject

类型： LONG

指定滚动条对象。 此参数的取值可为下列值之一：

值 含义
OBJID_CLIENT
 hwnd 参数是滚动条控件的句柄。
OBJID_HSCROLL
 hwnd 窗口的水平滚动条。
OBJID_VSCROLL
 hwnd 窗口的垂直滚动条。

[out] psbi

类型： PSCROLLBARINFO

指向 SCROLLBARINFO 结构的指针，用于接收信息。 在调用 GetScrollBarInfo 之前，请将 cbSize 成员设置为 sizeof (SCROLLBARINFO) 。

返回值

类型： BOOL

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

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

注解

如果 idObject OBJID_CLIENT并且 hwnd 指定的窗口不是系统滚动条控件，则系统会将 SBM_GETSCROLLBARINFO 消息发送到窗口以获取滚动条信息。 这允许 GetScrollBarInfo 对模拟滚动条的自定义控件进行操作。 如果窗口不处理 SBM_GETSCROLLBARINFO 消息， 则 GetScrollBarInfo 函数将失败。

要求

要求 值
最低受支持的客户端 Windows Vista [仅限桌面应用]
最低受支持的服务器 Windows Server 2003 [仅限桌面应用]
目标平台 Windows
标头 winuser.h (包括 Windows.h)
Library User32.lib
DLL User32.dll
可再发行组件 Service Pack 6
API 集 在 Windows 8.1) 中引入的 ext-ms-win-ntuser-misc-l1-2-0 (

另请参阅

SCROLLBARINFO