## 前言

本系列介绍如何在 Python 中使用 Qt for Python 进行 GUI 应用程序开发。

• 第一篇文章：Qt for Python学习笔记—简介
• 第二篇文章：Qt for Python学习笔记—搭建开发环境
• 第三篇文章：Qt for Python学习笔记—应用程序初探
• 第四篇文章：Qt for Python学习笔记—应用程序再探
• 第五篇文章：Qt for Python—Qt Designer 概览
• 第六篇文章：Qt for Python—可视化开发GUI应用程序
• 第七篇文章：Qt for Python布局管理(1)—概览
• 第八篇文章：Qt for Python布局管理(2)—绝对定位
• 第九篇文章：Qt for Python布局管理(3)—水平布局
• 第十篇文章：Qt for Python布局管理(4)—垂直布局

本文是《Qt for Python 学习笔记》系列第十一篇，对 Qt for Python 的部件拉伸（伸缩因子的概念、设置伸缩因子的多种方法、水平布局伸缩因子示例代码及解析、垂直布局伸缩因子示例代码及解析）进行较为详细的介绍，让读者对 Qt for Python 部件拉伸（伸缩因子）相关内容有个较为全面的了解和掌握。

1. 部件拉伸及伸缩因子

1.0 术语

布局中的部件拉伸主要涉及到三个方面的因素：部件的尺寸策略、尺寸限制和伸缩因子。

1.1 尺寸策略

部件的尺寸策略规定了部件以何种策略（方式）进行拉伸（或压缩）。

比如部件不能被拉伸（或压缩），部件不能被压缩得比尺寸提示更小等。

通常情况下部件是可以拉伸的，但针对不同的部件存在不同的默认尺寸策略：

• 如对于 QPushButton、QLineEdit、QSpinBox 这类水平方向的部件，其默认尺寸策略是可以水平拉伸（或压缩），但垂直固定；
• 如对于 QToolButton 这类方形部件，其默认尺寸策略是可以双向（水平和垂直）拉伸（或压缩）；
• 如对于 QSlider、QScrollBar 这类支持不同方向的部件，则其默认尺寸策略是只能在指定相应的方向上拉伸（或压缩）。

尺寸策略会影响布局引擎处理部件的方式。当部件加入布局以后，会返回一个 QSizePolicy，其描述着控件在布局管理器中水平方向和垂直方向上进行拉伸（或压缩）的策略。

注：有关尺寸策略内容，本文暂作如上简单介绍，更多信息会在后续文章中加以介绍。

1.2 尺寸限制

部件的尺寸限制规定了部件可以被拉伸或压缩的范围。常见尺寸限制如下：

• 尺寸提示：指部件默认的尺寸（大小）。提示的意思是 Qt 的建议或推荐。
• 最小尺寸提示：指部件默认的最小尺寸（大小）。
• 最小尺寸：指部件被压缩到最小状态时的尺寸（大小）。
• 最大尺寸：指部件被拉伸到最大状态时的尺寸（大小）。
• 以及最小宽度、最小高度、最大宽度、最大高度。

尺寸限制的原则：任何部件都不能压缩得比最小尺寸更小（若未设置最小尺寸，则为最小尺寸提示）；任何部件都不能拉伸得比最大尺寸更大。

注：有关尺寸策略内容，本文暂作如上简单介绍，更多信息会在后续文章中加以介绍。

1.3 伸缩因子

伸缩因子描述了当窗口被拉伸（或压缩）时，布局中的各个部件之间应以怎样的比例进行拉伸（或压缩）。

有如下三种应用场景：

一、布局中所有部件的伸缩因子均大于0的情形

此时，布局中各部件按照各自伸缩因子的比例进行拉伸，分配各自可用空间，以填满整个布局可用空间。

例：在（水平或垂直）布局中有3个标签部件，这3个标签部件的伸缩因子分别设置为1、2和3，则当布局被拉伸时，这3个标签将按照1：2：3的比例进行拉伸以填满该布局全部可用空间。

二、布局中所有部件的伸缩因子均等于0的情形

此时，布局中各部件按照尺寸策略的规则进行拉伸，分配各自可用空间，以填满整个布局可用空间。

例：在（水平或垂直）布局中有3个标签部件，这3个标签部件的伸缩因子均设置为0，则当布局被拉伸时，这3个标签将按照1：1：1的比例进行拉伸以填满整个布局可用空间。

三、布局中部分部件的伸缩因子大于0，而部分部件的伸缩因子等于0的情形

此时，针对水平布局和垂直布局又分为两种子情形：

(1) 在水平布局中，布局中伸缩因子等于0的部件宽度不会被拉伸（始终保持不变），但垂直方向高度会填满布局可用高度；伸缩因子大于0的部件则会按照各自伸缩因子的比例进行拉伸以填满该布局剩余可用空间（布局空间减去伸缩因子为0的部件占据的空间）；

