136 lines
3.1 KiB
Markdown
136 lines
3.1 KiB
Markdown
# Slider（滑动条）
|
||
|
||
`Slider` 继承了 `Progress` 控件属性和方法，更多可用属性和方法请参考：[Progress](Progress.md) 控件
|
||
|
||
## 可用属性
|
||
|
||
| 属性名称 | 默认值 | 参数类型 | 用途 |
|
||
| :--- | :--- | :--- | :--- |
|
||
| 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](#GetChangeStep) | 获取步进步长 |
|
||
| [SetChangeStep](#SetChangeStep) | 设置步进步长 |
|
||
| [SetThumbSize](#SetThumbSize) | 设置多动滑块的大小 |
|
||
| [GetThumbRect](#GetThumbRect) | 获取滑块的矩形信息 |
|
||
| [GetThumbStateImage](#GetThumbStateImage) | 获取指定状态下滑块的图片 |
|
||
| [SetThumbStateImage](#SetThumbStateImage) | 设置指定状态下滑块的图片 |
|
||
| [GetProgressBarPadding](#GetProgressBarPadding) | 获取进度条内边距 |
|
||
| [SetProgressBarPadding](#SetProgressBarPadding) | 设置进度条内边距 |
|
||
| [AttachValueChange](#AttachValueChange) | 监听进度条进度改变事件 |
|
||
|
||
|
||
### GetChangeStep
|
||
|
||
获取步进步长
|
||
|
||
```cpp
|
||
int GetChangeStep()
|
||
```
|
||
|
||
- 参 数：无
|
||
- 返回值：返回步进步长
|
||
|
||
### SetChangeStep
|
||
|
||
设置步进步长
|
||
|
||
```cpp
|
||
void SetChangeStep(int step)
|
||
```
|
||
|
||
- 参 数：
|
||
- `step` 要设置的步长
|
||
- 返回值：无
|
||
|
||
### SetThumbSize
|
||
|
||
设置多动滑块的大小
|
||
|
||
```cpp
|
||
void SetThumbSize(CSize szXY)
|
||
```
|
||
|
||
- 参 数：
|
||
- `szXY` 要设置的大小
|
||
- 返回值：无
|
||
|
||
### GetThumbRect
|
||
|
||
获取滑块的矩形信息
|
||
|
||
```cpp
|
||
UiRect GetThumbRect()
|
||
```
|
||
|
||
- 参 数：无
|
||
- 返回值：返回滑块的矩形信息
|
||
|
||
### GetThumbStateImage
|
||
|
||
获取指定状态下滑块的图片
|
||
|
||
```cpp
|
||
std::wstring GetThumbStateImage(ControlStateType stateType)
|
||
```
|
||
|
||
- 参 数：
|
||
- `stateType` 要获取的状态标识，参考 Control枚举
|
||
- 返回值：返回图片路径
|
||
|
||
### SetThumbStateImage
|
||
|
||
设置指定状态下滑块的图片
|
||
|
||
```cpp
|
||
void SetThumbStateImage(ControlStateType stateType, const std::wstring& pStrImage)
|
||
```
|
||
|
||
- 参 数：
|
||
- `stateType` 要设置的状态标识，参考 Control枚举
|
||
- `pStrImage` 要设置的图片位置
|
||
- 返回值：无
|
||
|
||
### GetProgressBarPadding
|
||
|
||
获取进度条内边距
|
||
|
||
```cpp
|
||
UiRect GetProgressBarPadding()
|
||
```
|
||
|
||
- 参 数：无
|
||
- 返回值：返回内边距信息
|
||
|
||
### SetProgressBarPadding
|
||
|
||
设置进度条内边距
|
||
|
||
```cpp
|
||
void SetProgressBarPadding(UiRect rc)
|
||
```
|
||
|
||
- 参 数：
|
||
- `rc` 要设置的边距信息
|
||
- 返回值：无
|
||
|
||
### AttachValueChange
|
||
|
||
监听进度条进度改变事件
|
||
|
||
```cpp
|
||
void AttachValueChange(const EventCallback& callback)
|
||
```
|
||
|
||
- 参 数：
|
||
- `callback` 进度条进度改变后调用的回调函数
|
||
- 返回值：无 |