1 -> 概述

QCheckBox 是 Qt 框架中提供的一个基础控件，用于实现复选框功能。它允许用户在两种或三种状态之间进行选择，是图形用户界面中常见的交互元素之一。作为 QAbstractButton 的子类，QCheckBox 继承了按钮的基本特性，同时提供了专门用于多选场景的功能。

2 -> 核心特性

2.1 -> 状态管理

QCheckBox 最显著的特点是支持三种状态：

选中状态（Checked）
未选中状态（Unchecked）
部分选中状态（Partially checked）

部分选中状态常用于表示 "不确定" 或 "部分选择" 的场景，比如当一组选项只有部分被选中时，父级复选框可以显示为部分选中状态。

2.2 -> 信号机制

QCheckBox 提供了两种主要的信号：

stateChanged（int state）：当复选框状态改变时发出，携带具体的状态值
toggled（bool checked）：状态改变时发出，提供布尔值表示是否选中

这两种信号让开发者可以根据需要选择不同粒度的状态监听方式。

2.3 -> 外观与文本

QCheckBox 支持显示文本标签，通常位于复选框的右侧。通过 setText() 方法可以设置显示文字，同时支持 HTML 格式的富文本显示，允许基本的文本格式化。

3 -> 应用场景

1. 设置选项

最常见的应用是在设置对话框或偏好设置中，让用户启用或禁用特定功能。多个 QCheckBox 可以组合使用，允许用户同时选择多个互不排斥的选项。

2. 条件同意

在注册表单或安装程序中，常用于"我已阅读并同意条款"这类需要用户明确同意的场景。

3. 树形结构选择

在具有层次结构的数据选择中，QCheckBox 的三态特性非常有用。父节点的部分选中状态可以直观表示子节点只有部分被选中。

4. 筛选器界面

在数据筛选或搜索界面中，QCheckBox 常用于让用户选择多个筛选条件，这些条件可以同时生效。

4 -> 代码示例

获取复选按钮的取值

1. 在界面上创建三个复选按钮，和一个普通按钮

objectName 分别为 checkBox_beans、checkBox_dine、checkBox_sleep 和 pushButton

2. 给 pushButton 添加 slot 函数

void Widget::on_pushButton_clicked()
{QString result = "今天准备做什么: ";if (ui->checkBox_dine->isChecked()){result += ui->checkBox_dine->text() + " ";}if (ui->checkBox_sleep->isChecked()){result += ui->checkBox_sleep->text() + " ";}if (ui->checkBox_beans->isChecked()){result += ui->checkBox_beans->text() + " ";}ui->label->setText(result);
}

3. 运行程序，可以看到点击确认按钮时，就会在控制台中输出选中的内容

5 -> 总结

QCheckBox 是 Qt 中功能丰富且灵活的控件，通过其双态或三态的选择机制，为用户提供了直观的选项设置方式。合理使用 QCheckBox 可以创建出符合用户直觉的交互界面，特别是在需要多选的场景中表现出色。掌握 QCheckBox 的特性和应用场景，有助于开发出更加用户友好的 Qt 应用程序。

感谢各位大佬支持！！！

互三啦！！！