复选框控件

复选框控件

复选框控件用于多选、配置项、权限项和开关型参数。

常见状态

  • 未选中(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 图标

UIGQCheckBoxUIGQRadioButton 支持为选中、未选中等状态直接配置 SVG 路径。