【QT开发笔记-基础篇】| 第二章 常用控件 | 2.6 复选按钮 QCheckBox

本节对应的视频讲解：B_站_链_接

https://www.bilibili.com/video/BV1yN4y1g7Eb

Qt 中的复选按钮类是 QCheckBox

它和单选按钮很相似，单选按钮常用在 “多选一” 的场景，而复选按钮常用在 "多选多"的场景

比如喜欢的水果选项中，可以在 “苹果/桃/梨/橘子/香蕉” 中选择多个。

1. 属性和方法

---

QRadioButton 有很多属性，完整的可查看帮助文档。这里列出常用的属性和方法：

1.1 文本

这两个是其父类 QAbstractButton 中的属性和方法，因此 QPushButton、QRadioButton、QCheckBox 都具有该属性

// 获取和设置显示的文本
QString text() const
void setText(const QString &text)

1.2 三态

单选按钮，有选中（Checked）和非选中（UnChecked）这两种状态；

而复选按钮可以有三种状态：

• Qt::Checked 选中
• Qt::Unchecked 非选中
• Qt::PartiallyChecked 半选中，比如当一组复选按钮中只选择了部分时，可以设置其父项为半选状态，如下
  

可以设置复选按钮，是否支持三态，如下：

// 用于获取和设置是否支持三态
bool isTristate() const
void setTristate(bool y = true)

如果不支持三态，使用方法单选按钮一样，只有选中（Checked）和非选中（unchecked）两种状态，没有半选中状态（ PartiallyChecked ）

此时可以使用如下获取复选按钮是否选中：

// 获取和设置复选按钮是否选中：checked/unchecked
bool isChecked() const
void setChecked(bool)

如果支持三态，除了选中（Checked）和非选中（unchecked）两种状态，还有半选中状态（ PartiallyChecked ）

此时可以使用如下获取复选按钮的状态：

// 设置和获取复选按钮的状态
Qt::CheckState checkState() const
void setCheckState(Qt::CheckState state)

1.3 自动排他

复选按钮同样可以设置是否自动排他，入下：

// 获取和设置自动排他
bool autoExclusive() const
void setAutoExclusive(bool)

我们前面说过，复选按钮实现的是 “多选多”，因此复选按钮的该属性默认是禁能的

尽管在技术上可以通过复选框来实现单选框的行为，也可以通过单选框来实现复选框的行为，但还是强烈建议使用众所周知的约定。

1.4 信号槽

按钮在按下和抬起的过程中，会发射多个信号。

// 单选按钮 QRadioButton 被点击时，会发出该信号
void clicked();

// 当复选按钮的选中状态发生改变时，会发射该信号
// 所谓状态改变，是指在 Checked/UnChecked/PartiallyChecked 之间状态改变
void stateChanged(int state)

2. 案例

---

该案例演示，复选框的属性以及信号槽

2.1 布局

在 UI 设计师界面，拖拽对应的控件，修改显示的文字、控件的 name，然后完成布局

2.2 代码实现

完整的项目，在本节视频的置顶评论下载即可

Widget::Widget(QWidget *parent)
    : QWidget(parent)
    , ui(new Ui::Widget)
{
    ui->setupUi(this);

    // 5个复选按钮对应同一个槽函数
    connect(ui->cbApple, &QCheckBox::stateChanged, this, &Widget::onStateChanged);
    connect(ui->cbPeach, &QCheckBox::stateChanged, this, &Widget::onStateChanged);
    connect(ui->cbPear, &QCheckBox::stateChanged, this, &Widget::onStateChanged);
    connect(ui->cbOrange, &QCheckBox::stateChanged, this, &Widget::onStateChanged);
    connect(ui->cbBanana, &QCheckBox::stateChanged, this, &Widget::onStateChanged);
}

Widget::~Widget()
{
    delete ui;
}

void Widget::on_cbAll_clicked()
{
    // 这里需要将“全选”按钮的三态设置为false
    // 也就是在鼠标点击时，只允许在checked和unchecked之间切换，不允许出现半选状态
    ui->cbAll->setTristate(false);

    Qt::CheckState state = ui->cbAll->checkState();

    if(state == Qt::Checked) {
        ui->cbApple->setChecked(true);
        ui->cbPear->setChecked(true);
        ui->cbPeach->setChecked(true);
        ui->cbOrange->setChecked(true);
        ui->cbBanana->setChecked(true);
    } else if (state == Qt::Unchecked){
        ui->cbApple->setChecked(false);
        ui->cbPear->setChecked(false);
        ui->cbPeach->setChecked(false);
        ui->cbOrange->setChecked(false);
        ui->cbBanana->setChecked(false);
    } else {

    }
}

void Widget::onStateChanged()
{
    QString s;

    int appleChecked = ui->cbApple->isChecked();
    int peachChecked = ui->cbPeach->isChecked();
    int pearChecked = ui->cbPear->isChecked();
    int orangeChecked = ui->cbOrange->isChecked();
    int bananaChecked = ui->cbBanana->isChecked();

    if(appleChecked && peachChecked && pearChecked && orangeChecked && bananaChecked) {
        // 全部选中
        ui->cbAll->setCheckState(Qt::Checked);
    } else if (!(appleChecked || peachChecked || pearChecked || orangeChecked || bananaChecked)) {
        // 全部未选中
        ui->cbAll->setCheckState(Qt::Unchecked);
    } else {
        // 部分选中
        ui->cbAll->setCheckState(Qt::PartiallyChecked);
    }

    if(appleChecked) {
        s += ui->cbApple->text() += " ";
    }
    if(pearChecked) {
        s += ui->cbPear->text() += " ";
    }
    if(peachChecked) {
        s += ui->cbPeach->text() += " ";
    }
    if(orangeChecked) {
        s += ui->cbOrange->text() += " ";
    }
    if(bananaChecked) {
        s += ui->cbBanana->text() += " ";
    }

    ui->leResult->setText(s);
}

---

本节对应的视频讲解：B_站_链_接

https://www.bilibili.com/video/BV1yN4y1g7Eb