前言

本系列介绍如何在 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)—水平布局(1)

本文是《Qt for Python 学习笔记》系列第十篇，对 Qt for Python 的水平布局（设置拉伸因子、对齐方式的概念、函数、示例代码及解析）进行介绍，让读者对 Qt for Python 水平布局有个更加深入的了解和掌握。

1. 简介

参见本系列上一篇文章（Qt for Python布局管理(3)—水平布局(1) ）中第1章内容。

2. 盒式布局管理器

参见本系列上一篇文章（Qt for Python布局管理(3)—水平布局(1) ）中第2章内容。

3. 水平布局管理器

参见本系列上一篇文章（Qt for Python布局管理(3)—水平布局(1) ）中第3章内容。

4. 利用水平布局管理器对部件进行布局的基本步骤

参见本系列上一篇文章（Qt for Python布局管理(3)—水平布局(1) ）中第4章内容。

5. 水平布局管理器应用主要函数介绍

下面接本系列上一篇文章（Qt for Python布局管理(3)—水平布局(1) ）的第5.6章节后的内容。

5.7 为指定部件/子布局设置拉伸因子的函数

一、拉伸因子

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

有如下三种应用场景：

(一) 布局中所有部件的拉伸因子均大于0的情形

此时，布局中各部件按照各自拉伸因子的比例进行拉伸，分配各自可用空间，以填满整个布局可用空间。例：在水平布局中有2个按钮，这2个按钮部件的拉伸因子分别为1和2，则将窗口被拉伸时，这2个按钮将按照1：2的比例进行拉伸以填满整个布局可用空间。

(二) 布局中所有部件的拉伸因子均等于0的情形

此时，布局中各部件按照大小策略的规则进行拉伸，分配各自可用空间，以填满整个布局可用空间。例：在水平布局中有2个按钮，这2个按钮部件的拉伸因子均为0，则将窗口被拉伸时，这2个按钮将按照1：1的比例进行拉伸以填满整个布局可用空间。

(三) 布局中部分部件的拉伸因子大于0，而部分部件的拉伸因子等于0的情形

此时，布局中拉伸因子等于0的部件不会被拉伸，拉伸因子大于0的部件会按照各自拉伸因子的比例进行拉伸，分配各自可用空间，以填满整个布局可用空间。例：在水平布局中有3个按钮，第1个按钮拉伸因子为0，第2个、第3个按钮部件的拉伸因子分别为1和2，则当窗口被拉伸时，第1个按钮保持不变，第2个和第3个按钮则按照1：2的比例进行拉伸以填满整个布局可用空间。

注1：若部件的大小策略设置为 Fixed，则即使设置了拉伸因子，该部件也不会被拉伸。

注2：若拉伸因子等于0，则只有在其他部件不需要空间时才会获得可用空间。

二、函数声明

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

上述函数继承自 QBoxLayout 类。

三、函数1说明

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

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

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

四、函数2说明

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

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

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

五、函数3说明

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

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

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

5.8 为指定部件/子布局设置对齐方式的函数

一、对齐方式简介

在 PySide6.QtCore 模块中 Qt 类中的 AlignmentFlag 类中有各种对齐方式的枚举常量：

 class AlignmentFlag(object):
     AlignLeading             : Qt.AlignmentFlag = ... # 0x1
     AlignLeft                : Qt.AlignmentFlag = ... # 0x1
     AlignRight               : Qt.AlignmentFlag = ... # 0x2
     AlignTrailing            : Qt.AlignmentFlag = ... # 0x2
     AlignHCenter             : Qt.AlignmentFlag = ... # 0x4
     AlignJustify             : Qt.AlignmentFlag = ... # 0x8
     AlignAbsolute            : Qt.AlignmentFlag = ... # 0x10
     AlignHorizontal_Mask     : Qt.AlignmentFlag = ... # 0x1f
     AlignTop                 : Qt.AlignmentFlag = ... # 0x20
     AlignBottom              : Qt.AlignmentFlag = ... # 0x40
     AlignVCenter             : Qt.AlignmentFlag = ... # 0x80
     AlignCenter              : Qt.AlignmentFlag = ... # 0x84
     AlignBaseline            : Qt.AlignmentFlag = ... # 0x100
     AlignVertical_Mask       : Qt.AlignmentFlag = ... # 0x1e0