例：在水平布局中有3个标签部件，第1个标签部件伸缩因子设置为0，第2个、第3个标签部件的伸缩因子分别设置为1和2，则当布局被拉伸时，第1个标签部件，水平方向宽度始终保持不变，但垂直方向高度会填满布局可用高度；第2个和第3个标签部件则按照1：2的比例进行拉伸以填满布局剩余可用空间（布局空间减去标签1部件占据的空间）。

(2) 在垂直布局中，布局中伸缩因子等于0的部件高度不会被拉伸（始终保持不变），但水平方向宽度会填满布局可用宽度；伸缩因子大于0的部件则会按照各自伸缩因子的比例进行拉伸以填满该布局剩余可用空间（布局空间减去伸缩因子为0的部件占据的空间）；

例：在垂直布局中有3个标签部件，第1个标签部件伸缩因子设置为0，第2个、第3个标签部件的伸缩因子分别设置为1和2，则当布局被拉伸时，第1个标签部件，垂直方向高度始终保持不变，但水平方向宽度会填满布局可用宽度；第2个和第3个标签部件则按照1：2的比例进行拉伸以填满布局剩余可用空间（布局空间减去标签1部件占据的空间）。

注1：伸缩因子会使尺寸策略（除 QSizePolicy.Fixed 策略外)不起作用或失效。

注2：若部件的尺寸策略为 QSizePolicy.Fixed，则即使设置了伸缩因子，该部件也不会被拉伸（或压缩）

注3：若布局内所有部件的伸缩因子都为0，则按照尺寸策略的规则对部件进行拉伸。

2. 设置伸缩因子的几种方法

可以通过 QBoxLayout 类和 QSizePolicy 类中的几种方法来设置伸缩因子。

2.1 方法1

可以通过 QBoxLayout 类的 setStretchFactor() 函数为布局中指定部件/子布局设置伸缩因子。

一、函数声明

 @typing.overload
 def setStretchFactor(self, widget:PySide6.QtWidgets.QWidget, stretch:int) -> bool: ...
     
 @typing.overload
 def setStretchFactor(self, layout:PySide6.QtWidgets.QLayout, stretch:int) -> bool: ...

二、函数1说明

——功能：该函数为布局对象中的指定部件（widget）设置其伸缩因子（stretch）。

——参数（widget）：表示指定部件，类型为 QWidget。

——参数（stretch）：表示指定部件的伸缩因子，类型为 int。该参数可省略，缺省值为0。

三、函数2说明

——功能：该函数为布局对象中的指定子布局（layout）设置其伸缩因子（stretch）

——参数（layout）：表示指定子布局，类型为 QLayout。

——参数（stretch）：表示指定子布局的伸缩因子，类型为 int。该参数可省略，缺省值为0。

2.2 方法2

可以通过 QBoxLayout 类的 setStretch() 函数为布局中指定位置对应的部件/子布局设置伸缩因子。

一、函数声明

 def setStretch(self, index:int, stretch:int) -> None: ...

二、函数说明

——功能：该函数为布局对象的指定位置（index）对应的部件/子布局设置伸缩因子（stretch）。

——参数（index）：表示布局中的指定位置，类型为 int。索引从0开始，0表示第一个位置（水平布局从左往右，垂直布局从上往下）；若索引为负值表示插入到布局末尾。

——参数（stretch）：表示子布局的伸缩因子，类型为 int。该参数可省略，缺省值为0。

2.3 方法3

可以通过 QBoxLayout 类的 addWidget() 函数或 addLayout() 函数在将指定部件（widget）或指定子布局（layout）添加到布局对象末尾的同时，设置该部件或子布局的伸缩因子（stretch）。

一、函数声明

 def addWidget(self, widget:PySide6.QtWidgets.QWidget, stretch:int=..., alignment:PySide6.QtCore.Qt.Alignment=...) -> None: ...
     
 def addLayout(self, layout:PySide6.QtWidgets.QLayout, stretch:int=...) -> None: ...

二、函数1说明

——功能：该函数将指定部件（widget）添加到水平布局对象的末尾，同时设置该部件的伸缩因子（stretch）和对齐方式（alignment）。

——参数（widget）：表示待添加到水平布局对象中的部件，类型为 QWidget。

——参数（stretch）：表示部件的伸缩因子，类型为 int。该参数可省略，缺省值为0。

——参数（alignment）：表示部件的对齐方式，类型为 Qt.Alignment 枚举值。该参数可省略，缺省值为0。

三、函数2说明

——功能：该函数将指定子布局（layout）添加到水平布局对象的末尾，同时设置该子布局的伸缩因子（stretch）

——参数（layout）：表示待添加到水平布局对象中的子布局，类型为 QLayout。

——参数（stretch）：表示子布局的伸缩因子，类型为 int。该参数可省略，缺省值为0。

