Qt中QAbstractButton的setAutoExclusive设置按钮自动互斥的实现

QAbstractButton::setAutoExclusive() 是 Qt 中用于设置按钮自动排他性的方法。

基本概念

自动排他性（Auto-Exclusive）意味着在同一父组件中的可选中按钮会自动形成互斥组，同一时间只能有一个按钮被选中。

使用方法

1. 基本使用

#include <QPushButton>
#include <QButtonGroup>
#include <QVBoxLayout>

// 创建按钮
QPushButton *button1 = new QPushButton("按钮1");
QPushButton *button2 = new QPushButton("按钮2");
QPushButton *button3 = new QPushButton("按钮3");

// 设置按钮为可选中状态
button1->setCheckable(true);
button2->setCheckable(true);
button3->setCheckable(true);

// 启用自动排他性
button1->setAutoExclusive(true);
button2->setAutoExclusive(true);
button3->setAutoExclusive(true);

2. 完整示例

#include <QApplication>
#include <QWidget>
#include <QPushButton>
#include <QVBoxLayout>
#include <QLabel>

class Example : public QWidget {
public:
    Example(QWidget *parent = nullptr) : QWidget(parent) {
        QVBoxLayout *layout = new QVBoxLayout(this);
        
        // 创建标签显示状态
        statusLabel = new QLabel("当前选择: 无");
        layout->addWidget(statusLabel);
        
        // 创建按钮
        for (int i = 0; i < 5; ++i) {
            QPushButton *btn = new QPushButton(QString("选项 %1").arg(i + 1));
            btn->setCheckable(true);
            btn->setAutoExclusive(true);
            
            // 连接信号槽
            connect(btn, &QPushButton::toggled, this, &Example::onButtonToggled);
            
            layout->addWidget(btn);
            buttons.append(btn);
        }
    }

private slots:
    void onButtonToggled(bool checked) {
        QPushButton *btn = qobject_cast<QPushButton*>(sender());
        if (checked && btn) {
            statusLabel->setText(QString("当前选择: %1").arg(btn->text()));
        }
    }

private:
    QList<QPushButton*> buttons;
    QLabel *statusLabel;
};

int main(int argc, char *argv[]) {
    QApplication app(argc, argv);
    
    Example example;
    example.show();
    
    return app.exec();
}

重要特性

1. 自动分组规则

• 只有同一个父组件下的按钮才会形成排他组
• 只有checkable的按钮才会参与排他
• 不需要显式创建 QButtonGroup

2. 与 QButtonGroup 的区别

// 使用 setAutoExclusive（自动分组）
button1->setAutoExclusive(true);
button2->setAutoExclusive(true);
// 同一父组件下的按钮自动形成互斥组

// 使用 QButtonGroup（手动分组）
QButtonGroup *group = new QButtonGroup(this);
group->addButton(button1);
group->addButton(button2);
group->setExclusive(true); // 设置排他性

3. 实际应用场景

// 模拟单选按钮行为
QWidget *createOptionGroup() {
    QWidget *widget = new QWidget;
    QVBoxLayout *layout = new QVBoxLayout(widget);
    
    QStringList options = {"选项A", "选项B", "选项C", "选项D"};
    
    for (const QString &option : options) {
        QPushButton *btn = new QPushButton(option);
        btn->setCheckable(true);
        btn->setAutoExclusive(true);
        btn->setStyleSheet(
            "QPushButton {"
            "    text-align: left;"
            "    padding: 5px;"
            "}"
            "QPushButton:checked {"
            "    background-color: #0078d4;"
            "    color: white;"
            "}"
        );
        layout->addWidget(btn);
    }
    
    return widget;
}

注意事项

1. 父组件要求：自动排他性只在同一父组件下的按钮间有效
2. 可选中状态：必须调用 setCheckable(true) 才有效果
3. 性能考虑：对于大量按钮，使用 QButtonGroup 可能更高效
4. 动态添加：动态添加新按钮时会自动加入现有的排他组

综合示例

class ToolSelector : public QWidget {
public:
    ToolSelector(QWidget *parent = nullptr) : QWidget(parent) {
        QHBoxLayout *layout = new QHBoxLayout(this);
        
        // 创建工具按钮
        QStringList tools = {"选择", "画笔", "橡皮", "填充", "文字"};
        
        for (const QString &tool : tools) {
            QPushButton *btn = new QPushButton(tool);
            btn->setCheckable(true);
            btn->setAutoExclusive(true);
            btn->setFixedSize(60, 30);
            
            connect(btn, &QPushButton::toggled, [this, tool](bool checked) {
                if (checked) {
                    qDebug() << "选中工具:" << tool;
                }
            });
            
            layout->addWidget(btn);
        }
        
        // 默认选中第一个工具
        if (layout->count() > 0) {
            QPushButton *firstBtn = qobject_cast<QPushButton*>(layout->itemAt(0)->widget());
            if (firstBtn) {
                firstBtn->setChecked(true);
            }
        }
    }
};