nim_duilib/docs/Controls/Slider.md

Slider（滑动条）

Slider 继承了 Progress 控件属性和方法，更多可用属性和方法请参考：Progress 控件

可用属性

属性名称	默认值	参数类型	用途
thumbnormalimage		STRING	拖动滑块普通状态图片
thumbhotimage		STRING	拖动滑块鼠标悬浮状态图片
thumbpushedimage		STRING	拖动滑块鼠标按下状态图片
thumbdisabledimage		STRING	拖动滑块鼠标禁用状态图片
thumbsize	10,10	SIZE	拖动滑块大小,如(10,10)
step	1	INT	进度步长,如(1)
progressbarpadding	0,0,0,0	RECT	滑动条绘制时缩小的内边距

可用接口

接口名称	用途
GetChangeStep	获取步进步长
SetChangeStep	设置步进步长
SetThumbSize	设置多动滑块的大小
GetThumbRect	获取滑块的矩形信息
GetThumbStateImage	获取指定状态下滑块的图片
SetThumbStateImage	设置指定状态下滑块的图片
GetProgressBarPadding	获取进度条内边距
SetProgressBarPadding	设置进度条内边距
AttachValueChange	监听进度条进度改变事件

GetChangeStep

获取步进步长

int GetChangeStep()

• 参 数：无
• 返回值：返回步进步长

SetChangeStep

设置步进步长

void SetChangeStep(int step)

• 参 数：
  • step 要设置的步长
• 返回值：无

SetThumbSize

设置多动滑块的大小

void SetThumbSize(CSize szXY)

• 参 数：
  • szXY 要设置的大小
• 返回值：无

GetThumbRect

获取滑块的矩形信息

UiRect GetThumbRect()

• 参 数：无
• 返回值：返回滑块的矩形信息

GetThumbStateImage

获取指定状态下滑块的图片

std::wstring GetThumbStateImage(ControlStateType stateType)

• 参 数：
  • stateType 要获取的状态标识，参考 Control枚举
• 返回值：返回图片路径

SetThumbStateImage

设置指定状态下滑块的图片

void SetThumbStateImage(ControlStateType stateType, const std::wstring& pStrImage)

• 参 数：
  • stateType 要设置的状态标识，参考 Control枚举
  • pStrImage 要设置的图片位置
• 返回值：无

GetProgressBarPadding

获取进度条内边距

UiRect GetProgressBarPadding()

• 参 数：无
• 返回值：返回内边距信息

SetProgressBarPadding

设置进度条内边距

void SetProgressBarPadding(UiRect rc)

• 参 数：
  • rc 要设置的边距信息
• 返回值：无

AttachValueChange

监听进度条进度改变事件

void AttachValueChange(const EventCallback& callback)

• 参 数：
  • callback 进度条进度改变后调用的回调函数
• 返回值：无