QButtonGroup

一、描述

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

独占按钮组会关闭所有可切换状态的按钮，已单击的按钮除外。默认情况下，按钮组是独占的。如果创建独占按钮组，则应确保该组中的按钮之一被初始选中；否则，该组最初将处于未选中任何按钮的状态。

QButtonGroup 可以在整数和按钮之间进行映射。可以使用 setId() 为按钮分配一个整数 id，并使用 id() 检索它。

二、属性成员

1、exclusive : bool

按钮组是否独占。默认为 true。

如果为true，则只能选中组中的一个按钮。

在独占组中，用户无法通过点击取消选中当前选中的按钮。

三、成员函数

1、【信号】void buttonClicked(QAbstractButton *button)

单击给定按钮时会发出此信号。

2、【信号】void buttonPressed(QAbstractButton *button)

按下给定的按钮时会发出此信号。

3、【信号】void buttonReleased(QAbstractButton *button)

释放给定的按钮时发出此信号。

4、【信号】void buttonToggled(QAbstractButton *button, bool checked)

给定的按钮被切换状态时会发出这个信号。

如果按钮被选中，checked 为true，如果按钮未选中，则为false。

5、【信号】void idClicked(int id)

单击具有给定 id 的按钮时会发出此信号。

6、【信号】void idPressed(int id)

按下具有给定 id 的按钮时会发出此信号。

7、【信号】void idReleased(int id)

具有给定 id 的按钮被释放时，会发出此信号。

8、【信号】void idToggled(int id, bool checked)

切换具有给定 id 的按钮时会发出此信号。

如果按钮被选中，checked 为true，如果按钮未选中，则为false。 

9、void addButton(QAbstractButton *button, int id = -1)

将给定的按钮添加到按钮组。

如果 id 为 -1，则会为按钮分配一个 id。自动分配的 ID 保证为负，从 -2 开始。

如果要分配自己的 ID，请使用正值以避免冲突。

10、QAbstractButton *button(int id) 

返回具有指定 id 的按钮。

11、QList<QAbstractButton *> buttons()

返回按钮组的按钮列表。 

12、QAbstractButton *checkedButton()

返回按钮组的选中按钮。 

13、int checkedId()

返回checkedButton() 的id，如果没有选中按钮，则返回-1。 

14、int id(QAbstractButton *button)

返回指定按钮的 id，如果不存在这样的按钮，则返回 -1。 

15、void removeButton(QAbstractButton *button)

从按钮组中删除给定的按钮。 

16、void setId(QAbstractButton *button, int id)

设置指定按钮的 id。id 不能为 -1。