☰
QCheckBox方法大全
2026/10/20 16:13:55 网站建设 项目流程

📘 QCheckBox 方法大全

QCheckBox 自身的方法很少,因为大部分功能来自父类 QAbstractButton、QWidget。
QCheckBox自己新增的唯一方法组就是“三态 (Tristate)” 相关方法:

1. void setTristate(bool y = true)

方法说明:

启用或禁用三态复选框。
三态会出现三种状态:

  • Qt::Unchecked
  • Qt::PartiallyChecked(半选)
  • Qt::Checked

若不启用三态,则复选框只有选中/未选中两种状态。

代码示例:

QCheckBox *cb =newQCheckBox("三态复选框");
cb->setTristate(true);


2. void setCheckState(Qt::CheckState state)

方法说明:

设置复选框的当前状态,可用于代码控制复选框为:

  • 未选中:Qt::Unchecked
  • 半选:Qt::PartiallyChecked
  • 已选中:Qt::Checked

代码示例:

QCheckBox *cb = new QCheckBox("状态设置示例");
cb->setTristate(true);
cb->setCheckState(Qt::PartiallyChecked);


3. Qt::CheckState checkState() const

方法说明:

获取当前复选框的状态。
可用于判断是否处于半选状态(普通 checkbox 不会出现)。

代码示例:

Qt::CheckStatestate= cb->checkState();

if (state== Qt::PartiallyChecked) {
qDebug()
<< "当前为半选状态";
}


📌 QCheckBox 自身方法总表(完整)

方法名

说明

setTristate(bool y = true)

启用或关闭三态模式

setCheckState(Qt::CheckState state)

设置当前勾选状态

checkState() const

读取当前勾选状态

✔ QCheckBox 自身就只有这三个方法,其余功能(如 setChecked()、isChecked()、toggle()、clicked() 信号等)全部来自父类QAbstractButton,不属于 QCheckBox 自己的方法。

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询