（一）水平对齐方式标志常量如下表：

（二）垂直对齐方式标志常量如下表：

（三）水平垂直同时对齐方式标志常量如下表：

二、函数声明

 @typing.overload
 def setAlignment(self, alignment:PySide6.QtCore.Qt.Alignment) -> None: 
 @typing.overload
 def setAlignment(self, widget:PySide6.QtWidgets.QWidget, alignment:PySide6.QtCore.Qt.Alignment) -> bool: 
 @typing.overload
 def setAlignment(self, layout:PySide6.QtWidgets.QLayout, alignment:PySide6.QtCore.Qt.Alignment) -> bool: 

上述函数继承自 QLayout 类。

三、函数1说明

——功能：该函数设置对齐方式（alignment）。

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

四、函数2说明

——功能：该函数为水平布局对象中的指定部件（widget）设置其对齐方式（alignment）。

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

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

五、函数3说明

——功能：该函数为水平布局对象中的指定子布局（layout）设置其对齐方式（alignment）。

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

——参数（alignment）：表示指定子布局的对齐方式，类型为 Qt.Alignment 枚举常量。该参数可省略，缺省值为0。

6. 水平布局示例

参见本系列上一篇文章（Qt for Python布局管理(3)—水平布局(1) ）第6章内容。

7. 水平布局示例（拉伸因子）

7.1 示例原型

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

7.2 示例目标

本示例目标是在第6.2章节描述的示例目标基础上，增加各部件设置了拉伸因子后的效果。

• 窗口缩放时各部件按设置的拉伸因子进行自适应调整

——(1) 水平方向：按钮一宽度保持不变，按钮二、按钮三、按钮四的宽度能同步自适应调整（按照1：2：3的比例分享剩余空间，剩余空间宽度 = 窗口宽度 - 按钮一宽度）

——(2) 垂直方向：4个按钮宽度保持不变

7.3 示例代码2-1及解析

一、编辑保存示例代码2-1

利用 Visual Studio Code 在第6.3章节示例代码基础上进行编辑，并另存为文件（如：C:\MyPySide6\MyPySide6HBoxLayoutApp02-1.py）。

 from PySide6.QtWidgets import (QApplication, QMainWindow, QWidget,QHBoxLayout, QPushButton)
 
 class MyMainWindow(QMainWindow):
     def __init__(self):
         super(MyMainWindow, self).__init__()
 
         window = QWidget() 
         hBoxLayout = QHBoxLayout() 
         window.setLayout(hBoxLayout) 
 
         btn_1 = QPushButton('按钮一')
         btn_2 = QPushButton('按钮二')
         btn_3 = QPushButton('按钮三')
         btn_4 = QPushButton('按钮四')
         btn_1.setStyleSheet("background-color: SkyBlue;")
         btn_2.setStyleSheet("background-color: Pink;")
         btn_3.setStyleSheet("background-color: PaleGreen;")
         btn_4.setStyleSheet("background-color: Gold;")
 
         hBoxLayout.addWidget(btn_1, 0)
         hBoxLayout.addWidget(btn_2, 1)
         hBoxLayout.insertWidget(2, btn_4, 3)
         hBoxLayout.insertWidget(2, btn_3, 2)        
         
         self.setCentralWidget(window) 
         self.setWindowTitle("水平布局示例程序")
 
 if __name__ == '__main__':
     import sys
 
     app = QApplication(sys.argv)
     gui = MyMainWindow()
     gui.show()
     sys.exit(app.exec_())

二、示例代码2-1解析

