简述

Qt的布局系统提供了一个简单的和强有力的方式，来自动排列窗口子控件布局。

所有QWidget子类可以使用布局来管理他们的子控件。QWidget::setLayout()函数可以为一个控件布局。当通过这种方式布局以后，它负责以下任务:

• 布置子控件。
• 最高层窗口可感知的默认大小。
• 最高层窗口可感知的最小大小。
• 调整大小的处理。
• 当内容改变的时候自动更新：
  • 字体大小、文本或者子控件的其它内容。
  • 隐藏或者显示子控件。
  • 移除一些子控件。

• 简述
• Qt的布局类
• 水平垂直网格表单布局
• 代码布局
• 为布局添加控件
  • 伸展因素
• 布局中自定义控件
• 手动布局
• 如何编写自定义布局管理器

Qt的布局类

Qt的布局类使用手写的C++代码设计的，所以很容易理解和使用。

使用Qt Designer创建的界面生成的代码也使用了布局类。涉及用户界面开发时，Qt Designer非常有用，因为它避免了编译、链接、运行这样一个循环。

水平、垂直、网格、表单布局

为窗口提供一个好布局的最佳方式是使用内置的布局管理器：QHBoxLayout、QVBoxLayout、QGridLayout和QFormLayout。这些类都派生自QLayout，QLayout又派生自QObject（非QWidget），布局窗口自动地把子窗口按照它们被构造地顺序进行布局。要生成更复杂的布局，可以在其它布局里面嵌入另一个布局。

• QHBoxLayout：把子窗口从左到右排列在一个水平行上。

• QVBoxLayout：把子窗口从上到下排列在一个垂直列上。

• QGridLayout：把子窗口排列在一个二维的网格中，窗口可占据多个单元格。

• QFormLayout：把子窗口按照标签-输入框的形式排列在两列。

代码布局

下面的代码创建一个管理五个按钮的水平布局，上面的第一张图所示：

QWidget *window = new QWidget;
QPushButton *button1 = new QPushButton("One");
QPushButton *button2 = new QPushButton("Two");
QPushButton *button3 = new QPushButton("Three");
QPushButton *button4 = new QPushButton("Four");
QPushButton *button5 = new QPushButton("Five");

QHBoxLayout *layout = new QHBoxLayout;
layout->addWidget(button1);
layout->addWidget(button2);
layout->addWidget(button3);
layout->addWidget(button4);
layout->addWidget(button5);

window->setLayout(layout);
window->show();

对于QVBoxLayout代码是相同的，除了QHBoxLayout 和QVBoxLayout区别以外。对于QGridLayout有点不同，因为需要指定子控件的行和列的位置：

QWidget *window = new QWidget;
QPushButton *button1 = new QPushButton("One");
QPushButton *button2 = new QPushButton("Two");
QPushButton *button3 = new QPushButton("Three");
QPushButton *button4 = new QPushButton("Four");
QPushButton *button5 = new QPushButton("Five");

QGridLayout *layout = new QGridLayout;
layout->addWidget(button1, 0, 0);
layout->addWidget(button2, 0, 1);
layout->addWidget(button3, 1, 0, 1, 2);
layout->addWidget(button4, 2, 0);
layout->addWidget(button5, 2, 1);

window->setLayout(layout);
window->show();

第三个QPushButton占据2列。通过指定QGridLayout:: addWidget()的第五参数为2来实现。

QFormLayout将在一行上添加两个控件，通常是QLabel和QLineEdit。在同一行中添加QLabel和QLineEdit，将把QLineEdit设置为QLabel的伙伴（在一起。。。(⊙o⊙)）。下面的代码将使用QFormLayout将3个QPushButton和相应QLineEdit排列起来。

QWidget *window = new QWidget;
QPushButton *button1 = new QPushButton("One");
QLineEdit *lineEdit1 = new QLineEdit();
QPushButton *button2 = new QPushButton("Two");
QLineEdit *lineEdit2 = new QLineEdit();
QPushButton *button3 = new QPushButton("Three");
QLineEdit *lineEdit3 = new QLineEdit();

