FlatSB_SetScrollProp 函数 (commctrl.h)

设置平面滚动条的属性。

语法

BOOL FlatSB_SetScrollProp(
  HWND    unnamedParam1,
  UINT    index,
  INT_PTR newValue,
  BOOL    unnamedParam4
);

参数

unnamedParam1

类型： HWND

包含平面滚动条的窗口的句柄。 此窗口句柄必须已在调用 InitializeFlatSB 时传递。

index

类型： UINT

确定 newValue 表示的内容以及正在设置的属性。 此参数可能是以下值之一：

值	含义
WSB_PROP_CXHSCROLL	newValue 是一个INT_PTR值，表示水平滚动条中方向按钮的宽度（以像素为单位）。
WSB_PROP_CXHTHUMB	newValue 是一个INT_PTR值，表示水平滚动条中拇指的宽度（以像素为单位）。
WSB_PROP_CXVSCROLL	newValue 是一个INT_PTR值，表示垂直滚动条的宽度（以像素为单位）。
WSB_PROP_CYHSCROLL	newValue 是一个INT_PTR值，表示水平滚动条的高度（以像素为单位）。
WSB_PROP_CYVSCROLL	newValue 是一个INT_PTR值，表示垂直滚动条中方向按钮的高度（以像素为单位）。
WSB_PROP_CYVTHUMB	newValue 是一个INT_PTR值，表示垂直滚动条中拇指的高度（以像素为单位）。
WSB_PROP_HBKGCOLOR	newValue 是一个 COLORREF 值，表示水平滚动条中的背景色。
WSB_PROP_HSTYLE	newValue 是以下值之一，用于更改水平滚动条的视觉效果。 FSB_ENCARTA_MODE 将显示标准平面滚动条。 当鼠标在方向按钮或拇指上移动时，滚动条的该部分将以 3-D 显示。 FSB_FLAT_MODE 将显示标准平面滚动条。 当鼠标在方向按钮或拇指上移动时，滚动条的该部分将以倒色显示。 FSB_REGULAR_MODE 显示一个普通的非平展滚动条。 不会应用任何特殊的视觉效果。
WSB_PROP_PALETTE	newValue 是一个 HPALETTE 值，表示滚动条在绘图时应使用的新调色板。
WSB_PROP_VBKGCOLOR	newValue 是一个 COLORREF 值，它表示垂直滚动条中的背景色。
WSB_PROP_VSTYLE	newValue 是以下值之一，用于更改垂直滚动条的视觉效果： FSB_ENCARTA_MODE 将显示标准平面滚动条。 当鼠标在方向按钮或拇指上移动时，滚动条的该部分将以 3-D 显示。 FSB_FLAT_MODE 将显示标准平面滚动条。 当鼠标在方向按钮或拇指上移动时，滚动条的该部分将以倒色显示。 FSB_REGULAR_MODE 显示一个普通的非平展滚动条。 不会应用任何特殊的视觉效果。

newValue

类型： INT_PTR

要设置的新值。 此参数取决于传入 索引的标志。

unnamedParam4

类型： BOOL

指定是否应立即重绘滚动条以反映更改。 如果此参数为 TRUE，则重新绘制滚动条;如果为 FALSE，则不重绘滚动条。

返回值

类型： BOOL

如果成功，返回不为零的值；否则返回零。

注解

注意 平面滚动条功能在 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 或更高版本)