示例代码2-1基于上一篇文章（Qt for Python布局管理(3)—水平布局(1) ）中第6.3章节示例代码，在本节中对已经解析过的代码就不再解析，只是针对变化之处进行解析。

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

 def __init__(self):
     super(MyMainWindow, self).__init__()
 
     window = QWidget() 
     hBoxLayout = QHBoxLayout() 
     window.setLayout(hBoxLayout) 
 
     btn_1 = QPushButton('按钮一')
     btn_2 = QPushButton('按钮二')
     btn_3 = QPushButton('按钮三')
     btn_4 = QPushButton('按钮四')
     btn_1.setStyleSheet("background-color: SkyBlue;")
     btn_2.setStyleSheet("background-color: Pink;")
     btn_3.setStyleSheet("background-color: PaleGreen;")
     btn_4.setStyleSheet("background-color: Gold;")
         
     hBoxLayout.addWidget(btn_1, 0)
     hBoxLayout.addWidget(btn_2, 1)
     hBoxLayout.insertWidget(2, btn_4, 3)
     hBoxLayout.insertWidget(2, btn_3, 2)    
         
     self.setCentralWidget(window) 
     self.setWindowTitle("水平布局示例程序")

上述第17-20行代码语句，通过增加传入参数（stretch）来添加设置各部件的拉伸因子：

++第17行代码：调用水平布局对象的 addwidget(widget, stretch) 方法

——(1) 将指定部件（传入参数 widget，这里为按钮一）添加到水平布局对象（hBoxLayout）末尾。此时按钮一在水平布局中的位置所对应的索引值为0，即按钮一放置在水平布局中的第一个位置（从左往右）。

——(2) 同时通过传入参数（stretch）设置按钮一的拉伸因子为0，表示按钮一不会随着窗口的缩放而进行自适应拉伸（即其尺寸保持固定不变）。

++第18行代码：调用水平布局对象的 addwidget(widget, stretch) 方法

——(1) 将指定部件（传入参数 widget，这里为按钮二）添加到水平布局对象（hBoxLayout）末尾。此时按钮二在水平布局中的位置所对应的索引值为1，即按钮二放置在水平布局中的第二个位置（从左往右）。

——(2) 同时通过传入参数（stretch）设置按钮二的拉伸因子为1，表示按钮二会随着窗口的缩放而进行自适应拉伸。

++第19行代码：调用水平布局对象的 insertwidget(index, widget, stretch) 方法

——(1) 将指定部件（传入参数 widget，这里为按钮四）插入到水平布局对象（hBoxLayout）中的指定索引值（传入参数 index）为2的位置。此时按钮四在水平布局中的位置所对应的索引值为2，即按钮四放置在水平布局中的第三个位置（从左往右）。

——(2) 同时通过传入参数（stretch）设置按钮四的拉伸因子为3，表示按钮四会随着窗口的缩放而进行自适应拉伸（是按钮二拉伸后宽度的3倍）。

++第20行代码：调用水平布局对象的 insertwidget(index, widget, stretch) 方法

——(1) 将指定部件（传入参数 widget，这里为按钮三）插入到水平布局对象（hBoxLayout）中的指定索引值（传入参数 index）为2的位置。此时按钮三在水平布局中的位置所对应的索引值为2，即按钮三放置在水平布局中的第三个位置（从左往右）。因索引值为2的位置原来是按钮四放置的位置，此时被按钮三占据后，则按钮四的位置需要向右移动一个位置，于是按钮四在水平布局中的位置所对应的索引值变为3，即按钮四放置在水平布局中的第四个位置（从左往右）。

——(2) 同时通过传入参数（stretch）设置按钮三的拉伸因子为2，表示按钮三会随着窗口的缩放而进行自适应拉伸（是按钮二拉伸后宽度的2倍）。

7.4 示例代码2-2及解析

