Qt_布局管理器

前言：

    使用Qt时，在没有布局管理器（Layout）概念之前，在界面上创建控件都是用“绝对定位”来设置的，即调用setGeometry或move函数摆放，或者直接在ui文件中对控件进行手动的摆放，这些方式都会导致界面上的控件摆放存在偏差，影响整体美观。因此引入布局管理器机制，将界面上的控件都直接放到布局管理器下，布局管理器会自动对这些控件进行位置大小的调整，让整个界面看起来更加规整。

1、QVBoxLayout垂直布局

     QVBoxLayout表示垂直布局管理器，他也是一个控件，只不过该控件的作用是对内部的其他控件进行规整摆放。QVBoxLayout属性介绍如下：

layoutLeftMargin

左侧边距

layoutRightMargin

右侧边距

layoutTopMargin
上方边距
layoutBottomMargin
下方边距
layoutSpacing

相邻元素之间的间距

    与QVBoxLayout相关的常用接口：

addWidget（QWidget）
把控件添加到布局管理器中
setLayout（QLayout）是QWidget的接口，用于将布局管理器设置到widget下

1.1 QVBoxLayout的使用

    创建一个QVBoxLayout和三个按钮控件，将三个按钮控件放到该QVBoxLayout下，观察生成后的界面，代码如下：

#include "widget.h"
#include "ui_widget.h"
#include <QVBoxLayout>
#include <QPushButton>

Widget::Widget(QWidget *parent)
    : QWidget(parent)
    , ui(new Ui::Widget)
{
    ui->setupUi(this);

    QVBoxLayout* qv = new QVBoxLayout();//创建垂直布局管理器

    //创建三个按钮
    QPushButton* qp1 = new QPushButton("按钮1");
    QPushButton* qp2 = new QPushButton("按钮2");
    QPushButton* qp3 = new QPushButton("按钮3");

    //将三个按钮放到管理器下
    qv->addWidget(qp1);
    qv->addWidget(qp2);
    qv->addWidget(qp3);

    //将管理器设置到当前widge下
    this->setLayout(qv);

}

Widget::~Widget()
{
    delete ui;
}

    运行结果：

    从结果可以发现三个按钮规章有序的显示在界面上，并且对widget界面进行拉伸时，这三个按钮也会跟着拉伸的比例变化，如果这三个按钮直接放到widget界面上，则按钮尺寸不会随着widget界面的尺寸变化而变化。能够实现这个效果的原因是布局管理器作用在widget上，换句话说，一个widget只能有一个布局管理器并且布局管理器就是widget本身，所以对widget界面进行尺寸拉伸时，实际上就是对布局管理器做拉伸，进而导致布局管理器里的控件也跟着拉伸了。

1.2 多个布局管理器

    虽然一个widget下只能有一个布局管理器，但是可以通过ui文件中界面创建的方式在一个widget下生成多个布局管理器，操作如下：

    但是在运行程序后，发现对最终的界面进行拖拽则无法影响界面上的按钮，如下图：

    原因是通过ui文件手动式创建的Layout，实际上是先创建了一个widget，然后再将创建的Layout放到该widget下，所以上述界面中有3个widget，而我们拖拽的是最外层的widget尺寸，不会影响里面两个widget的尺寸，也就不会影响Layout里的按钮的尺寸了。

2、QHBoxLayout水平布局

     QHBoxLayout表示水平布局管理器，他的作用和QVBoxLayout是一样的，不过他是在水平方向摆放控件的，QHBoxLayout效果图如下：

    QHBoxLayout属性以及常用接口都和QVBoxLayout一样，因此这里就不再介绍了。

2.1 QHBoxLayout的使用

    创建一个QHBoxLayout和三个按钮控件，将三个按钮控件放到该QHBoxLayout下，观察生成后的界面，代码如下：

#include "widget.h"
#include "ui_widget.h"
#include <QHBoxLayout>
#include <QPushButton>

Widget::Widget(QWidget *parent)
    : QWidget(parent)
    , ui(new Ui::Widget)
{
    ui->setupUi(this);

    //创建水平布局管理器
    QHBoxLayout* qh = new QHBoxLayout();

    //创建三个按钮
    QPushButton* q1 = new QPushButton("按钮1");
    QPushButton* q2 = new QPushButton("按钮2");
    QPushButton* q3 = new QPushButton("按钮3");

    //将按钮添加到管理器中
    qh->addWidget(q1);
    qh->addWidget(q2);
    qh->addWidget(q3);

    //将管理器设置进当前widget中
    this->setLayout(qh);
}

Widget::~Widget()
{
    delete ui;
}

    运行结果：

2.2 嵌套的Layout

    在上述水平布局管理中添加一个垂直布局管理器，观察最终的现象，代码如下：

#include "widget.h"
#include "ui_widget.h"
#include <QHBoxLayout>
#include <QPushButton>
#include <QVBoxLayout>