2.4 方法4

可以通过 QBoxLayout 类的 insertWidget() 函数或 insertLayout() 函数在布局指定位置（index）插入指定部件（widget）或指定子布局（layout）的同时，设置该部件的伸缩因子（stretch）。

一、函数声明

 def insertWidget(self, index:int, widget:PySide6.QtWidgets.QWidget, stretch:int=..., alignment:PySide6.QtCore.Qt.Alignment=...) -> None
 
 def insertLayout(self, index:int, layout:PySide6.QtWidgets.QLayout, stretch:int=...) -> None: ...

二、函数1说明

——功能：该函数在布局对象的指定位置（index）插入指定部件（widget），同时设置该部件的伸缩因子和对齐方式。

——参数（index）：表示布局对象中指定位置，类型为 int。索引从0开始，0表示第一个位置（水平布局从左往右，垂直布局从上往下）；若索引为负值表示插入到布局末尾。

——参数（widget）：表示待插入到水平布局对象中的部件，类型为 QWidget。

——参数（stretch）：表示部件的伸缩因子，类型为 int。该参数可省略，缺省值为0。

——参数（alignment）：表示部件的对齐方式，类型为 Qt.Alignment 枚举型。该参数可省略，缺省值为0。

三、函数2说明

——功能：该函数在布局对象的指定位置（index）插入指定子布局（layout），同时设置该部件的伸缩因子（stretch）。

——参数（index）：表示布局对象中指定位置，类型为 int。索引从0开始，0表示第一个位置（水平布局从左往右，垂直布局从上往下）；若索引为负值表示插入到布局末尾。

——参数（layout）：表示待添加到水平布局对象中的子布局，类型为 QLayout。

——参数（stretch）：表示子布局的伸缩因子，类型为 int。该参数可省略，缺省值为0。

2.5 方法5

可以通过 QSizePolicy 类的 setHorizontalStretch() 函数和 setVerticalStretch() 函数对指定部件设置其水平方向和垂直方向上的尺寸策略的伸缩因子。

一、函数声明

 def setHorizontalStretch(self, stretchFactor:int) -> None: ...
     
 def setVerticalStretch(self, stretchFactor:int) -> None: ...

二、函数1说明

——功能：设置水平方向上尺寸策略的伸缩因子，取值范围[0,255]。

——参数（stretchFactor）：表示水平方向上尺寸策略的伸缩因子，类型为 int。

注1：通常编码实践中，需先通过调用 sizePolicy() 方法获取部件的尺寸策略，并保存在一个尺寸策略变量（ QSizePolicy 类型）中；然后调用该变量的 setHorizontalStretch(stretch) 方法设置其水平方向上尺寸策略的伸缩因子；最后调用 setSizePolicy(尺寸策略变量) 方法重新设置该部件的尺寸策略（使设置的水平方向上尺寸策略的伸缩因子生效）。

注2：可以通过 QSizePolicy 类的 horizontalStretch() 函数来获取指定部件水平方向上尺寸策略的伸缩因子。

三、函数2说明

——功能：设置垂直方向上尺寸策略的伸缩因子，取值范围[0,255]。

——参数（stretchFactor）：表示垂直方向上尺寸策略的伸缩因子，类型为 int。

注1：通常编码实践中，需先通过调用 sizePolicy() 方法获取部件的尺寸策略，并保存在一个尺寸策略变量（ QSizePolicy 类型）中；然后调用该变量的 setVerticalStretch(stretch) 方法设置其垂直方向上尺寸策略的伸缩因子；最后调用 setSizePolicy(尺寸策略变量) 方法重新设置该部件的尺寸策略（使设置的垂直方向上尺寸策略的伸缩因子生效）。

注2：可以通过 QSizePolicy 类的 verticalStretch() 函数来获取指定部件垂直方向上尺寸策略的伸缩因子。

3. 水平布局（伸缩因子）示例

3.1 示例原型

在进行 GUI 应用程序编码之前，一般建议先勾画出 GUI 框架（窗体及各部件的布局等）。本示例原型如下：

3.2 示例目标

本示例目标是创建一个 Python GUI 应用程序，在主窗口中从左往右依次放置4个标签（QLabel）。

主窗口及部件的位置、尺寸及其他属性如下：

• 主窗口

——(1) 窗口位置及尺寸采用尺寸提示（默认大小）

——(2) 标题：水平布局伸缩因子示例程序

——(3) 具有窗口最小化、最大化、关闭快捷按钮

• 4个标签

——(1) 位置：4个标签从左往右依次排列

——(2) 尺寸：采用尺寸提示（默认大小）

——(3) 文本：4个标签文本依次为：“伸缩因子=0”、"伸缩因子=1"、"伸缩因子=2"、"伸缩因子=3"

——(4) 背景色：4个标签背景色依次为“SkyBlue”、“Pink”、“PaleGreen”、“Gold”