也可以通过调用布局对象的 setStretchFactor(widget, stretch) 方法来对布局对象中的指定部件（widget）设置其拉伸因子（stretch）。或通过调用布局对象的 setStretch(index, stretch) 方法来对布局对象中的指定位置（index）对应的部件设置其拉伸因子（stretch）。

本示例代码2-2与示例代码2-1中部分代码语句略有差异，但两者均实现了相同的目标。

一、编辑保存示例代码2-2

利用 Visual Studio Code 在第6.3章节示例代码基础上进行编辑，并另存为文件（如：C:\MyPySide6\MyPySide6HBoxLayoutApp02-2.py）。

 from PySide6.QtWidgets import (QApplication, QMainWindow, QWidget,QHBoxLayout, QPushButton)
 
 class MyMainWindow(QMainWindow):
     def __init__(self):
         super(MyMainWindow, self).__init__()
 
         window = QWidget() 
         hBoxLayout = QHBoxLayout() 
         window.setLayout(hBoxLayout) 
 
         btn_1 = QPushButton('按钮一')
         btn_2 = QPushButton('按钮二')
         btn_3 = QPushButton('按钮三')
         btn_4 = QPushButton('按钮四')
         btn_1.setStyleSheet("background-color: SkyBlue;")
         btn_2.setStyleSheet("background-color: Pink;")
         btn_3.setStyleSheet("background-color: PaleGreen;")
         btn_4.setStyleSheet("background-color: Gold;")
 
         hBoxLayout.addWidget(btn_1)
         hBoxLayout.addWidget(btn_2)
         hBoxLayout.insertWidget(2, btn_4)
         hBoxLayout.insertWidget(2, btn_3)
 
         hBoxLayout.setStretchFactor(btn_1, 0)
         hBoxLayout.setStretchFactor(btn_2, 1)
         hBoxLayout.setStretch(2, 2)
         hBoxLayout.setStretch(3, 3)      
         
         self.setCentralWidget(window) 
         self.setWindowTitle("水平布局示例程序")
 
 if __name__ == '__main__':
     import sys
 
     app = QApplication(sys.argv)
     gui = MyMainWindow()
     gui.show()
     sys.exit(app.exec_())

二、示例代码2-2解析

示例代码2-2基于上一篇文章（Qt for Python布局管理(3)—水平布局(1) ）中第6.3章节示例代码，在本节中对已经解析过的代码就不再解析，只是针对变化之处进行解析。

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

 def __init__(self):
     super(MyMainWindow, self).__init__()
 
     window = QWidget() 
     hBoxLayout = QHBoxLayout() 
     window.setLayout(hBoxLayout) 
 
     btn_1 = QPushButton('按钮一')
     btn_2 = QPushButton('按钮二')
     btn_3 = QPushButton('按钮三')
     btn_4 = QPushButton('按钮四')
     btn_1.setStyleSheet("background-color: SkyBlue;")
     btn_2.setStyleSheet("background-color: Pink;")
     btn_3.setStyleSheet("background-color: PaleGreen;")
     btn_4.setStyleSheet("background-color: Gold;")
         
     hBoxLayout.addWidget(btn_1)
     hBoxLayout.addWidget(btn_2)
     hBoxLayout.insertWidget(2, btn_4)
     hBoxLayout.insertWidget(2, btn_3)
     
     hBoxLayout.setStretchFactor(btn_1, 0)
     hBoxLayout.setStretchFactor(btn_2, 1)
     hBoxLayout.setStretch(2, 2)
     hBoxLayout.setStretch(3, 3)
         
     self.setCentralWidget(window) 
     self.setWindowTitle("水平布局示例程序")

上述第22-25行代码依次对4个按钮部件的拉伸因子进行了设置：

——第22行代码：调用水平布局对象的 setStretchFactor(widget, stretch) 方法通过传入参数 stretch 设置水平布局对象（hBoxLayout）中的指定部件（传入参数 widget，这里指按钮一）的拉伸因子为0，表示按钮一不会随着窗口的缩放而进行自适应拉伸（即其尺寸保持固定不变）。