Widget::Widget(QWidget *parent)
    : QWidget(parent)
    , ui(new Ui::Widget)
{
    ui->setupUi(this);

    //创建水平布局管理器
    QHBoxLayout* qh = new QHBoxLayout();

    //创建三个按钮
    QPushButton* q1 = new QPushButton("按钮1");
    QPushButton* q2 = new QPushButton("按钮2");
    QPushButton* q3 = new QPushButton("按钮3");

    //将按钮添加到管理器中
    qh->addWidget(q1);
    qh->addWidget(q2);
    qh->addWidget(q3);

    //将管理器设置进当前widget中
    this->setLayout(qh);

    //创建小Layout-垂直管理器
    QVBoxLayout* qh1 = new QVBoxLayout();

    //创建三个按钮
    QPushButton* q4 = new QPushButton("按钮4");
    QPushButton* q5 = new QPushButton("按钮5");
    QPushButton* q6 = new QPushButton("按钮6");

    //将按钮添加到小的垂直管理器中
    qh1->addWidget(q4);
    qh1->addWidget(q5);
    qh1->addWidget(q6);

    //将小垂直管理器添加到水平管理器中
    qh->addLayout(qh1);

}

Widget::~Widget()
{
    delete ui;
}

     运行结果：

    从上述的例子中可以总结一点：垂直布局管理器的控件添加方式是从下往上式的添加，而水平布局管理器是从右往左式的添加控件。 

3、QGridLayout网格布局

     QGridLayout表示网格布局，通俗来说就是水平和垂直布局的结合版，就如同一个二维数组，内部的控件就是数值上的元素。QGridLayout属性相比于上述两个控件的区别是：

layoutHorizontalSpacing

相邻元素之间⽔平⽅向的间距

layoutVerticalSpacing

相邻元素之间垂直⽅向的间距

layoutRowStretch

⾏⽅向的拉伸系数

layoutColumnStretch

列⽅向的拉伸系数

    QGridLayout的常用接口和上述两个控件也几乎相同。

3.1 QGridLayout的使用

    创建一个QGridLayout和四个按钮控件，将这四个按钮控件放到QGridLayout下，观察生成的界面，代码如下：

#include "widget.h"
#include "ui_widget.h"
#include <QGridLayout>
#include <QPushButton>

Widget::Widget(QWidget *parent)
    : QWidget(parent)
    , ui(new Ui::Widget)
{
    ui->setupUi(this);

    //创建QGridLayout
    QGridLayout* qg = new QGridLayout();

    //创建四个按钮
    QPushButton* p1 = new QPushButton("按钮1");
    QPushButton* p2 = new QPushButton("按钮2");
    QPushButton* p3 = new QPushButton("按钮3");
    QPushButton* p4 = new QPushButton("按钮4");

    //将按钮添加到QGridLayout中，注意表明出坐标
    qg->addWidget(p1,0,0);
    qg->addWidget(p2,0,1);
    qg->addWidget(p3,1,0);
    qg->addWidget(p4,1,1);

    this->setLayout(qg);

}

Widget::~Widget()
{
    delete ui;
}

    运行结果：

    可以从结果看到，界面上既能完成垂直布局，又能完成水平布局。

3.2 设置控件大小比例

    在QGridLayout中，可以设置以行、列为单位设置控件的拉伸系数，比如调用函数setColumnStretch就是设置列上所有控件的拉伸系数，调用函数setRowStretch就是设置行上所有控件的拉伸系数。注意设置拉伸系数不等于直接设置尺寸，拉伸系数表示与当前单位与其他单位的长度比例。例子如下：

    ①设置列拉伸（水平方向拉伸控件）：

#include "widget.h"
#include "ui_widget.h"
#include <QGridLayout>
#include <QPushButton>

Widget::Widget(QWidget *parent)
    : QWidget(parent)
    , ui(new Ui::Widget)
{
    ui->setupUi(this);

    //创建QGridLayout
    QGridLayout* qg = new QGridLayout();

    //创建四个按钮
    QPushButton* p1 = new QPushButton("按钮1");
    QPushButton* p2 = new QPushButton("按钮2");
    QPushButton* p3 = new QPushButton("按钮3");
    QPushButton* p4 = new QPushButton("按钮4");

    //将按钮添加到QGridLayout中，注意表明出坐标
    qg->addWidget(p1,0,0);
    qg->addWidget(p2,0,1);
    qg->addWidget(p3,1,0);
    qg->addWidget(p4,1,1);

    this->setLayout(qg);

    qg->setColumnStretch(0,1);//设置该列的拉伸系数是1
    qg->setColumnStretch(1,3);//设置该列的拉伸系数是3
    //则该第1列的长度是第0列的三倍
}

Widget::~Widget()
{
    delete ui;
}

    运行结果：

    结果是第1列的长度是第0列的三倍。

    ②设置列拉伸（垂直方向拉伸控件）：

#include "widget.h"
#include "ui_widget.h"
#include <QGridLayout>
#include <QPushButton>
#include <QSizePolicy>

