[Qt 教程之Widgets模块] —— QButtonGroup抽象容器

Qt系列教程总目录

0. QButtonGroup简介

QButtonGroup提供了一个抽象容器，可以将按钮小部件放入其中。它不提供此容器的可视化表示，而是管理组中每个按钮的状态。

互斥按钮组，将关闭除已单击的按钮外的所有可选中（可切换）按钮。默认情况下，按钮组是互斥的。按钮组中的按钮通常是可检查的，如QPushButtons、QCheckBoxes（通常用于非互斥按钮组）或QRadioButtons。如果创建互斥按钮组，则应确保最初选中该组中的一个按钮；否则，该组最初将处于未选中按钮的状态。

可以使用addButton()将按钮添加到组中，然后使用removeButton()将其删除。如果组是独占的，则当前选中的按钮可用于checkedButton()。如果单击按钮，则会发出buttonClicked()信号；对于独占组中的可检查按钮，这意味着该按钮已被选中。组中的按钮列表由button()返回。

此外，QButtonGroup可以在整数和按钮之间进行映射。您可以使用setId()为按钮分配一个整数id，并使用id()检索它。当前选中的按钮的id可以通过checkedId()获得，并且有一个重载的信号buttonClicked()，它会发出按钮的id。id值-1为QButtonGroup保留值，表示“没有这样的按钮”。映射机制的目的是简化用户界面中枚举值的表示。

1. 创建QButtonGroup

QButtonGroup的构造函数如下：

QButtonGroup(QObject *parent = nullptr);

接收一个对象指针作为其父对象。

2. 成员函数与信号

QButtonGroup常用成员函数有：

QButtonGroup共有8个信号，两两一组共4组：

其中，返回按键id的信号，在Qt5.15之后，就使用以下信号替代了，Qt5.15是过渡版本，之后版本和之前不兼容：

void buttonClicked(int);   -->   void idClicked(int);
void buttonPressed(int);   -->   void idPressed(int);
void buttonReleased(int);  -->   void idReleased(int);
void buttonToggled(int, bool);  -->  void idToggled(int, bool);

3. 示例

3.1. 为按钮组添加按钮

// 创建按钮组对象
QButtonGroup* btnGroup = new QButtonGroup(this);

// 为按钮组添加三个按钮，并设置id（id可以不设置）
btnGroup->addButton(ui->radioButton, 0);
btnGroup->addButton(ui->radioButton_1, 1);
btnGroup->addButton(ui->radioButton_2, 2);

如果不设置id，函数默认传入的值为-1，此时函数为自动为按钮设置id，自动设置的id为负数且从-2开始。

3.2. 为按钮设置id

btnGroup->setId(ui->radioButton, 0);

由于addButton函数的特性，这里设置id不能为-1（-1视为无效值），且建议使用正值。

3.3. 按钮组中按钮的互斥状态

// 获取按钮组中按钮的互斥状态
btnGroup->exclusive();

// 设置按钮组中按钮的互斥状态
btnGroup->setExclusive(false);

如不设置，获取按钮组中按钮的互斥状态默认为true，即同组中所有按钮互斥。

3.4. 获取组内所有按钮

QList<QAbstractButton*> btnList = btnGroup->buttons();

返回所有按钮的对象列表。

3.5. 获取按钮点击信号，并作相应操作

// 连接信号和槽函数
connect(m_btnGroup, SIGNAL(idClicked(int)), this, SLOT(btnClicked(int)));
        
// 槽函数
void btnClicked(int btnId)
{
    switch (btnId)
    {
    case 0:
        qDebug("This is button zreo");
        break;
    case 1:
        qDebug("This is button one");
        break;
    case 2:
        qDebug("This is button two");
        break;
    default:
        break;
    }
}