——第23行代码：调用水平布局对象的 setStretchFactor(widget, stretch) 方法传入参数 stretch 设置水平布局对象（hBoxLayout）中的指定部件（传入参数 widget，这里指按钮二）的拉伸因子设置为1，表示按钮二会随着窗口的缩放而进行自适应拉伸。

——第24行代码：调用水平布局对象的 setStretch(index, stretch) 方法通过传入参数 stretch 将水平布局对象（hBoxLayout）中的指定索引值（传入参数 index）为2的位置所对应的部件（传入参数 widget，这里指按钮三）的拉伸因子设置为2，表示按钮三会随着窗口的缩放而进行自适应拉伸，是按钮二拉伸后宽度的2倍。

——第25行代码：调用水平布局对象的 setStretch(index, stretch) 方法通过传入参数 stretch 将水平布局对象（hBoxLayout）中的指定索引值（传入参数 index）为3的位置所对应的部件（传入参数 widget，这里指按钮四）的拉伸因子设置为3，表示按钮四会随着窗口的缩放而进行自适应拉伸，是按钮二拉伸后宽度的3倍。

注：当程序窗口拉伸时，在水平方向上：按钮一宽度保存不变，按钮二、按钮三、按钮四的宽度按1：2：3的比例分享剩余宽度值（= 拉伸后窗口宽度 - 按钮一宽度）。

7.5 示例程序运行

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

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

一、上面的是程序运行后提示窗口（原始窗口）

——(1) 此时在水平方向4个按钮均匀排列。

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

——(1) 此时在水平方向，按钮一宽度保持不变，按钮二、按钮三、按钮四的宽度能自适应调整（按照1：2：3的比例分享剩余空间）；

——(2) 在垂直方向4个按钮高度保持不变。

8. 水平布局示例（拉伸因子+对齐方式）

8.1 示例原型

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

8.2 示例目标

本示例目标是在第7.2章节描述的示例目标基础上，增加各部件设置了对齐方式后的效果。

• 各部件对齐方式

——(1) 按钮一：水平方向调整间距两端对齐（Qt.AlignJustify）

——(2) 按钮二：垂直顶部对齐（Qt.AlignTop）

——(3) 按钮三：垂直居中对齐（Qt.AlignVCenter）

——(4) 按钮四：垂直底部对齐（Qt.AlignBottom）

8.3 示例代码3-1及解析

一、编辑保存示例代码3-1

利用 Visual Studio Code 在第7.3章节示例代码2-1基础上进行编辑，并另存为文件（如：C:\MyPySide6\MyPySide6HBoxLayoutApp03-1.py）。

 from PySide6.QtWidgets import (QApplication, QMainWindow, QWidget,QHBoxLayout, QPushButton)
 from PySide6.QtCore import Qt
 
 class MyMainWindow(QMainWindow):
     def __init__(self):
         super(MyMainWindow, self).__init__()
 
         window = QWidget() 
         hBoxLayout = QHBoxLayout() 
         window.setLayout(hBoxLayout) 
 
         btn_1 = QPushButton('按钮一')
         btn_2 = QPushButton('按钮二')
         btn_3 = QPushButton('按钮三')
         btn_4 = QPushButton('按钮四')
         btn_1.setStyleSheet("background-color: SkyBlue;")
         btn_2.setStyleSheet("background-color: Pink;")
         btn_3.setStyleSheet("background-color: PaleGreen;")
         btn_4.setStyleSheet("background-color: Gold;")
         
         hBoxLayout.addWidget(btn_1, 0, Qt.AlignJustify)
         hBoxLayout.addWidget(btn_2, 1, Qt.AlignTop)
         hBoxLayout.insertWidget(2, btn_4, 3, Qt.AlignBottom)
         hBoxLayout.insertWidget(2, btn_3, 2, Qt.AlignVCenter)
 
         self.setCentralWidget(window) 
         self.setWindowTitle("水平布局示例程序")
 
 if __name__ == '__main__':
     import sys
 
     app = QApplication(sys.argv)
     gui = MyMainWindow()
     gui.show()
     sys.exit(app.exec_())