• 窗口伸缩时各部件自动进行同步自适应调整

——(1) 在水平方向，标签1的宽度始终保持不变，标签2、标签3、标签4的宽度会随窗口拉伸或压缩而自适应调整（按照1：2：3的比例填满布局剩余可用宽度）；但压缩到最小窗口时，标签2、标签3、标签4的宽度按各自最小宽度填满布局剩余可用宽度。

——(2) 在垂直方向，4个标签部件高度会随窗口拉伸或压缩而自适应调整，填满布局可用高度；

——(3) 在拉伸（或压缩）窗口时，标签四周的内容边距以及4个标签之间的水平间距始终保持不变。

3.3 示例代码

利用 Visual Studio Code 编辑代码，并保存为文件（如：C:\MyPySide6\MyPySide6VBoxLayoutStretchApp.py）。

 from PySide6.QtWidgets import (QApplication, QMainWindow, QWidget, QHBoxLayout, QLabel)
 
 class MyMainWindow(QMainWindow):
     def __init__(self):
         super(MyMainWindow, self).__init__()
 
         window = QWidget() 
         hBoxLayout = QHBoxLayout() 
         window.setLayout(hBoxLayout) 
 
         label_1 = QLabel("伸缩因子=0")
         label_2 = QLabel("伸缩因子=1")
         label_3 = QLabel("伸缩因子=2")
         label_4 = QLabel("伸缩因子=3")
         label_1.setStyleSheet("background-color: SkyBlue;")
         label_2.setStyleSheet("background-color: Pink;")
         label_3.setStyleSheet("background-color: PaleGreen;")
         label_4.setStyleSheet("background-color: Gold;")
 
         hBoxLayout.addWidget(label_1, 0)
         hBoxLayout.addWidget(label_2)
         hBoxLayout.insertWidget(2, label_4)
         hBoxLayout.insertWidget(2, label_3)
 
         hBoxLayout.setStretchFactor(label_2, 1)
         hBoxLayout.setStretch(2, 2)
         label_sp4 = label_4.sizePolicy()
         label_sp4.setHorizontalStretch(3)
         label_4.setSizePolicy(label_sp4)
 
         self.setCentralWidget(window) 
         self.setWindowTitle("水平布局伸缩因子示例程序")
 
 if __name__ == '__main__':
     import sys
 
     app = QApplication(sys.argv)
     gui = MyMainWindow()
     gui.show()
     sys.exit(app.exec_())

注：本示例代码中采用了4种方法来设置伸缩因子。

3.4 代码解析

本示例代码共分三部分：

一、导入模块（或类）部分

  from PySide6.QtWidgets import (QApplication, QMainWindow, QWidget,QHBoxLayout, QLabel)

——第1行代码：表示从 PySide6.QtWidgets 模块导入后续代码中会用到的 QApplication 类、QMainWindow 类、QWidget 类、QHBoxLayout 类、QLabel 类。

二、自定义MyMainWindow类部分

其次，自定义 MyMainWindow 类（即主窗口，继承自 QMainWindow 类）：

（一）定义类的声明

 class MyMainWindow(QMainWindow):

自定义 MyMainWindow 类的声明语句。类名为 MyMainWindow，该类继承自 QMainWindow 类。

（二）定义类的构造函数

 def __init__(self):
     super(MyMainWindow, self).__init__()
 
     window = QWidget() 
     hBoxLayout = QHBoxLayout() 
     window.setLayout(hBoxLayout) 
 
     label_1 = QLabel("伸缩因子=0")
     label_2 = QLabel("伸缩因子=1")
     label_3 = QLabel("伸缩因子=2")
     label_4 = QLabel("伸缩因子=3")
     label_1.setStyleSheet("background-color: SkyBlue;")
     label_2.setStyleSheet("background-color: Pink;")
     label_3.setStyleSheet("background-color: PaleGreen;")
     label_4.setStyleSheet("background-color: Gold;")
 
     hBoxLayout.addWidget(label_1, 0)
     hBoxLayout.addWidget(label_2)
     hBoxLayout.insertWidget(2, label_4)
     hBoxLayout.insertWidget(2, label_3)
 
     hBoxLayout.setStretchFactor(label_2, 1)
     hBoxLayout.setStretch(2, 2)
     label_sp4 = label_4.sizePolicy()
     label_sp4.setHorizontalStretch(3)
     label_4.setSizePolicy(label_sp4)
 
     self.setCentralWidget(window) 
     self.setWindowTitle("水平布局伸缩因子示例程序")

上述代码定义了自定义 MyMainWindow 类的构造函数：

——第1行代码：声明一个类构造函数（ __init__(self)），有一个传递参数（self）。

——第2行代码：通过 super() 方法继承了父类（QMainWindow）构造函数中的全部属性。

