【Qt】Qt布局管理器

朴灿烈づ我的快乐病毒、 2022-11-14 14:53 218阅读 0赞

## 00. 目录 ##

### 文章目录 ###

*   *  00. 目录
     *  01. 概述
     *  02. 布局相关类
     *  03. 布局图示
     *  04. 为布局添加控件
     *  05. 伸展因素
     *  06. 布局中自定义控件
     *  07. 手动布局
     *  08. 附录

## 01. 概述 ##

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

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

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

**类之间的继承关系**

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2RlbmdqaW4yMDEwNDA0MjA1Ng_size_16_color_FFFFFF_t_70]

## 02. 布局相关类 ##

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

使用Qt Designer创建的界面生成的代码也使用了布局类。

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2RlbmdqaW4yMDEwNDA0MjA1Ng_size_16_color_FFFFFF_t_70 1]

## 03. 布局图示 ##

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

**QHBoxLayout**

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

![在这里插入图片描述][20210330105559687.png]

**QVBoxLayout**

把子窗口从上到下排列在一个垂直列上。  
![在这里插入图片描述][20210330105606555.png]

**QGridLayout**

把子窗口排列在一个二维的网格中，窗口可占据多个单元格。  
![在这里插入图片描述][202103301056123.png]

**QFormLayout**

把子窗口按照标签-输入框的形式排列在两列。  
![在这里插入图片描述][20210330105618347.png]

**使用布局提示**

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

**【注意】**

> 布局中的控件是安装了该布局的界面的子控件，而非布局自身的，控件只能以控件作为parent，不能是布局。也可以在布局中使用addLayout()来添加布局，内部的布局就会变成它的子布局。

## 04. 为布局添加控件 ##

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

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

## 05. 伸展因素 ##

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

如果你使用一个QHBoxLayout来布置没有伸展参数设置的三个控件，我们就会得到像下面这样的布局：  
![在这里插入图片描述][20210330105629544.png]

如果我们给每个控件设置一个伸展因素，它们就会被按比例布置（但是不能小于最小大小的提示），举例来说：  
![在这里插入图片描述][20210330105636442.png]

## 06. 布局中自定义控件 ##

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

QWidget::sizeHint() 返回控件的优先选用的大小。  
QWidget::minimumSizeHint() 返回控件所能有的最小大小。  
QWidget::setSizePolicy() 指定控件所需要的空间。  
只要大小提示、最小大小提示或者大小策略发生改变，都要调用QWidget::updateGeometry()。这会引起布局的重新计算。对updateGeometry()的多重调用只会引起一次重新计算。

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

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

详细描述请参考：`Trading Height for Width`.。

## 07. 手动布局 ##

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

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

## 08. 附录 ##

**8.1 Qt教程汇总**  
网址：[https://dengjin.blog.csdn.net/article/details/115174639][https_dengjin.blog.csdn.net_article_details_115174639]

**8.2 关键词**  
关键词：`Layout Management`

[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2RlbmdqaW4yMDEwNDA0MjA1Ng_size_16_color_FFFFFF_t_70]: /images/20221022/780e95906e7b40b7a2e7af40ce061e11.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2RlbmdqaW4yMDEwNDA0MjA1Ng_size_16_color_FFFFFF_t_70 1]: /images/20221022/5e36641b89dd4b44889234c0abef7ad9.png
[20210330105559687.png]: /images/20221022/c25e3138e84d486a8edb827eb227ee94.png
[20210330105606555.png]: /images/20221022/c9a9412f6ed64bf6bebc61cf15e79938.png
[202103301056123.png]: /images/20221022/4bac42e4e5fc42c48d7cae9b31aab3da.png
[20210330105618347.png]: /images/20221022/9b118248111f49189ea736e8107008aa.png
[20210330105629544.png]: /images/20221022/1058be8d91bb41cd9300677a574aa56f.png
[20210330105636442.png]: /images/20221022/fd8af1fadae7487d8d390584093c5cd4.png
[https_dengjin.blog.csdn.net_article_details_115174639]: https://dengjin.blog.csdn.net/article/details/115174639