二、示例代码3-1解析

示例代码3-1基于第7.3章节示例代码2-1，在本节中对已经解析过的代码就不再解析，只是针对变化之处进行解析。

一、在定义类的构造函数中增加设置各部件的对齐方式

 def __init__(self):
     super(MyMainWindow, self).__init__()
 
     window = QWidget() 
     hBoxLayout = QHBoxLayout() 
     window.setLayout(hBoxLayout) 
 
     btn_1 = QPushButton('按钮一')
     btn_2 = QPushButton('按钮二')
     btn_3 = QPushButton('按钮三')
     btn_4 = QPushButton('按钮四')
     btn_1.setStyleSheet("background-color: SkyBlue;")
     btn_2.setStyleSheet("background-color: Pink;")
     btn_3.setStyleSheet("background-color: PaleGreen;")
     btn_4.setStyleSheet("background-color: Gold;")
         
     hBoxLayout.addWidget(btn_1, 0, Qt.AlignJustify)
     hBoxLayout.addWidget(btn_2, 1, Qt.AlignTop)
     hBoxLayout.insertWidget(2, btn_4, 3, Qt.AlignBottom)
     hBoxLayout.insertWidget(2, btn_3, 2, Qt.AlignVCenter)   
         
     self.setCentralWidget(window) 
     self.setWindowTitle("水平布局示例程序")

上述第17-20行代码语句，通过增加传入参数（alignment）来添加设置各部件的对齐方式：

++第17行代码：调用水平布局对象的 addwidget(widget, stretch, alignment) 方法

——(1) 将指定部件（传入参数 widget，这里为按钮一）添加到水平布局对象（hBoxLayout）末尾。此时按钮一在水平布局中的位置所对应的索引值为0，即按钮一放置在水平布局中的第一个位置（从左往右）。

——(2) 同时通过传入参数（stretch）设置按钮一的拉伸因子为0，表示按钮一不会随着窗口的缩放而进行自适应拉伸（即其尺寸保持固定不变）。

——(3) 同时通过传入参数（alignment）设置按钮一的对齐方式为水平方向调整间距两端对齐。

++第18行代码：调用水平布局对象的 addwidget(widget, stretch, alignment) 方法

——(1) 将指定部件（传入参数 widget，这里为按钮二）添加到水平布局对象（hBoxLayout）末尾。此时按钮二在水平布局中的位置所对应的索引值为1，即按钮二放置在水平布局中的第二个位置（从左往右）。

——(2) 同时通过传入参数（stretch）设置按钮二的拉伸因子为1，表示按钮二会随着窗口的缩放而进行自适应拉伸。

——(3) 同时通过传入参数（alignment）设置按钮二的对齐方式为垂直顶部对齐。

++第19行代码：调用水平布局对象的 insertwidget(index, widget, stretch, alignment) 方法

——(1) 将指定部件（传入参数 widget，这里为按钮四）插入到水平布局对象（hBoxLayout）中的指定索引值（传入参数 index）为2的位置。此时按钮四在水平布局中的位置所对应的索引值为2，即按钮四放置在水平布局中的第三个位置（从左往右）。

——(2) 同时通过传入参数（stretch）设置按钮四的拉伸因子为3，表示按钮四会随着窗口的缩放而进行自适应拉伸（是按钮二拉伸后宽度的3倍）。

——(3) 同时通过传入参数（alignment）设置按钮四的对齐方式为垂直底部对齐。

++第20行代码：调用水平布局对象的 insertwidget(index, widget, stretch, alignment) 方法

