Qt应用开发(基础篇)——组合框容器 QGroupBox

一、前言

        QGroupBox继承于QWidget，是一个带有标题的组合框架容器控件。

         QGroupBox组合框容器自带一个顶部标题，一个面板。面板内部展示各种各样的部件，标题用来解释这些部件为什么集合在一起，并且支持键盘快捷方式切换部件焦点。比如下图是一个串口设置的属性，可能包含串口号、波特率、校验位、停止位、开关按钮等信息。

        QGroupBox一般直接在构造函数设置它的标题，精简解释组合框名称。组合框还可以具有选中checkable的属性，该属性保存组合框是否要开启复选框的功能，当然只要有这个属性，Qt肯定还会设计一个checked的属性，表示复选框是否选中和组合框是否使能。

        QGroupBox不会自动对子部件做布局layout功能，需要我们通过代码主动去添加或者design里面右击QGroupBox直接添加布局，一般是使用后者。

QGroupBox *groupBox = new QGroupBox(tr("Exclusive  Radio Buttons"));
groupBox->setFixedSize(200,200);
groupBox->move(100,100);
 
QRadioButton *radio1 = new QRadioButton(tr("&Radio button 1"));
QRadioButton *radio2 = new QRadioButton(tr("R&adio button 2"));
QRadioButton *radio3 = new QRadioButton(tr("Ra&dio button 3"));
radio1->setChecked(true);
QVBoxLayout *vbox = new QVBoxLayout;
vbox->addWidget(radio1);
vbox->addWidget(radio2);
vbox->addWidget(radio3);
vbox->addStretch(1);
groupBox->setLayout(vbox);

二、QGroupBox类

1、alignment

        该属性表示组合框的标题对齐方式，默认左对齐Qt::AlignLeft，由于标题默认在顶部，所以还可以设置为右对齐Qt::AlignRight或者Qt::AlignHCenter水平居中。

Qt::Alignment alignment() const
void setAlignment(int alignment)

2、checkable

        该属性表示组合框在标题中是否启动复选框，如果设置为true，那么组合框使能将根据复选框的状态改变使能的状态，默认情况下为false不启用。

bool isCheckable() const
void setCheckable(bool checkable)

3、checked

        该属性表示复选框的状态，也表示组合框的使能状态。基于checkable开启的状态，该属性才有意义。checkable开启的时候该属性默认为true。

bool isChecked() const
void setChecked(bool checked)

4、flat

        该属性表示是否组合框要使用“平”还是“框”的样式，默认是“框”的样式。如果启用该属性，只会保留顶部的框线，会显得有更多的空间，但是实际应用一般不会使用该样式。

bool isFlat() const
void setFlat(bool flat)

5、title

        改属性表示组合框的标题文本，标题文本同样支持“&”文本快捷方式，这个在很多控件我们都讲过了，这里就不描述了。

QString title() const
void setTitle(const QString &title)

6、信号

1、clicked

        当复选框被激活时(即，当鼠标光标在按钮内时按下然后释放)，或当键入快捷键时发出此信号。如果调用setChecked()，导致复选框状态被改变，不会发出此信号。

void clicked(bool checked = false)

2、toggled

        如果组框checkable是true，则在复选框被切换时发出此信号，On表示复选框状态。

void toggled(bool on)