FlatSB_SetScrollInfo 函数 (commctrl.h)
设置平面滚动条的信息。 如果未为窗口初始化平面滚动条,此函数将调用标准 SetScrollInfo 函数。
语法
int FlatSB_SetScrollInfo(
HWND unnamedParam1,
int code,
LPSCROLLINFO psi,
BOOL fRedraw
);
参数
unnamedParam1
类型: HWND
包含平面滚动条的窗口的句柄。 此窗口句柄必须已在调用 InitializeFlatSB 时传递。
code
类型: int
滚动条类型。 可以为下列值之一:
值 | 含义 |
---|---|
|
设置水平滚动条的信息。 |
|
设置垂直滚动条的信息。 |
psi
类型: LPSCROLLINFO
指向 SCROLLINFO 结构的指针,该结构包含指定滚动条的新信息。 在调用 FlatSB_SetScrollInfo 之前,必须填充结构的 cbSize 和 fMask 成员。 fMask 成员指定结构的哪些成员包含有效信息,可以是以下值的任意组合:
值 | 含义 |
---|---|
|
如果新信息会导致删除滚动条,则禁用滚动条。 |
|
设置平面滚动条的页面信息。 SCROLLINFO 结构的 nPage 成员必须包含新的页面值。 |
|
设置平面滚动条的位置信息。 SCROLLINFO 结构的 nPos 成员必须包含新的位置值。 |
|
设置平面滚动条的范围信息。 SCROLLINFO 结构的 nMin 和 nMax 成员必须包含新的范围值。 |
|
SIF_PAGE、SIF_POS和SIF_RANGE的组合。 |
fRedraw
类型: BOOL
指定是否应立即重绘滚动条以反映更改。 如果此参数为 TRUE,则重新绘制滚动条;如果为 FALSE,则不重绘滚动条。
返回值
类型: int
返回当前滚动位置。 如果调用 FlatSB_SetScrollInfo 更改滚动位置,则返回上一个位置。
注解
注意 平面滚动条功能在 Comctl32.dll 版本 4.71 到 5.82 中实现。 Comctl32.dll 版本 6.00 及更高版本不支持平面滚动条。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows Vista [仅限桌面应用] |
最低受支持的服务器 | Windows Server 2003 [仅限桌面应用] |
目标平台 | Windows |
标头 | commctrl.h |
Library | Comctl32.lib |
DLL | Comctl32.dll (版本 4.71 或更高版本) |