——(1) 将指定部件（传入参数 widget，这里为按钮三）插入到水平布局对象（hBoxLayout）中的指定索引值（传入参数 index）为2的位置。此时按钮三在水平布局中的位置所对应的索引值为2，即按钮三放置在水平布局中的第三个位置（从左往右）。因索引值为2的位置原来是按钮四放置的位置，此时被按钮三占据后，则按钮四的位置需要向右移动一个位置，于是按钮四在水平布局中的位置所对应的索引值变为3，即按钮四放置在水平布局中的第四个位置（从左往右）。

——(2) 同时通过传入参数（stretch）设置按钮三的拉伸因子为2，表示按钮三会随着窗口的缩放而进行自适应拉伸（是按钮二拉伸后宽度的2倍）。

——(3) 同时通过传入参数（alignment）设置按钮三的对齐方式为垂直居中对齐。

8.4 示例代码3-2及解析

也可以通过调用布局对象的 setAlignment(widget, alignment) 方法来对布局对象中的指定部件（widget）设置其对齐方式（alignment）。

本示例代码3-2与示例代码3-1中部分代码语句略有差异，但两者均实现了相同的目标。

一、编辑保存示例代码4

利用 Visual Studio Code 在第7.4章节示例代码2-2基础上进行编辑，并另存为文件（如：C:\MyPySide6\MyPySide6HBoxLayoutApp03-2.py）。

 from PySide6.QtWidgets import (QApplication, QMainWindow, QWidget,QHBoxLayout, QPushButton)
 from PySide6.QtCore import Qt
 
 class MyMainWindow(QMainWindow):
     def __init__(self):
         super(MyMainWindow, self).__init__()
 
         window = QWidget() 
         hBoxLayout = QHBoxLayout() 
         window.setLayout(hBoxLayout) 
 
         btn_1 = QPushButton('按钮一')
         btn_2 = QPushButton('按钮二')
         btn_3 = QPushButton('按钮三')
         btn_4 = QPushButton('按钮四')
         btn_1.setStyleSheet("background-color: SkyBlue;")
         btn_2.setStyleSheet("background-color: Pink;")
         btn_3.setStyleSheet("background-color: PaleGreen;")
         btn_4.setStyleSheet("background-color: Gold;")
         
         hBoxLayout.addWidget(btn_1)
         hBoxLayout.addWidget(btn_2)
         hBoxLayout.insertWidget(2, btn_4)
         hBoxLayout.insertWidget(2, btn_3)
 
         hBoxLayout.setStretchFactor(btn_1, 0)
         hBoxLayout.setStretchFactor(btn_2, 1)
         hBoxLayout.setStretch(2, 2)
         hBoxLayout.setStretch(3, 3)    
 
         hBoxLayout.setAlignment(btn_1, Qt.AlignJustify)
         hBoxLayout.setAlignment(btn_2, Qt.AlignTop)
         hBoxLayout.setAlignment(btn_3, Qt.AlignVCenter)
         hBoxLayout.setAlignment(btn_4, Qt.AlignBottom)
         
         self.setCentralWidget(window) 
         self.setWindowTitle("水平布局示例程序")
 
 if __name__ == '__main__':
     import sys
 
     app = QApplication(sys.argv)
     gui = MyMainWindow()
     gui.show()
     sys.exit(app.exec_())

二、示例代码3-2解析

示例代码3-2基于第7.4章节示例代码2-2，在本节中对已经解析过的代码就不再解析，只是针对变化之处进行解析。

