C++ Qt开发：CheckBox多选框组件

Qt 是一个跨平台C++图形界面开发库，利用Qt可以快速开发跨平台窗体应用程序，在Qt中我们可以通过拖拽的方式将不同组件放到指定的位置，实现图形化开发极大的方便了开发效率，本章将重点介绍CheckBox单行输入框组件的常用方法及灵活运用。
QCheckBox 是 Qt 中用于实现复选框的组件，它提供了丰富的功能和灵活性。与之前文章中的RadioButton组件不同，CheckBox组件支持多项选择以及三态支持，即可以是选中、未选中或半选中的状态。
下面是QCheckBox的主要方法的概述和表格形式：
方法名描述QCheckBox(QWidget *parent = nullptr)构造函数，创建一个 QCheckBox 组件。isChecked() const返回复选框的当前状态，选中返回 true，否则返回 false。setCheckState(Qt::CheckState state)设置复选框的状态，可以是 Qt::Unchecked、Qt:artiallyChecked 或 Qt::Checked。checkState() const返回复选框的当前状态，枚举类型 Qt::CheckState。setTristate(bool)启用或禁用三态复选框的功能。isTristate() const返回是否启用了三态复选框的功能。setCheckable(bool checkable)设置复选框是否可以被选中，true 表示可以选中，false 表示不能选中。isChecked() const返回复选框的当前状态，选中返回 true，否则返回 false。setChecked(bool check)设置复选框的状态，true 表示选中，false 表示未选中。text() const返回复选框的文本标签。setText(const QString &text)设置复选框的文本标签。stateChanged(int)复选框状态变化时发射的信号，参数是枚举类型 Qt::CheckState，可以是 Qt::Unchecked、Qt:artiallyChecked 或 Qt::Checked。这里分别演示一下选择框组件的使用方法，首先展示如何设置三态选择框，然后再展示一下如何通过一个选择框控制子选择框的状态，如下图是该程序的布局。

首先在主构造函数MainWindow中通过使用setTristate()将前三个半选框设置为三态状态，并使用setEnabled()将前三个选择框设置为可选择状态，代码如下所示；

1. #include "mainwindow.h"
2. #include "ui_mainwindow.h"
4. MainWindow::MainWindow(QWidget *parent): QMainWindow(parent), ui(new Ui::MainWindow)
5. {
6.     ui->setupUi(this);
8.     // 启用三态状态并设置为可选择
9.     ui->checkBox_a->setTristate();
10.     ui->checkBox_b->setTristate();
11.     ui->checkBox_c->setTristate();
13.     // 设置为可选状态
14.     ui->checkBox_a->setEnabled(true);
15.     ui->checkBox_b->setEnabled(true);
16.     ui->checkBox_c->setEnabled(true);
17. }
19. MainWindow::~MainWindow()
20. {
21.     delete ui;
22. }

复制代码

接着我们分别为三个选择框配置选择事件，通过在半选框中右键选中stateChanged(int)点击确定跳转到选择框的事件中来，在事件中int state参数则代表选择框传回的状态码，通过判断状态码Qt::Checked则代表选中、Qt:artiallyChecked代表半选中、Qt::Unchecked代表未选中。

1. // 设置第一个选择框
2. void MainWindow::on_checkBox_a_stateChanged(int state)
3. {
4.     // 选中状态
5.     if (state == Qt::Checked)
6.     {
7.        ui->checkBox_a->setText("选中");
8.     }
9.     // 半选状态
10.     else if(state == Qt::PartiallyChecked)
11.     {
12.        ui->checkBox_a->setText("半选中");
13.     }
14.     // 未选中
15.     else if(state == Qt::Unchecked)
16.     {
17.        ui->checkBox_a->setText("未选中");
18.     }
19.     // 否则恢复默认值
20.     else
21.     {
22.         ui->checkBox_a->setText("半选框1");
23.     }
24. }
26. // 设置第二个选择框
27. void MainWindow::on_checkBox_b_stateChanged(int state)
28. {
29.     // 选中状态
30.     if (state == Qt::Checked)
31.     {
32.        ui->checkBox_b->setText("选中");
33.     }
34.     // 半选状态
35.     else if(state == Qt::PartiallyChecked)
36.     {
37.        ui->checkBox_b->setText("半选中");
38.     }
39.     // 未选中
40.     else if(state == Qt::Unchecked)
41.     {
42.        ui->checkBox_b->setText("未选中");
43.     }
44.     // 否则恢复默认值
45.     else
46.     {
47.         ui->checkBox_b->setText("半选框2");
48.     }
49. }
51. // 设置第三个选择框
52. void MainWindow::on_checkBox_c_stateChanged(int state)
53. {
54.     // 选中状态
55.     if (state == Qt::Checked)
56.     {
57.        ui->checkBox_c->setText("选中");
58.     }
59.     // 半选状态
60.     else if(state == Qt::PartiallyChecked)
61.     {
62.        ui->checkBox_c->setText("半选中");
63.     }
64.     // 未选中
65.     else if(state == Qt::Unchecked)
66.     {
67.        ui->checkBox_c->setText("未选中");
68.     }
69.     // 否则恢复默认值
70.     else
71.     {
72.         ui->checkBox_c->setText("半选框3");
73.     }
74. }

复制代码

至此，当选择不同的选择框时则可以切换到不同的选择状态，如下图；

接着来说说如何实现清除选择框的状态，当用户点击清除状态时，首先我们要做的就是调用isChecked()来检查每一个选择框是否被选中，如果是则通过setChecked()将属性设置为false即可，通过这种方式也可以实现对特定选择框状态的父子关联，代码如下所示；

1. // 清除选中状态
2. void MainWindow::on_pushButton_clicked()
3. {
4.     // 获取选择框状态
5.     int checka = ui->checkBox_a->isChecked();
6.     int checkb = ui->checkBox_b->isChecked();
7.     int checkc = ui->checkBox_c->isChecked();
9.     // 依次重置
10.     if(checka == true)
11.     {
12.         ui->checkBox_a->setChecked(false);
13.     }
14.     if(checkb == true)
15.     {
16.         ui->checkBox_b->setChecked(false);
17.     }
18.     if(checkc == true)
19.     {
20.         ui->checkBox_c->setChecked(false);
21.     }
22. }
24. // 设置选中全部子框
25. void MainWindow::on_checkBox_d_stateChanged(int state)
26. {
27.     // 选中所有子框
28.     if(state == Qt::Checked)
29.     {
30.         ui->checkBox_e->setChecked(true);
31.         ui->checkBox_f->setChecked(true);
32.         ui->checkBox_g->setChecked(true);
33.         ui->checkBox_g->setChecked(true);
34.         ui->checkBox_h->setChecked(true);
35.     }
36.     // 取消子框全选状态
37.     if(state == Qt::Unchecked)
38.     {
39.         ui->checkBox_e->setChecked(false);
40.         ui->checkBox_f->setChecked(false);
41.         ui->checkBox_g->setChecked(false);
42.         ui->checkBox_g->setChecked(false);
43.         ui->checkBox_h->setChecked(false);
44.     }
45. }

复制代码

当读者选择选中全部子框按钮时，则底部的四个CheckBox将会联动，如下图所示；


免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！