——第4行代码：通过实例化 QWidget 类创建一个窗口对象（window）。

——第5行代码：通过实例化 QHBoxLayout 类创建一个水平布局对象（hBoxLayout）。

——第6行代码：通过调用窗口对象的 setLayout() 方法将水平布局对象设置为窗口对象的布局管理器。

——第8-11行代码：通过实例化 QLabel 类依次创建4个标签（这4个标签会添加到水平布局中，故无需设置其父部件）

——第12-15行代码：通过调用标签对象的 setStyleSheet() 方法依次设置4个标签的背景色。

——第17行代码：调用水平布局对象（hBoxLayout）的 addwidget(widget, stretch) 方法将指定部件（传入参数 widget，这里为标签1）添加到布局末尾。此时标签1在布局中的位置所对应的索引值为0，即标签1放置在布局中的第一个位置（从左往右）；

同时采用第一种方法来设置部件（标签1）的伸缩因子：通过传递参数（stretch）设置标签1的伸缩因子为0，表示当窗口缩放时，标签1宽度始终保持不变，但其高度会随着窗口的缩放而填满布局可用高度。

——第18行代码：调用水平布局对象的 addwidget(widget) 方法将指定部件（传入参数 widget，这里为标签2）添加到布局末尾。此时标签2在布局中的位置所对应的索引值为1，即标签2放置在布局中的第二个位置（从左往右）。

——第19行代码：调用水平布局对象的 insertwidget(index, widget) 方法将指定部件（传入参数 widget，这里为标签4）插入到布局中的指定索引值（传入参数 index）为2的位置。此时标签4在布局中的位置所对应的索引值为2，即标签4放置在布局中的第三个位置（从左往右）。

注：这里是为了使用 insertwidget(index, widget) 方法，故意先添加标签4，然后接下来的语句再插入标签3。

——第20行代码：调用水平布局对象的 insertwidget(index, widget) 方法将指定部件（传入参数 widget，这里为标签3）插入到布局中的指定索引值（传入参数 index）为2的位置。此时标签3在布局中的位置所对应的索引值为2，即标签3放置在布局中的第三个位置（从左往右）。因索引值为2的位置原来是标签4放置的位置，此时被标签3占据后，则标签4的位置需要向右移动一个位置，于是标签4在布局中的位置所对应的索引值变为3，即标签4放置在布局中的第四个位置（从左往右）。

——第22行代码：采用第二种方法来设置部件（标签2）的伸缩因子，调用水平布局对象（hBoxLayout）的 setStretchFactor(widget, stretch) 方法为指定部件（传入参数 index，这里为标签2）设置其伸缩因子（传递参数 stretch）为1，表示当窗口缩放时，标签2会自适应同步缩放（占据布局空间减去标签1占据空间后的剩余空间的1/6）。

——第23行代码：采用第三种方法来设置部件（标签3）的伸缩因子，调用水平布局对象（hBoxLayout）的 setStretch(index, stretch) 方法为布局中指定位置（传入参数 index，这里为标签3）设置其伸缩因子（传递参数 stretch）为2，表示当窗口缩放时，标签3会自适应同步缩放（占据布局空间减去标签1占据空间后的剩余空间的2/6）。

——第24-26行代码：采用第四种方法来设置部件（标签4）的伸缩因子，

——(1) 首先调用标签4的 sizePolicy() 方法获取其的尺寸策略，并保存在 label_sp4 尺寸策略变量（QSizePolicy 类型）中。

——(2) 其次通过调用 setHorizontalStretch(stretch) 方法给 label_sp4 尺寸策略变量设置其水平方向上的伸缩因子为3，表示当窗口缩放时，标签4会自适应同步缩放（占据布局空间减去标签1占据空间后的剩余空间的3/6）。

——(3) 最后调用标签4的 setSizePolicy() 方法重新设置其尺寸策略（传入参数 label_sp4 尺寸策略变量）并生效。

——第28行代码：调用窗口的 setCentralWidget() 方法设置主窗口的中央部件为窗口对象（window）。

——第29行代码：调用窗口的 setWindowTitle() 方法设置主窗口的标题为"水平布局伸缩因子示例程序"。

三、设置文件运行入口部分

最后，在设置文件运行入口部分，完成创建应用程序、创建和显示自定义主窗口、运行应用程序直至退出。

  if __name__ == "__main__":
      import sys 
      
      app = QApplication(sys.argv)
      win = MyMainWindow()
      win.show()
      sys.exit(app.exec_())

——第1行代码：通过 if __name__ == "__main__": 语句来设置文件运行入口。

——第2行代码：导入 Python 内置的 sys 模块，接下的 sys.argv 和 sys.ext() 会用到该模块。

——第4行代码：使用 QApplication 类创建一个应用程序对象（app），括号内的 sys.argv 表示构造时含的传递参数。

——第5行代码：使用自定义的 MyMainWindow 类创建应用程序的主窗口对象（win）。

