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 [仅限桌面应用] |
标头 |
|