复选框控件
复选框控件
复选框控件用于多选、配置项、权限项和开关型参数。
常见状态
- 未选中(Unchecked)
- 已选中(Checked)
- 半选(Indeterminate)
- 禁用(Disabled)
- 错误提示(Error)
风格参数
| 参数 | 说明 |
|---|---|
checked |
是否选中 |
tristate |
是否支持半选 |
label |
文本说明 |
size |
控件尺寸 |
类继承关系
QWidget
└─ QCheckBox
└─ UIGQCheckBox + IUIGQWidgetBase
UIGQCheckBox 继承 Qt 的 QCheckBox,保留选中、半选、禁用和信号槽能力;同时通过 IUIGQWidgetBase 接入 WidgetKit 主题、图标状态、布局比例和 JSON 序列化。
常用方法
| 方法 | 说明 | 参数 | 返回值 |
|---|---|---|---|
setChecked(bool checked) |
设置复选框是否选中。 | checked:是否选中。 |
void |
isChecked() |
获取当前是否选中。 | 无 | bool |
setText(const QString& text) |
设置复选框文本。 | text:显示文本。 |
void |
setThemeName(const QString& themeName) |
应用复选框主题配置。 | themeName:主题配置名称。 |
void |
setShowIcon(bool show) |
设置是否绘制复选框图标。 | show:是否绘制图标。 |
void |
setTristate(bool y = true) |
设置是否启用三态模式。 | y:是否启用三态。 |
void |
checkState() |
获取当前勾选状态。 | 无 | Qt::CheckState |
适用建议
批量选择场景建议配合表格表头的半选状态使用。
SVG 图标
UIGQCheckBox 和 UIGQRadioButton 支持为选中、未选中等状态直接配置 SVG 路径。