119 lines
2.5 KiB
Markdown
119 lines
2.5 KiB
Markdown
# TabBox（多标签布局容器）
|
||
|
||
`TabBox` 继承了 `Box` 容器属性和方法，更多可用属性和方法请参考：[Box](Box.md) 容器
|
||
|
||
## 可用属性
|
||
|
||
| 属性名称 | 默认值 | 参数类型 | 用途 |
|
||
| :--- | :--- | :--- | :--- |
|
||
| fadeswitch | false | BOOL | 当切换页面时是否使用动画效果,如(false) |
|
||
| selectedid | 0 | INT | 默认选中的页面id,如(0) |
|
||
| fadeswitch | false | BOOL | 当切换页面时是否使用动画效果,如(false) |
|
||
| selectedid | 0 | INT | 默认选中的页面id,如(0) |
|
||
|
||
## 可用接口
|
||
|
||
| 方法名称 | 用途 |
|
||
| :--- | :--- |
|
||
| [GetCurSel](#GetCurSel) | 获取当前选择项 |
|
||
| [SelectItem](#SelectItem) | 根据控件索引选择一个子项 |
|
||
| [SelectItem](#SelectItem) | 根据控件指针选择一个子项 |
|
||
| [SelectItem](#SelectItem) | 根据控件名称选择一个子项 |
|
||
| [SetFadeSwitch](#SetFadeSwitch) | 设置是否显示动画效果 |
|
||
| [IsFadeSwitch](#IsFadeSwitch) | 判断是否需要显示动画效果 |
|
||
| [ShowTabItem](#ShowTabItem) | 显示一个 TAB 项 |
|
||
| [HideTabItem](#HideTabItem) | 隐藏一个 TAB 项 |
|
||
|
||
### GetCurSel
|
||
|
||
获取当前选择项
|
||
|
||
```cpp
|
||
int GetCurSel()
|
||
```
|
||
|
||
- 参 数：无
|
||
- 返回值：返回当前选择项索引
|
||
|
||
### SelectItem
|
||
|
||
根据控件索引选择一个子项
|
||
|
||
```cpp
|
||
bool SelectItem(int iIndex)
|
||
```
|
||
|
||
- 参 数：
|
||
- `iIndex` 要选择的子项索引
|
||
- 返回值：成功返回 true，否则返回 false
|
||
|
||
### SelectItem
|
||
|
||
根据控件指针选择一个子项
|
||
|
||
```cpp
|
||
bool SelectItem(Control* pControl)
|
||
```
|
||
|
||
- 参 数：
|
||
- `pControl` 要选择的子项指针
|
||
- 返回值：成功返回 true，否则返回 false
|
||
|
||
### SelectItem
|
||
|
||
根据控件名称选择一个子项
|
||
|
||
```cpp
|
||
bool SelectItem(const std::wstring& pControlName)
|
||
```
|
||
|
||
- 参 数：
|
||
- `pControlName` 要选择的控件名称
|
||
- 返回值：成功返回 true，否则返回 false
|
||
|
||
### SetFadeSwitch
|
||
|
||
设置是否显示动画效果
|
||
|
||
```cpp
|
||
void SetFadeSwitch(bool bFadeSwitch)
|
||
```
|
||
|
||
- 参 数：
|
||
- `bFadeSwitch` 设置为 true 则显示，false 为不显示动画
|
||
- 返回值：无
|
||
|
||
### IsFadeSwitch
|
||
|
||
判断是否需要显示动画效果
|
||
|
||
```cpp
|
||
bool IsFadeSwitch()
|
||
```
|
||
|
||
- 参 数：无
|
||
- 返回值：返回 true 显示动画，false 为不显示动画效果
|
||
|
||
### ShowTabItem
|
||
|
||
显示一个 TAB 项
|
||
|
||
```cpp
|
||
void ShowTabItem(std::size_t it)
|
||
```
|
||
|
||
- 参 数：
|
||
- `it` TAB 项索引
|
||
- 返回值：无
|
||
|
||
### HideTabItem
|
||
|
||
隐藏一个 TAB 项
|
||
|
||
```cpp
|
||
void HideTabItem(std::size_t it)
|
||
```
|
||
|
||
- 参 数：
|
||
- `it` TAB 项索引
|
||
- 返回值：无 |