Widget::Widget(QWidget *parent)
    : QWidget(parent)
    , ui(new Ui::Widget)
{
    ui->setupUi(this);

    //创建QGridLayout
    QGridLayout* qg = new QGridLayout();

    //创建四个按钮
    QPushButton* p1 = new QPushButton("按钮1");
    QPushButton* p2 = new QPushButton("按钮2");
    QPushButton* p3 = new QPushButton("按钮3");
    QPushButton* p4 = new QPushButton("按钮4");
    //因为每个按钮的垂直尺寸是固定的，因此要手动将按钮的垂直属性设置为拓展，目的是方便观察
    p1->setSizePolicy(QSizePolicy::Ignored,QSizePolicy::Expanding);
    p2->setSizePolicy(QSizePolicy::Ignored,QSizePolicy::Expanding);
    p3->setSizePolicy(QSizePolicy::Ignored,QSizePolicy::Expanding);
    p4->setSizePolicy(QSizePolicy::Ignored,QSizePolicy::Expanding);

    //将按钮添加到QGridLayout中，注意表明出坐标
    qg->addWidget(p1,0,0);
    qg->addWidget(p2,0,1);
    qg->addWidget(p3,1,0);
    qg->addWidget(p4,1,1);

    this->setLayout(qg);

    qg->setRowStretch(0,1);//设置该行的拉伸系数是1
    qg->setRowStretch(1,3);//设置该行的拉伸系数是3
    //则该第1行的长度是第0行的三倍
}

Widget::~Widget()
{
    delete ui;
}

    运行结果：

4、QFormLayout

    QFormLayout表示表单布局，QFormLayout的功能就比较单一了，他是专门实现只有两列的表单，可以看成是QGridLayout的一个分支控件，因此QFormLayout的属性和QGridLayout几乎一样，只是QFormLayout的添加控件接口为addRow，该接口介绍如下：

void addRow(QWidget *label, QWidget *field);
// 第⼀个控件固定是QLabel, 第⼆个控件可以是任意控件
// 如果把第⼀个参数填写为NULL, 则第一列什么都不显⽰，但是第二个参数不能为空

4.1 QFormLayout的使用

    QFormLayout常用于填写信息的场景， 因此模拟一个信息表单，首先创建一个QFormLayout ，和三个QLabel以及三个QLineEdit，实现代码如下：

#include "widget.h"
#include "ui_widget.h"
#include <QFormLayout>
#include <QLineEdit>
#include <QLabel>
#include <QPushButton>

Widget::Widget(QWidget *parent)
    : QWidget(parent)
    , ui(new Ui::Widget)
{
    ui->setupUi(this);

    //创建QFormLayout
    QFormLayout* qf = new QFormLayout;

    //创建三对QLabel和QLineEdit
    QLabel* q1 = new QLabel("姓名");
    QLabel* q2 = new QLabel("电话");
    QLabel* q3 = new QLabel("地址");

    QLineEdit* ql1 = new QLineEdit;
    QLineEdit* ql2 = new QLineEdit;
    QLineEdit* ql3 = new QLineEdit;

    //创建提交按钮
    QPushButton* qp = new QPushButton("提交");

    //将上述控件添加到QFormLayout中
    qf->addRow(q1,ql1);
    qf->addRow(q2,ql2);
    qf->addRow(q3,ql3);
    qf->addRow(nullptr,qp);

    this->setLayout(qf);
}

Widget::~Widget()
{
    delete ui;
}

    运行结果：

5、QSpacerItem

    QSpacerItem表示一段空白，他的作用是在使⽤布局管理器的时候，可能需要在控件之间添加⼀段空⽩，这时候就可以用QSpacerItem了。QSpacerItem属性介绍如下：

width

  QSpacerItem的 
 宽度 

height

  QSpacerItem的 
 ⾼度

hData
拉伸时，⽔平⽅向的 sizePolicy 的布局设置
vData

  拉伸时， 
 垂直⽅向的 sizePolicy 的布局设置

5.1 QSpacerItem的使用

    创建一个布局管理器，和两个按钮控件以及一个QSpacerItem，观察没有QSpacerItem的界面和有QSpacerItem的界面的区别，代码如下：

#include "widget.h"
#include "ui_widget.h"
#include <QPushButton>
#include <QHBoxLayout>
#include <QSpacerItem>

Widget::Widget(QWidget *parent)
    : QWidget(parent)
    , ui(new Ui::Widget)
{
    ui->setupUi(this);

    //创建一个布局管理器（水平或垂直都行）
    QHBoxLayout* qh = new QHBoxLayout();

    //创建两个按钮
    QPushButton* qp1 = new QPushButton("按钮1");
    QPushButton* qp2 = new QPushButton("按钮2");

    //创建QSpacerItem
    QSpacerItem* qs = new QSpacerItem(100,1);//初始化长、宽

    //将按钮放入布局管理器中
    qh->addWidget(qp1);
    qh->addSpacerItem(qs);
    qh->addWidget(qp2);

    this->setLayout(qh);
}

Widget::~Widget()
{
    delete ui;
}

     测试结果：

结语

    以上就是关于布局管理器的讲解，布局管理器整体使用难度不高，但他却是Qt开发中较为重要的一个控件，因为他保证了界面的规整度，同时也方便了开发者对控件规划的位置计算。

    最后如果本文有遗漏或者有误的地方欢迎大家在评论区补充，谢谢大家！！