SBM_GETSCROLLINFO消息

发送 SBM_GETSCROLLINFO 消息以检索滚动条的参数。

应用程序不应直接发送此消息。 相反，它们应使用 GetScrollInfo 函数。 窗口通过其 WindowProc 函数接收此消息。 实现自定义滚动条控件的应用程序必须响应这些消息， GetScrollInfo 函数才能正常工作。

参数

wParam

未使用此参数。

lParam

指向 SCROLLINFO 结构的指针。 在调用 GetScrollInfo 之前，请将 结构的 cbSize 成员设置为 sizeof (SCROLLINFO) ，并将 fMask 成员设置为指定要检索的滚动条参数。 在返回之前，消息将指定的参数复制到结构的相应成员。

fMask 成员可以是以下一个或多个值。

值	含义
SIF_ALL	SIF_PAGE、SIF_POS、SIF_RANGE和SIF_TRACKPOS的组合。
SIF_PAGE	将滚动页复制到 nPage 成员。
SIF_POS	将滚动位置复制到 nPos 成员。
SIF_RANGE	将滚动范围复制到 nMin 和 nMax 成员。
SIF_TRACKPOS	将当前滚动框跟踪位置复制到 nTrackPos 成员。

返回值

如果消息检索了任何值，则返回值为 TRUE;否则为 FALSE。

备注

指示滚动条位置的消息 WM_HSCROLL 和 WM_VSCROLL，仅提供 16 位的位置数据。 但是，SBM_GETSCROLLINFO、SBM_SETSCROLLINFO、GetScrollInfo 和 SetScrollInfo 使用的 SCROLLINFO 结构提供 32 位滚动条位置数据。 处理 WM_HSCROLL 或 WM_VSCROLL 消息时，可以使用这些消息和函数来获取 32 位滚动条位置数据。

若要在WM_HSCROLL或WM_VSCROLL消息SB_THUMBTRACK请求代码期间获取滚动框 (拇指) 的 32 位位置，请在SCROLLINFO 结构的 fMask 成员中使用SIF_TRACKPOS值发送SBM_GETSCROLLINFO。 该消息返回 SCROLLINFO 结构的 nTrackPos 成员中滚动框的跟踪位置。 这使你可以在用户移动滚动框时获取滚动框的位置。 或者，可以使用 GetScrollInfo 函数获取相同的信息。

要求

要求	值
最低受支持的客户端	Windows Vista [仅限桌面应用]
最低受支持的服务器	Windows Server 2003 [仅限桌面应用]
标头	Winuser.h（包括 Windows.h）

另请参阅

引用

GetScrollInfo

SBM_SETSCROLLINFO

SCROLLINFO

SetScrollInfo