如何用QGroupBox与QCheckBox实现互斥勾选？代码信号槽失效排查

一、信号槽未触发的核心原因 #

QCheckBox不存在checked()这个信号，你写错了信号名称。QCheckBox用于状态变化的有效信号是：

• toggled(bool checked)：复选框状态切换时触发，参数表示当前是否被勾选
• stateChanged(int state)：复选框状态（未勾选/半勾选/勾选）变更时触发

原代码里的connect(this, SIGNAL(checked()), this, SLOT(checked()))完全无效，因为没有对应信号，所以槽函数永远不会被调用。

二、实现组内互斥勾选的正确方案 #

要实现同一QGroupBox内勾选一个CheckBox时取消其他所有项，逻辑应该放在GroupBox层面处理——因为需要遍历组内所有子CheckBox，单个CheckBox无法直接获取同组其他控件。

修正后的完整代码 #

#include <QGroupBox>
#include <QCheckBox>
#include <QDebug>
#include <QVBoxLayout>

class GroupBox : public QGroupBox
{
    Q_OBJECT
public:
    GroupBox(QWidget *parent = nullptr) : QGroupBox(parent)
    {
        auto layout = new QVBoxLayout(this);
        setLayout(layout);
    }

    // 统一添加CheckBox并绑定信号
    void addCheckBox(QCheckBox* checkBox)
    {
        layout()->addWidget(checkBox);
        connect(checkBox, &QCheckBox::toggled, this, &GroupBox::onCheckBoxToggled);
    }

private slots:
    void onCheckBoxToggled(bool checked)
    {
        if (!checked) return; // 仅处理"被勾选"的情况

        QCheckBox* senderBox = qobject_cast<QCheckBox*>(sender());
        if (!senderBox) return;

        // 遍历组内所有CheckBox，取消其他已勾选项
        for (QWidget* widget : findChildren<QCheckBox*>())
        {
            if (widget != senderBox && widget->isChecked())
            {
                // 临时断开信号避免递归触发
                disconnect(widget, &QCheckBox::toggled, this, &GroupBox::onCheckBoxToggled);
                widget->setChecked(false);
                connect(widget, &QCheckBox::toggled, this, &GroupBox::onCheckBoxToggled);
            }
        }
    }
};

// 自定义CheckBox可简化，仅保留额外逻辑（如果需要）
class CheckBox : public QCheckBox
{
    Q_OBJECT
public:
    CheckBox(QWidget *parent = nullptr) : QCheckBox(parent)
    {
        // 如需自定义勾选后的操作，绑定正确信号
        connect(this, &QCheckBox::toggled, this, &CheckBox::onToggled);
    }

private slots:
    void onToggled(bool checked)
    {
        if (checked)
        {
            qDebug() << "该CheckBox已被勾选";
        }
    }
};

三、关键细节说明 #

• 用qobject_cast获取信号发送者，确保是QCheckBox类型，避免类型错误
• 取消其他CheckBox勾选时临时断开信号，防止setChecked(false)触发递归调用
• 通过findChildren<QCheckBox*>()遍历组内所有子CheckBox，实现组内互斥逻辑

内容的提问来源于stack exchange，提问作者Cesar