QCheckBox方法大全

📘 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 自身方法总表（完整）

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