文章目录
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
常用成员函数有:
函数原型 | 描述 |
---|---|
void setExclusive(bool); | 设置组内按钮是否互斥,不设置默认互斥(true) |
bool exclusive() const; | 获取组内按钮是否互斥的标志,true:互斥,false:不互斥 |
void addButton(QAbstractButton *, int id = -1); | 为按钮组添加按钮,为按钮设置id |
void removeButton(QAbstractButton *); | 从组内删除按钮 |
QList<QAbstractButton*> buttons() const; | 获取组内所有按钮 |
QAbstractButton * checkedButton() const; | 获取按钮组中被选中按钮的指针,如果没有按钮被选中,则返回nullptr |
int checkedId() const; | 获取按钮组中被选中按钮的id,如果没有按钮被选中,则返回-1 |
QAbstractButton *button(int id) const; | 通过按钮id索引按钮对象指针 |
int id(QAbstractButton *button) const; | 通过按钮对象指针索引按钮id |
void setId(QAbstractButton *button, int id); | 为按钮设置id |
QButtonGroup
共有8个信号,两两一组共4组:
信号 | 描述 |
---|---|
void buttonClicked(QAbstractButton *); void buttonClicked(int); | 按钮点击信号,按钮组中有按钮被点击发出此信号,并返回被点击的按钮对象指针或id |
void buttonPressed(QAbstractButton *); void buttonPressed(int); | 按钮按下信号,按钮组中有按钮被按下发出此信号,并返回被按下的按钮对象指针或id |
void buttonReleased(QAbstractButton *); void buttonReleased(int); | 按钮释放信号,按钮组中有按钮被释放发出此信号,并返回被释放的按钮对象指针或id |
void buttonToggled(QAbstractButton *, bool); void buttonToggled(int, bool); | 按钮状态改变信号,按钮组中有按钮状态改变发出此信号,并返回状态改变的按钮对象指针/id以及按钮当前状态(点击按钮或程序设置改变按钮状态都会发出此信息号) |
其中,返回按键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;
}
}