一、在定义类的构造函数中增加设置部件对齐方式的语句

 def __init__(self):
     super(MyMainWindow, self).__init__()
 
     window = QWidget() 
     hBoxLayout = QHBoxLayout() 
     window.setLayout(hBoxLayout) 
 
     btn_1 = QPushButton('按钮一')
     btn_2 = QPushButton('按钮二')
     btn_3 = QPushButton('按钮三')
     btn_4 = QPushButton('按钮四')
     btn_1.setStyleSheet("background-color: SkyBlue;")
     btn_2.setStyleSheet("background-color: Pink;")
     btn_3.setStyleSheet("background-color: PaleGreen;")
     btn_4.setStyleSheet("background-color: Gold;")
         
     hBoxLayout.addWidget(btn_1)
     hBoxLayout.addWidget(btn_2)
     hBoxLayout.insertWidget(2, btn_4)
     hBoxLayout.insertWidget(2, btn_3)
     
     hBoxLayout.setStretchFactor(btn_1, 0)
     hBoxLayout.setStretchFactor(btn_2, 1)
     hBoxLayout.setStretch(2, 2)
     hBoxLayout.setStretch(3, 3)
         
     hBoxLayout.setAlignment(btn_1, Qt.AlignJustify)
     hBoxLayout.setAlignment(btn_2, Qt.AlignTop)
     hBoxLayout.setAlignment(btn_3, Qt.AlignVCenter)
     hBoxLayout.setAlignment(btn_4, Qt.AlignBottom)
         
     self.setCentralWidget(window) 
     self.setWindowTitle("水平布局示例程序")

上述第27-30行代码依次对4个按钮部件的对齐方式进行了设置：

——第22行代码：调用水平布局对象的 setAlignment(widget, alignment) 方法通过传入参数 alignment 设置水平布局对象（hBoxLayout）中的指定部件（widget，这里指按钮一）的对齐方式为水平方向调整间距两端对齐。

——第23行代码：调用水平布局对象的 setAlignment(widget, alignment) 方法通过传入参数 alignment 设置水平布局对象（hBoxLayout）中的指定部件（widget，这里指按钮二）的对齐方式为垂直顶部对齐。

——第24行代码：调用水平布局对象的 setAlignment(widget, alignment) 方法通过传入参数 alignment 设置水平布局对象（hBoxLayout）中的指定部件（widget，这里指按钮三）的对齐方式为垂直居中对齐。

——第25行代码：调用水平布局对象的 setAlignment(widget, alignment) 方法通过传入参数 alignment 设置水平布局对象（hBoxLayout）中的指定部件（widget，这里指按钮四）的对齐方式为垂直底部对齐。

注1：当程序窗口拉伸时，4个按钮保持其对齐方式不变：按钮一水平方向调整间距两端对齐，按钮二垂直顶部对齐，按钮三垂直居中对齐，按钮四垂直底部对齐。

注2：当程序窗口拉伸时，在水平方向上：按钮一宽度保存不变，按钮二、按钮三、按钮四的宽度按1：2：3的比例分享剩余宽度值（= 拉伸后窗口宽度 - 按钮一宽度）。

8.5 示例程序运行

直接在 Visual Studio Code 上点击主窗体上运行图标按钮来运行该示例程序3-1（或示例程序3-2）。

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

一、上面的是程序运行后提示窗口（原始窗口）

——(1) 此时在水平方向4个按钮均匀排列。

——(2) 此时各按钮对齐方式：按钮一为水平方向调整间距两端对齐；按钮二为垂直顶部对齐；按钮三为垂直居中对齐； 按钮四为垂直底部对齐。

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

——(1) 此时在水平方向，按钮一宽度保持不变，按钮二、按钮三、按钮四的宽度能自适应调整（按照1：2：3的比例分享剩余空间）；在垂直方向4个按钮高度保持不变。

——(2) 对齐方式保持不变：按钮一为水平方向调整间距两端对齐；按钮二为垂直顶部对齐；按钮三为垂直居中对齐； 按钮四为垂直底部对齐。

结束语

本文是《Qt for Python 学习笔记》系列第十篇，较为详细地介绍了 Qt for Python 的水平布局（设置拉伸因子、对齐方式的概念、函数、示例代码及解析），让读者对 Qt for Python 水平布局有个更加深入的了解和掌握。

接下来会继续介绍 Qt for Python 布局管理中的垂直布局，敬请期待！

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