getScrollPos 函数 (winuser.h)

GetScrollPos 函数检索指定滚动条中 (thumb) 滚动框的当前位置。 当前位置是一个相对值,取决于当前滚动范围。 例如,如果滚动范围是 0 到 100,而滚动框位于条的中间,则当前位置为 50。

注意 提供 GetScrollPos 函数是为了向后兼容。 新应用程序应使用 GetScrollInfo 函数。
 

语法

int GetScrollPos(
  [in] HWND hWnd,
  [in] int  nBar
);

参数

[in] hWnd

类型: HWND

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

[in] nBar

类型: int

指定要检查的滚动条。 此参数的取值可为下列值之一:

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

返回值

类型: int

如果函数成功,则返回值是滚动框的当前位置。

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

注解

GetScrollPos 函数使应用程序能够使用 32 位滚动位置。 尽管指示滚动条位置的消息(WM_HSCROLLWM_VSCROLL)限制为 16 位位置数据,但函数 SetScrollPos、SetScrollRangeGetScrollPosGetScrollRange 支持 32 位滚动条位置数据。 因此,应用程序可以在处理WM_HSCROLLWM_VSCROLL消息时调用 GetScrollPos 以获取 32 位滚动条位置数据。

若要在 WM_HSCROLL或WM_VSCROLL 消息SB_THUMBTRACK请求代码期间获取滚动框 (拇指 ) 的 32 位位置,请使用 GetScrollInfo 函数。

如果 nBar 参数SB_CTL并且 hWnd 参数指定的窗口不是系统滚动条控件,则系统会将 SBM_GETPOS 消息发送到窗口以获取滚动条信息。 这允许 GetScrollPos 对模拟滚动条的自定义控件进行操作。 如果窗口不处理 SBM_GETPOS 消息, 则 GetScrollPos 函数将失败。

要求

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

另请参阅

GetScrollInfo

GetScrollRange

引用

SetScrollInfo

SetScrollPos

SetScrollRange

WM_HSCROLL

WM_VSCROLL