——第6行代码：调用主窗口对象（win）的 show() 方法来显示该主窗口。

——第7行代码：运行应用程序，直至退出。

3.5 示例程序运行

直接在 Visual Studio Code 上点击主窗体上运行图标按钮来运行该示例程序。

上图是程序运行后的三种窗口：

一、左上的是程序运行后的提示窗口（默认窗口）

——(1) 在水平方向，4个标签部件按尺寸提示（缺省大小）宽度填满布局可用宽度；

——(2) 在垂直方向，4个标签部件按尺寸提示（缺省大小）高度填满布局可用高度。

——(3) 在标签四周可以看见有内容边距（左侧、顶部、右侧、底部边距），在4个标签之间有水平间距。

二、右上的是程序运行后缩小后的窗口（最小窗口）

——(1) 在水平方向，4个标签部件宽度会随窗口缩小而自适应调整，按各部件最小宽度填满布局可用宽度；

——(2) 在垂直方向，4个标签部件高度会随窗口缩小而自适应调整，填满布局可用高度；

——(3) 在压缩窗口时，标签四周的内容边距以及4个标签之间的水平间距始终保持不变。

三、下面的是程序运行后拉伸后的窗口

——(1) 在水平方向，标签1的宽度始终保持不变，标签2、标签3、标签4的宽度会随窗口拉伸而自适应调整（按照1：2：3的比例填满布局剩余可用宽度）；

——(2) 在垂直方向，4个标签部件高度会随窗口缩小而自适应调整，填满布局可用高度；

——(3) 在拉伸窗口时，标签四周的内容边距以及4个标签之间的水平间距始终保持不变。

注1：布局具有内容边距（左侧、顶部、右侧、底部边距），布局内部各个子部件之间具有间距属性（水平方向为水平间距，垂直方向为垂直间距），通常情况下，内容边距属性和间距属性均有默认值，所以我们能看到四周的内容边距，以及各部件之间的间距。

注2：可以通过调用布局对象的 setContentsMargins(left, top, right, bottom) 方法来设置4个方向（左侧、顶部、右侧、底部边）上的内容边距值；可以通过调用布局对象的 setSpacing(spacing) 方法来设置布局中各个部件之间的间距值。有关更多内容边距和间距的内容会在后续文章中加以介绍。

4. 垂直布局（伸缩因子）示例

4.1 示例原型

在进行 GUI 应用程序编码之前，一般建议先勾画出 GUI 框架（窗体及各部件的布局等）。本示例原型如下：

4.2 示例目标

本示例目标是创建一个 Python GUI 应用程序，在主窗口中从上往下依次放置4个标签（QLabel）。

主窗口及部件的位置、尺寸及其他属性如下：

• 主窗口

——(1) 窗口位置及尺寸采用尺寸提示（默认大小）

——(2) 标题：垂直布局伸缩因子示例程序

——(3) 具有窗口最小化、最大化、关闭快捷按钮

• 4个标签

——(1) 位置：4个标签从上往下依次排列

——(2) 尺寸：采用尺寸提示（默认大小）

——(3) 文本：4个标签文本依次为：“伸缩因子=0”、"伸缩因子=1"、"伸缩因子=2"、"伸缩因子=3"

——(4) 背景色：4个标签背景色依次为“SkyBlue”、“Pink”、“PaleGreen”、“Gold”

• 窗口伸缩时各部件自动进行同步自适应调整

——(1) 在水平方向，4个标签部件宽度会随窗口拉伸或压缩而自适应调整，填满布局可用宽度；

——(2) 在垂直方向，标签1的高度始终保持不变，标签2、标签3、标签4的高度会随窗口拉伸或压缩而自适应调整（按照1：2：3的比例填满布局剩余可用高度）；但压缩到最小窗口时，标签2、标签3、标签4的高度按各自最小高度填满布局剩余可用高度；

——(3) 在拉伸（或压缩）窗口时，标签四周的内容边距以及4个标签之间的垂直间距始终保持不变。

4.3 示例代码