QFormLayout *layout = new QFormLayout;
layout->addRow(button1, lineEdit1);
layout->addRow(button2, lineEdit2);
layout->addRow(button3, lineEdit3);

window->setLayout(layout);
window->show();

使用布局提示

当使用布局的时候，构建子控件的时候不需要指定parent，布局将会自动的指定parent（使用QWidget::setParent()），使它们成为安装了该布局的界面的子控件。

注意：布局中的控件是安装了该布局的界面的子控件，而非布局自身的，控件只能以控件作为parent，不能是布局。

也可以在布局中使用addLayout()来添加布局，内部的布局就会变成它的子布局。

为布局添加控件

当添加一个控件到一个布局中，布局过程工作如下：

• 所有的控件将最初根据它们的 QWidget::sizePolicy()和QWidget::sizeHint()而被分配到一定空间中。
• 如果任何一个控件有一个伸展因素设置，而且数值大于零，那么它们就会被根据它们的伸展因素的比例分配空间。
• 如果任何一个控件有一个伸展因素设置而且数值为零，那么只有当其它控件不再需要空间的时候才会得到更多的空间。在这当中，空间会首先被根据延展大小策略分配给控件。
• 任何控件被分配的空间的大小如果小于它们的最小大小（或者是在没有规定最小大小时的最小大小的提示），它们就会被按它们所需要的最小大小分配空间。（如果控件的伸展因素是它们的决定因素的情况下，它们不必有最小大小或者最小大小的提示。）
• 任何控件被分配的空间的大小如果大于它们的最大大小，它们就会被按它们所需要的最大大小分配空间。（如果控件的伸展因素是它们的决定因素的情况下，它们不必有最大大小。）

伸展因素

控件通常是在没有伸展因素设置的情况下被生成的。当它们被布置到一个布局中时，控件会被根据它们的QWidget::sizePolicy()或者它们的最小大小的提示中大的那一个分配给整个空间的一部分。伸展因素是用来根据控件互相的比例来改变它们所被分配的空间。

如果你使用一个QHBoxLayout来布置没有伸展参数设置的三个控件，我们就会得到像下面这样的布局：

如果我们给每个控件设置一个伸展因素，它们就会被按比例布置（但是不能小于最小大小的提示），举例来说：

布局中自定义控件

当你创建自己的控件类时，也应该传递它的布局属性。如果这个控件有一个QLayout，这样的话就已经被处理了。如果这个控件不包括任何子控件，或者使用自定义布局，需要重新实现下面这些QWidget的成员函数：

• QWidget::sizeHint() 返回控件的优先选用的大小。
• QWidget::minimumSizeHint() 返回控件所能有的最小大小。
• QWidget::setSizePolicy() 指定控件所需要的空间。

只要大小提示、最小大小提示或者大小策略发生改变，都要调用QWidget::updateGeometry()。这会引起布局的重新计算。对updateGeometry()的多重调用只会引起一次重新计算。

如果你的控件的优先选用的高度依赖于它的实际宽度（比如一个自动断词的标签），在sizePolicy()中设置hasHeightForWidth()标记，并且重新实现QWidget::heightForWidth()。

即使你实现了heightForWidth()，提供一个好的sizeHint()仍然是必需的。

进一步实现，请参考：Trading Height for Width.。

手动布局

如果要生成一种特殊的布局，也可以按上面的描述来生成一个自定义控件。重新实现QWidget::resizeEvent()来计算所需要分配的大小并且给每一个子控件调用setGeometry()。

当布局需要重新计算的时候，控件会得到一个类型是QEvent::LayoutRequest的事件。重新实现被通知QEvent::LayoutRequest事件的QWidget::event()。

如何编写自定义布局管理器

手动布局另一种方法是通过继承QLayout类来实现自己的布局管理器。

请参考：

• Qt之自定义布局管理器（QCardLayout）
• Qt之自定义布局管理器（QFlowLayout）
• Qt之自定义布局管理器（QBorderLayout）