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` 进度条进度改变后调用的回调函数
|
|||
|
|
- 返回值：无
|