利用 Visual Studio Code 编辑代码，并保存为文件（如：C:\MyPySide6\MyPySide6VBoxLayoutStretchApp.py）。

 from PySide6.QtWidgets import (QApplication, QMainWindow, QWidget, QVBoxLayout, QLabel)
 
 class MyMainWindow(QMainWindow):
     def __init__(self):
         super(MyMainWindow, self).__init__()
 
         window = QWidget() 
         vBoxLayout = QVBoxLayout() 
         window.setLayout(vBoxLayout) 
 
         label_1 = QLabel("伸缩因子=0")
         label_2 = QLabel("伸缩因子=1")
         label_3 = QLabel("伸缩因子=2")
         label_4 = QLabel("伸缩因子=3")
         label_1.setStyleSheet("background-color: SkyBlue;")
         label_2.setStyleSheet("background-color: Pink;")
         label_3.setStyleSheet("background-color: PaleGreen;")
         label_4.setStyleSheet("background-color: Gold;")
 
         vBoxLayout.addWidget(label_1, 0)
         vBoxLayout.addWidget(label_2)
         vBoxLayout.insertWidget(2, label_4)
         vBoxLayout.insertWidget(2, label_3)
 
         vBoxLayout.setStretchFactor(label_2, 1)
         vBoxLayout.setStretch(2, 2)
         label_sp4 = label_4.sizePolicy()
         label_sp4.setVerticalStretch(3)
         label_4.setSizePolicy(label_sp4)
 
         self.setCentralWidget(window) 
         self.setWindowTitle("垂直布局伸缩因子示例程序")
 
 if __name__ == '__main__':
     import sys
 
     app = QApplication(sys.argv)
     gui = MyMainWindow()
     gui.show()
     sys.exit(app.exec_())

注：本示例代码中采用了4种方法来设置伸缩因子。

4.4 代码解析

本示例代码共分三部分：

一、导入模块（或类）部分

  from PySide6.QtWidgets import (QApplication, QMainWindow, QWidget, QVBoxLayout, QLabel)

——第1行代码：表示从 PySide6.QtWidgets 模块导入后续代码中会用到的 QApplication 类、QMainWindow 类、QWidget 类、QVVBoxLayout 类、QLabel 类。

二、自定义MyMainWindow类部分

其次，自定义 MyMainWindow 类（即主窗口，继承自 QMainWindow 类）：

（一）定义类的声明

 class MyMainWindow(QMainWindow):
     ...

自定义 MyMainWindow 类的声明语句。类名为 MyMainWindow，该类继承自 QMainWindow 类。

（二）定义类的构造函数

一、在定义类的构造函数中增加设置部件伸缩因子的语句

 def __init__(self):
     super(MyMainWindow, self).__init__()
 
     window = QWidget() 
     vBoxLayout = QVBoxLayout() 
     window.setLayout(vBoxLayout) 
 
     label_1 = QLabel("伸缩因子=0")
     label_2 = QLabel("伸缩因子=1")
     label_3 = QLabel("伸缩因子=2")
     label_4 = QLabel("伸缩因子=3")
     label_1.setStyleSheet("background-color: SkyBlue;")
     label_2.setStyleSheet("background-color: Pink;")
     label_3.setStyleSheet("background-color: PaleGreen;")
     label_4.setStyleSheet("background-color: Gold;")
 
     vBoxLayout.addWidget(label_1, 0)
     vBoxLayout.addWidget(label_2)
     vBoxLayout.insertWidget(2, label_4)
     vBoxLayout.insertWidget(2, label_3)
 
     vBoxLayout.setStretchFactor(label_2, 1)
     vBoxLayout.setStretch(2, 2)
     label_sp4 = label_4.sizePolicy()
     label_sp4.setVerticalStretch(3)
     label_4.setSizePolicy(label_sp4)
 
     self.setCentralWidget(window) 
     self.setWindowTitle("垂直布局伸缩因子示例程序")

上述代码定义了自定义 MyMainWindow 类的构造函数：

——第1行代码：声明一个类构造函数（ __init__(self)），有一个传递参数（self）。

——第2行代码：通过 super() 方法继承了父类（QMainWindow）构造函数中的全部属性。

——第4行代码：通过实例化 QWidget 类创建一个窗口对象（window）。

——第5行代码：通过实例化 QVBoxLayout 类创建一个垂直布局对象（vBoxLayout）。

——第6行代码：通过调用窗口对象的 setLayout() 方法将垂直布局对象设置为窗口对象的布局管理器。

——第8-11行代码：通过实例化 QLabel 类依次创建4个标签（这4个标签会添加到垂直布局中，故无需设置其父部件）

——第12-15行代码：通过调用标签对象的 setStyleSheet() 方法依次设置4个标签的背景色。

——第17行代码：调用垂直布局对象（vBoxLayout）的 addwidget(widget, stretch) 方法将指定部件（传入参数 widget，这里为标签1）添加到布局末尾。此时标签1在布局中的位置所对应的索引值为0，即标签1放置在布局中的第一个位置（从上往下）；

同时采用第一种方法来设置部件（标签1）的伸缩因子：通过传递参数（stretch）设置标签1的伸缩因子为0，表示当窗口缩放时，标签1高度始终保持不变，但其宽度会随着窗口的缩放而填满布局可用宽度。

——第18行代码：调用垂直布局对象的 addwidget(widget) 方法将指定部件（传入参数 widget，这里为标签2）添加到布局末尾。此时标签2在布局中的位置所对应的索引值为1，即标签2放置在布局中的第二个位置（从上往下）。

——第19行代码：调用垂直布局对象的 insertwidget(index, widget) 方法将指定部件（传入参数 widget，这里为标签4）插入到布局中的指定索引值（传入参数 index）为2的位置。此时标签4在布局中的位置所对应的索引值为2，即标签4放置在布局中的第三个位置（从上往下）。

注：这里是为了使用 insertwidget(index, widget) 方法，故意先添加标签4，然后接下来的语句再插入标签3。

——第20行代码：调用垂直布局对象的 insertwidget(index, widget) 方法将指定部件（传入参数 widget，这里为标签3）插入到布局中的指定索引值（传入参数 index）为2的位置。此时标签3在布局中的位置所对应的索引值为2，即标签3放置在布局中的第三个位置（从上往下）。因索引值为2的位置原来是标签4放置的位置，此时被标签3占据后，则标签4的位置需要向下移动一个位置，于是标签4在布局中的位置所对应的索引值变为3，即标签4放置在布局中的第四个位置（从上往下）。

——第22行代码：采用第二种方法来设置部件（标签2）的伸缩因子，调用垂直布局对象（vBoxLayout）的 setStretchFactor(widget, stretch) 方法为指定部件（传入参数 index，这里为标签2）设置其伸缩因子（传递参数 stretch）为1，表示当窗口缩放时，标签2会自适应同步缩放（占据布局空间减去标签1占据空间后的剩余空间的1/6）。

——第23行代码：采用第三种方法来设置部件（标签3）的伸缩因子，调用垂直布局对象（vBoxLayout）的 setStretch(index, stretch) 方法为布局中指定位置（传入参数 index，这里为标签3）设置其伸缩因子（传递参数 stretch）为2，表示当窗口缩放时，标签3会自适应同步缩放（占据布局空间减去标签1占据空间后的剩余空间的2/6）。

——第24-26行代码：采用第四种方法来设置部件（标签4）的伸缩因子，

——(1) 首先调用标签4的 sizePolicy() 方法获取其的尺寸策略，并保存在 label_sp4 尺寸策略变量（QSizePolicy 类型）中。

——(2) 其次通过调用 setVerticalStretch(stretch) 方法给 label_sp4 尺寸策略变量设置其垂直方向上的伸缩因子为3，表示当窗口缩放时，标签4会自适应同步缩放（占据布局空间减去标签1占据空间后的剩余空间的3/6）。

——(3) 最后调用标签4的 setSizePolicy() 方法重新设置其尺寸策略（传入参数 label_sp4 尺寸策略变量）并生效。

——第28行代码：调用窗口的 setCentralWidget() 方法设置主窗口的中央部件为窗口对象（window）。

——第29行代码：调用窗口的 setWindowTitle() 方法设置主窗口的标题为"水平布局伸缩因子示例程序"。

三、设置文件运行入口部分

此部分略，请参见本文第3.4章节中对应代码解析。

4.5 示例程序运行

直接在 Visual Studio Code 上点击主窗体上运行图标按钮来运行该示例程序。

上图是程序运行后的三种窗口：

一、左上的是程序运行后提示窗口（默认窗口）

——(1) 在水平方向，4个标签部件宽度填满窗口可用宽度；

——(2) 在垂直方向，4个标签部件高度均匀填满窗口可用高度。

——(3) 在标签四周可以看见有内容边距（左侧、顶部、右侧、底部边距），在4个标签之间有垂直间距。

二、左下的是程序运行后缩小后窗口（最小窗口）

——(1) 在水平方向，4个标签部件宽度会随窗口缩小而自适应调整，填满布局可用宽度；

——(2) 在垂直方向，4个标签部件高度会随窗口缩小而自适应调整，按各部件最小高度填满布局可用高度；

——(3) 在压缩窗口时，标签四周的内容边距以及4个标签之间的垂直间距始终保持不变。

三、右侧的是程序运行后拉伸后的窗口

——(1) 在水平方向，4个标签部件宽度会随窗口拉伸而自适应调整，填满布局可用宽度；

——(2) 在垂直方向，标签1的高度始终保持不变，标签2、标签3、标签4的高度会随窗口拉伸而自适应调整（按照1：2：3的比例填满剩余可用高度）；

——(3) 在拉伸窗口时，标签四周的内容边距以及4个标签之间的垂直间距始终保持不变。

结束语

本文是《Qt for Python 学习笔记》系列第十一篇，较为详细地介绍了 Qt for Python 的部件拉伸（伸缩因子的概念、设置伸缩因子的多种方法、水平布局伸缩因子示例代码及解析、垂直布局伸缩因子示例代码及解析），让读者对 Qt for Python 部件拉伸（伸缩因子）相关内容有个较为全面的了解和掌握。

接下来会介绍 Qt for Python 布局管理中的嵌套布局（水平布局结合垂直布局），敬请期待！

希望本文能对您有所帮助！若文中存在疏忽不足或错误，还请不吝赐教！