Qt for Python布局管理(7)—布局边距和间距
bigegpt 2024-10-12 05:26 41 浏览
前言
本系列介绍如何在 Python 中使用 Qt for Python 进行 GUI 应用程序开发。
- 第七篇文章：Qt for Python布局管理(1)—概览
- 第八篇文章：Qt for Python布局管理(2)—绝对定位
- 第九篇文章：Qt for Python布局管理(3)—水平布局
- 第十篇文章：Qt for Python布局管理(4)—垂直布局
- 第十一篇文章：Qt for Python布局管理(5)—部件拉伸
- 第十二篇文章：Qt for Python布局管理(6)—嵌套布局
本文是《Qt for Python 学习笔记》系列第十三篇，对 Qt for Python 布局的内容边距和间距进行介绍，让读者对此部分知识有个基本的认识和掌握。
1. 简介
1.1 术语
1.2 布局内容边距和间距
在使用布局管理器开发 GUI 应用程序时，通常会发现一个现象：部件不能占满整个窗口客户区域（四周会留一些空隙），而且各个部件之间也留有一些空隙。
可能有初学者会对此现象感到不解，为什么四周以及各部件之间会有空隙呢？
问题的答案就是：Qt 布局管理器中存在默认的内容边距和默认的间距，这些内容边距和间距是可以进行设置的，如果均设置为0，则这些空隙就没了（也就看不见了）。
下面我们来看一个布局（含默认边距和间距）示例窗口（如下图示）。
——该窗口中含一个垂直布局区域（上图黑框区域）。
——在垂直布局的内容区域（上图红色虚框区域）中从上往下依次放置部件1和部件2。
——在上图红色虚框（布局内容矩形）与黑框（布局周围的4个边）之间的（4个方向上）空隙，表示该布局的边距，包括左侧边距、顶部边距、右侧边距和底部边距。
——在上图红色虚框（布局内容）内部件1和部件2之间的空隙，表示两个部件之间的间距。
2. 布局边距介绍
布局的内容边距（简称布局边距），指的是布局中的内容区域（里面放置各部件或子布局）与该布局周围四个边的空隙距离。
在Windows平台上，Qt 提供的默认布局边距值为9px。
布局边距的相关属性和方法介绍如下：
2.1 获取布局边距的函数
一、函数声明
def contentsMargins(self) -> PySide6.QtCore.QMargins: ...
def contentsRect(self) -> PySide6.QtCore.QRect: ...
def getContentsMargins(self) -> typing.Tuple: ... 上述函数继承自 QLayout 类。
二、函数1说明
——功能：该函数返回布局的内容边距，类型为 QMargins。
三、函数2说明
——功能：该函数返回布局的内容区域，类型为 QRect。
四、函数3说明
——功能：该函数返回布局的内容边距元组，类型为 Tuple。
2.2 设置布局边距的函数
可以通过调用 setContentsMargins() 方法来设置布局的内容边距。
一、函数声明
@typing.overload
def setContentsMargins(self, left:int, top:int, right:int, bottom:int) -> None: ...
@typing.overload
def setContentsMargins(self, margins:PySide6.QtCore.QMargins) -> None: ...上述函数来自 QLayout 类。
二、函数1说明
——功能：该函数通过4个传入参数设置布局中的内容（各部件）离该布局周围四个边的距离值，4个传入参数依次为左侧、顶部、右侧和底部边距值。
——参数（left）：表示布局中的内容（各部件）离该布局左侧边的距离值，类型为 int。
——参数（top）：表示布局中的内容（各部件）离该布局顶部边的距离值，类型为 int。
——参数（right）：表示布局中的内容（各部件）离该布局右侧边的距离值，类型为 int。
——参数（bottom）：表示布局中的内容（各部件）离该布局底部边的距离值，类型为 int。
二、函数2说明
——功能：该函数通过传入参数（margins）设置布局中的内容（各部件）离该布局周围四个边的距离值。
——参数（margins）：表示布局中的内容（各部件）离该布局，类型为 QMargins。
2.3 通过 Qt Designer 设置布局边距
当利用 Qt Designer 可视化界面设计工具开发 GUI 应用程序时，可以通过 Qt Designer 主窗口中的【属性编辑器】对指定布局对象的（4个）边距属性直接进行设置（如下图示）。
其中：
——layoutLeftMargin 对应左侧边距值；
——layoutTopMargin 对应顶部边距值；
——layoutRightMargin 对应右侧边距值；
——layoutBottomMargin 对应底部边距值。
注：通过上图也可以发现在Windows平台上，Qt 提供的默认布局边距值为9px。
3. 布局间距介绍
布局的间距指的是布局中各部件之间的间隔（空隙距离）。
在Windows平台上，Qt 提供的默认布局间距值为6px。
布局间距的相关属性和方法介绍如下：
3.1 获取布局间距的函数
一、函数声明
def spacing(self) -> int: ...上述函数来自 QLayout 类。
二、函数说明
——功能：该函数返回布局内部各部件之间的间距值，类型为 int。
如果程序中没有设置间距值，则返回 -1。
3.2 设置布局间距的函数
可以通过调用 setSpacing() 方法来设置指定布局中各部件之间的间距值。
一、函数声明
def setSpacing(self, spacing:int) -> None: ...上述函数来自 QLayout 类。
二、函数说明
——功能：该函数通过传入参数（ spacing）设置布局内部各部件之间的间距值。
——参数（ spacing）：表示布局内部各部件之间的间距值，类型为 int。该参数可省略，缺省值为0。
注：间距并不是布局中的一个项目（item），因此布局并不会为其分配索引号。
3.3 通过 Qt Designer 设置布局间距
当利用 Qt Designer 可视化界面设计工具开发 GUI 应用程序时，可以通过 Qt Designer 主窗口中的【属性编辑器】对指定布局对象的 layoutSpacing 属性值（即该布局的间距值）直接进行设置。
注：通过上图也可以发现在Windows平台上，Qt 提供的默认布局间距值为6px。
4. 间隔部件介绍
可以通过向该布局两个部件之间增加（或插入）一个间隔部件的方法来达到设置布局间距的效果。
4.1 标准间隔部件
当利用 Qt Designer 可视化界面设计工具开发 GUI 应用程序时，可以在 Qt Designer 主窗口中的【窗口部件盒】中的【间隔分组类别（Spacers）】看到有2个对应界面部件（如下图示）。
其中：
——Horizontal Spacer 为水平间隔界面部件，Spacer 类，用于类似弹簧的水平间隔。
——Vertical Spacer 垂直间隔界面部件，Spacer 类，用于类似弹簧的垂直间隔。
从 Qt Designer 主窗口中的【对象检查器】中可以得知这2个界面部件对应的均为 Spacer 类。
但是当我们想对 Spacer 类进一步探索时，却发现在 Qt 中竟然找不到 Spacer 类的定义。实际上 Qt Designer 中 Spacer 类就是 QtWidgets 模块下的 QSpacerItem 类。
4.2 QSpacerItem 类
一、QSpacerItem 类的作用
使用 QSpacerItem 类可以在布局中创建一个间隔部件（相当于一个自定义的布局间距）。该间隔部件是布局中的一个项目（item），会在布局中占据一个位置，布局会为其分配一个索引号，也就是说由 QSpacerItem 类创建的对象是可以由布局管理器进行管理的。
注：通常情况下我们并不需要使用该类，因为在各布局管理器中有相应的函数代替了该类的功能。
二、QSpacerItem 类的基本信息
class QSpacerItem(PySide6.QtWidgets.QLayoutItem):
def __init__(self, w:int, h:int, hData:PySide6.QtWidgets.QSizePolicy.Policy=..., vData:PySide6.QtWidgets.QSizePolicy.Policy=...) -> None: ...
def changeSize(self, w:int, h:int, hData:PySide6.QtWidgets.QSizePolicy.Policy=..., vData:PySide6.QtWidgets.QSizePolicy.Policy=...) -> None: ...
def expandingDirections(self) -> PySide6.QtCore.Qt.Orientations: ...
def geometry(self) -> PySide6.QtCore.QRect: ...
def isEmpty(self) -> bool: ...
def maximumSize(self) -> PySide6.QtCore.QSize: ...
def minimumSize(self) -> PySide6.QtCore.QSize: ...
def setGeometry(self, arg__1:PySide6.QtCore.QRect) -> None: ...
def sizeHint(self) -> PySide6.QtCore.QSize: ...
def sizePolicy(self) -> PySide6.QtWidgets.QSizePolicy: ...
def spacerItem(self) -> PySide6.QtWidgets.QSpacerItem: ...QSpacerItem 类构造函数表示构造或修改一个具有宽度为w，高度为h，水平方向的尺寸策略为hData，垂直方向尺寸策略为 vData 的间隔（即 QSpacerItem 实例）。
4.3 添加/插入固定尺寸的间隔部件的函数
一、函数声明
def addSpacing(self, size:int) -> None: ...
def insertSpacing(self, index:int, size:int) -> None: ...上述函数来自 QBoxLayout 类。
二、函数1说明
——功能：该函数在布局末尾添加一个指定尺寸（传入参数 size）的间隔部件。
——参数（size）：表示指定尺寸，类型为 int。
三、函数2说明
——功能：该函数在布局指定位置（传入参数 index）插入一个指定尺寸（传入参数 size）的间隔部件。
——参数（index）：表示指定位置，类型为 int。索引从0开始，0表示第一个位置（水平布局从左往右，垂直布局从上往下）；若索引为负值表示插入到布局末尾。
——参数（size）：表示指定尺寸，类型为 int。
注：向布局中插入间隔部件后，该间隔部件就称为了布局中的一个项目（item），因此布局会为该间隔部件分配一个索引号，进而会改变布局内各部件之间的原有索引号。请注意与布局间距属性的区别。
4.4 添加/插入可伸缩的间隔部件的函数
一、函数声明
def addSpacerItem(self, spacerItem:PySide6.QtWidgets.QSpacerItem) -> None: ...
def insertSpacerItem(self, index:int, spacerItem:PySide6.QtWidgets.QSpacerItem) -> None: ...上述函数来自 QBoxLayout 类。
二、函数1说明
——功能：该函数在布局末尾添加一个可伸缩（传入参数 spacerItem）的间隔部件。
——参数（spacerItem）：表示最小尺寸为0，伸缩因子为0的，可伸缩间隔部件，类型为 QSpacerItem。
三、函数2说明
——功能：该函数在布局指定位置（传入参数 index）插入一个可伸缩（传入参数 spacerItem）的间隔部件。
——参数（index）：表示指定位置，类型为 int。索引从0开始，0表示第一个位置（水平布局从左往右，垂直布局从上往下）；若索引为负值表示插入到布局末尾。
——参数（spacerItem）：表示最小尺寸为0，伸缩因子为0的，可伸缩空白部件，类型为 QSpacerItem。
注：向布局中插入间隔部件后，该间隔部件就称为了布局中的一个项目（item），因此布局会为该间隔部件分配一个索引号，进而会改变布局内各部件之间的原有索引号。请注意与布局间距属性的区别。
4.5 添加/插入可指定伸缩因子的可伸缩间隔部件的函数
一、函数声明
def addStretch(self, stretch:int=...) -> None: ...
def insertStretch(self, index:int, stretch:int=...) -> None: ...上述函数来自 QBoxLayout 类。
二、函数1说明
——功能：该函数在布局末尾添加一个指定伸缩因子（传入参数 stretch）的可伸缩间隔部件（最小尺寸为0）。
——参数（stretch）：表示指定的伸缩因子，类型为 int，取值范围[0,255]。
三、函数2说明
——功能：该函数在布局指定位置（传入参数 index）插入一个指定伸缩因子（传入参数 stretch）的可伸缩间隔部件（最小尺寸为0）。
——参数（index）：表示指定位置，类型为 int。索引从0开始，0表示第一个位置（水平布局从左往右，垂直布局从上往下）；若索引为负值表示插入到布局末尾。
——参数（stretch）：表示指定的伸缩因子，类型为 int，取值范围[0,255]。
注：向布局中插入间隔部件后，该间隔部件就称为了布局中的一个项目（item），因此布局会为该间隔部件分配一个索引号，进而会改变布局内各部件之间的原有索引号。请注意与布局间距属性的区别。
5. 布局边距示例
5.1 示例原型
在进行 GUI 应用程序编码之前，一般建议先勾画出 GUI 框架（窗体及各部件的布局等）。本示例原型如下：
5.2 示例目标
本示例目标是创建一个 Python GUI 应用程序，在主窗口中如原型图示放置6个标签。
主窗口及部件的位置、尺寸及其他属性如下：
- 主窗口
——(1) 窗口位置及尺寸采用尺寸提示（默认大小）
——(2) 标题：布局内容边距示例程序
——(3) 具有窗口最小化、最大化、关闭快捷按钮
- 6个标签
——(1) 位置：如原型图示放置排列
——(2) 尺寸：采用尺寸提示（默认大小）
——(3) 尺寸：6个标签文本依次为：“标签一”、"标签二"、"标签三"、"标签四"、"标签五"、"标签六"
——(4) 背景色：6个标签依次为“SkyBlue”、“Pink”、“PaleGreen”、“Cyan”、“Gold”、“Orange”
- 各布局内容边距
——最外层红框表示水平布局，该布局4个方向上的内容边距均为0。
——里面最左侧是一个垂直布局（放置标签1），该布局4个方向上的内容边距依次为(0, 0, 0, 20)。
——里面中间的蓝框是一个垂直布局（其中从上往下依次放置标签2和标签3），该布局4个方向上的内容边距依次为(10, 10, 20, 10)。
——里面右侧的绿框是一个垂直布局（其中从上往下依次放置标签4、标签5和标签6），该布局4个方向上的内容边距依次为(0, 20, 0, 0)。
- 窗口缩放时各部件按默认的尺寸策略自动进行自适应调整
——在拉伸（或压缩）窗口时，各标签安装默认的尺寸策略进行自适应同步缩放。
——在拉伸（或压缩）窗口时，标签四周的内容边距以及各个标签之间的间距始终保持不变。
5.3 示例代码
利用 Visual Studio Code 编辑代码，并保存为文件（如：C:\MyPySide6\MyPySide6LayoutContentMarginApp.py）。
from PySide6.QtWidgets import (QApplication, QMainWindow, QWidget, QHBoxLayout, QVBoxLayout, QLabel)
class MyMainWindow(QMainWindow):
def __init__(self):
super(MyMainWindow, self).__init__()
window = QWidget()
label_1 = QLabel("标签一")
label_2 = QLabel("标签二")
label_3 = QLabel("标签三")
label_4 = QLabel("标签四")
label_5 = QLabel("标签五")
label_6 = QLabel("标签六")
label_1.setStyleSheet("background-color: SkyBlue;")
label_2.setStyleSheet("background-color: Pink;")
label_3.setStyleSheet("background-color: PaleGreen;")
label_4.setStyleSheet("background-color: Cyan;")
label_5.setStyleSheet("background-color: Gold;")
label_6.setStyleSheet("background-color: Orange;")
vBoxLayout1 = QVBoxLayout()
vBoxLayout1.addWidget(label_1)
vBoxLayout2 = QVBoxLayout()
vBoxLayout2.addWidget(label_2)
vBoxLayout2.addWidget(label_3)
vBoxLayout3 = QVBoxLayout()
vBoxLayout3.addWidget(label_4)
vBoxLayout3.addWidget(label_5)
vBoxLayout3.addWidget(label_6)
hBoxLayout = QHBoxLayout()
hBoxLayout.addLayout(vBoxLayout1)
hBoxLayout.addLayout(vBoxLayout2)
hBoxLayout.addLayout(vBoxLayout3)
vBoxLayout1.setContentsMargins(0, 5, 0, 20)
vBoxLayout2.setContentsMargins(0, 0, 0, 0)
vBoxLayout3.setContentsMargins(15, 20, 0, 5)
hBoxLayout.setContentsMargins(0, 0, 0, 0)
window.setLayout(hBoxLayout)
self.setCentralWidget(window)
self.setWindowTitle("布局内容边距示例程序")
if __name__ == '__main__':
import sys
app = QApplication(sys.argv)
gui = MyMainWindow()
gui.show()
sys.exit(app.exec_())5.4 代码解析
本示例代码共分三部分：
一、导入模块（或类）部分
from PySide6.QtWidgets import (QApplication, QMainWindow, QWidget, QHBoxLayout, QVBoxLayout, QLabel)——第1行代码：表示从 PySide6.QtWidgets 模块导入后续代码中会用到的 QApplication 类、QMainWindow 类、QWidget 类、QHBoxLayout 类、QVBoxLayout 类、QLabel 类。
二、自定义MyMainWindow类部分
其次，自定义 MyMainWindow 类（即主窗口，继承自 QMainWindow 类）：
class MyMainWindow(QMainWindow):
def __init__(self):
super(MyMainWindow, self).__init__()
window = QWidget()
label_1 = QLabel("标签一")
label_2 = QLabel("标签二")
label_3 = QLabel("标签三")
label_4 = QLabel("标签四")
label_5 = QLabel("标签五")
label_6 = QLabel("标签六")
label_1.setStyleSheet("background-color: SkyBlue;")
label_2.setStyleSheet("background-color: Pink;")
label_3.setStyleSheet("background-color: PaleGreen;")
label_4.setStyleSheet("background-color: Cyan;")
label_5.setStyleSheet("background-color: Gold;")
label_6.setStyleSheet("background-color: Orange;")
vBoxLayout1 = QVBoxLayout()
vBoxLayout1.addWidget(label_1)
vBoxLayout2 = QVBoxLayout()
vBoxLayout2.addWidget(label_2)
vBoxLayout2.addWidget(label_3)
vBoxLayout3 = QVBoxLayout()
vBoxLayout3.addWidget(label_4)
vBoxLayout3.addWidget(label_5)
vBoxLayout3.addWidget(label_6)
hBoxLayout = QHBoxLayout()
hBoxLayout.addLayout(vBoxLayout1)
hBoxLayout.addLayout(vBoxLayout2)
hBoxLayout.addLayout(vBoxLayout3)
vBoxLayout1.setContentsMargins(0, 5, 0, 20)
vBoxLayout2.setContentsMargins(0, 0, 0, 0)
vBoxLayout3.setContentsMargins(15, 20, 0, 5)
hBoxLayout.setContentsMargins(0, 0, 0, 0)
window.setLayout(hBoxLayout)
self.setCentralWidget(window)
self.setWindowTitle("布局内容边距示例程序")——第1行代码：自定义 MyMainWindow 类的声明语句。类名为 MyMainWindow，该类继承自 QMainWindow 类。
——第2行代码：声明一个类构造函数（ __init__(self)），有1个传递参数（self，表示类实例对象本身）：
——第3行代码：通过 super() 方法继承了父类（QMainWindow）构造函数中的全部属性。
——第5行代码：通过实例化 QWidget 类创建一个窗口对象（window）。
——第7-12行代码：通过实例化 QLabel 类依次创建6个标签对象（这4个标签会添加到布局中，故无需设置其父部件）
——第13-18行代码：通过调用标签对象的 setStyleSheet() 方法依次设置6个标签的背景色。
——第20行代码：通过实例化 QVBoxLayout 类创建一个垂直布局对象（vBoxLayout1）。
——第21行代码：调用 addwidget() 方法依次将标签1添加到垂直布局对象（vBoxLayout1）末尾。
——第23行代码：通过实例化 QVBoxLayout 类创建一个垂直布局对象（vBoxLayout2）。
——第24-25行代码：调用 addwidget() 方法依次将标签2和标签3添加到垂直布局对象（vBoxLayout2）末尾。
——第27行代码：通过实例化 QVBoxLayout 类创建一个垂直布局对象（vBoxLayout3）。
——第28-30行代码：调用 addwidget() 方法依次将标签4、标签5和标签6添加到垂直布局对象（vBoxLayout3）末尾。
——第32行代码：通过实例化 QHBoxLayout 类创建一个水平布局对象（hBoxLayout）。
——第33-35行代码：调用 addLayout() 方法依次将垂直布局对象（vBoxLayout1、vBoxLayout2、vBoxLayout3）添加到水平布局对象（hBoxLayout）末尾。
——第37行代码：通过调用 setContentsMargins() 方法设置垂直布局对象（vBoxLayout1）的4个方向上的内容边距（左侧边距=0，顶部边距=0，右侧边距=0，底部边距=20）。
——第38行代码：通过调用 setContentsMargins() 方法设置垂直布局对象（vBoxLayout2）的4个方向上的内容边距（左侧边距=10，顶部边距=10，右侧边距=20，底部边距=10）。
——第39行代码：通过调用 setContentsMargins() 方法设置垂直布局对象（vBoxLayout3）的4个方向上的内容边距（左侧边距=0，顶部边距=20，右侧边距=0，底部边距=0）。
——第40行代码：通过调用 setContentsMargins() 方法设置水平布局对象（hBoxLayout）的4个方向上的内容边距（左侧边距=0，顶部边距=0，右侧边距=0，底部边距=0）。
——第42行代码：通过调用窗口对象（window）的 setLayout() 方法将水平布局对象（hBoxLayout）设置为窗口对象的布局管理器。
——第44行代码：调用窗口的 setCentralWidget() 方法设置主窗口的中央部件为窗口对象（window）。
——第45行代码：调用窗口的 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行代码：运行应用程序，直至退出。
5.5 示例程序运行
直接在 Visual Studio Code 上点击主窗体上运行图标按钮来运行该示例程序。
上图是程序运行后的窗口，可以看到已经实现布局内容边距示例目标：
——最外层红框表示水平布局，该布局4个方向上的内容边距均为0，所以看不见水平布局内容边距。
——里面最左侧是一个垂直布局（放置标签1），该布局4个方向上的内容边距依次为(0, 0, 0, 20)，所以只能看见该垂直布局的底部边距。
——里面中间的蓝框是一个垂直布局（其中从上往下依次放置标签2和标签3），该布局4个方向上的内容边距依次为(10, 10, 20, 10)，所以能看见该垂直布局的4个方向上的内容边距。
——里面右侧的绿框是一个垂直布局（其中从上往下依次放置标签4、标签5和标签6），该布局4个方向上的内容边距依次为(0, 20, 0, 0)，所以只能看见该垂直布局的顶部边距。
——在拉伸（或压缩）窗口时，各标签安装默认的尺寸策略进行自适应同步缩放。
——在拉伸（或压缩）窗口时，标签四周的内容边距以及各个标签之间的间距始终保持不变。
注：上图运行窗口中并没有红框、蓝框，均为进行说明后加的。
6. 布局间距示例
6.1 示例原型
在进行 GUI 应用程序编码之前，一般建议先勾画出 GUI 框架（窗体及各部件的布局等）。本示例原型如下：
6.2 示例目标
本示例目标是创建一个 Python GUI 应用程序，在主窗口中如原型图示放置6个标签。
主窗口及部件的位置、尺寸及其他属性如下：
- 主窗口
——(1) 窗口位置及尺寸采用尺寸提示（默认大小）
——(2) 标题：布局内容边距示例程序
——(3) 具有窗口最小化、最大化、关闭快捷按钮
- 6个标签
——(1) 位置：如原型图示放置排列
——(2) 尺寸：采用尺寸提示（默认大小）
——(3) 尺寸：6个标签文本依次为：“标签一”、"标签二"、"标签三"、"标签四"、"标签五"、"标签六"
——(4) 背景色：6个标签依次为“SkyBlue”、“Pink”、“PaleGreen”、“Cyan”、“Gold”、“Orange”
- 各布局内容边距
——最外层红框表示水平布局，该布局4个方向上的内容边距均为0。其他布局的内容边距为默认值。
- 各布局间距
——最外层红框表示水平布局，该布局间距为5。
——里面最左侧是一个垂直布局（放置标签1），该布局间距为0。
——里面中间的蓝框是一个垂直布局（其中从上往下依次放置标签2和标签3），该布局间距为10。
——里面右侧的绿框是一个垂直布局（其中从上往下依次放置标签4、标签5和标签6），该布局间距为15。
- 窗口缩放时各部件按默认的尺寸策略自动进行自适应调整
——在拉伸（或压缩）窗口时，各标签安装默认的尺寸策略进行自适应同步缩放。
——在拉伸（或压缩）窗口时，标签四周的内容边距以及各个标签之间的间距始终保持不变。
6.3 示例代码
利用 Visual Studio Code 编辑代码，并保存为文件（如：C:\MyPySide6\MyPySide6LayoutSpacingApp.py）。
from PySide6.QtWidgets import (QApplication, QMainWindow, QWidget, QHBoxLayout, QVBoxLayout, QLabel)
class MyMainWindow(QMainWindow):
def __init__(self):
super(MyMainWindow, self).__init__()
window = QWidget()
label_1 = QLabel("标签一")
label_2 = QLabel("标签二")
label_3 = QLabel("标签三")
label_4 = QLabel("标签四")
label_5 = QLabel("标签五")
label_6 = QLabel("标签六")
label_1.setStyleSheet("background-color: SkyBlue;")
label_2.setStyleSheet("background-color: Pink;")
label_3.setStyleSheet("background-color: PaleGreen;")
label_4.setStyleSheet("background-color: Cyan;")
label_5.setStyleSheet("background-color: Gold;")
label_6.setStyleSheet("background-color: Orange;")
vBoxLayout1 = QVBoxLayout()
vBoxLayout1.addWidget(label_1)
vBoxLayout2 = QVBoxLayout()
vBoxLayout2.addWidget(label_2)
vBoxLayout2.addWidget(label_3)
vBoxLayout3 = QVBoxLayout()
vBoxLayout3.addWidget(label_4)
vBoxLayout3.addWidget(label_5)
vBoxLayout3.addWidget(label_6)
hBoxLayout = QHBoxLayout()
hBoxLayout.addLayout(vBoxLayout1)
hBoxLayout.addLayout(vBoxLayout2)
hBoxLayout.addLayout(vBoxLayout3)
hBoxLayout.setContentsMargins(0, 0, 0, 0)
vBoxLayout1.setSpacing(0)
vBoxLayout2.setSpacing(10)
vBoxLayout3.setSpacing(15)
hBoxLayout.setSpacing(5)
window.setLayout(hBoxLayout)
self.setCentralWidget(window)
self.setWindowTitle("布局间距示例程序")
if __name__ == '__main__':
import sys
app = QApplication(sys.argv)
gui = MyMainWindow()
gui.show()
sys.exit(app.exec_())6.4 代码解析
本示例代码共分三部分：
一、导入模块（或类）部分
此部分代码解析请参见本文第5.4章节中对应部分的代码解析内容（完全一样）。
二、自定义MyMainWindow类部分
其次，自定义 MyMainWindow 类（即主窗口，继承自 QMainWindow 类）：
class MyMainWindow(QMainWindow):
def __init__(self):
super(MyMainWindow, self).__init__()
window = QWidget()
label_1 = QLabel("标签一")
label_2 = QLabel("标签二")
label_3 = QLabel("标签三")
label_4 = QLabel("标签四")
label_5 = QLabel("标签五")
label_6 = QLabel("标签六")
label_1.setStyleSheet("background-color: SkyBlue;")
label_2.setStyleSheet("background-color: Pink;")
label_3.setStyleSheet("background-color: PaleGreen;")
label_4.setStyleSheet("background-color: Cyan;")
label_5.setStyleSheet("background-color: Gold;")
label_6.setStyleSheet("background-color: Orange;")
vBoxLayout1 = QVBoxLayout()
vBoxLayout1.addWidget(label_1)
vBoxLayout2 = QVBoxLayout()
vBoxLayout2.addWidget(label_2)
vBoxLayout2.addWidget(label_3)
vBoxLayout3 = QVBoxLayout()
vBoxLayout3.addWidget(label_4)
vBoxLayout3.addWidget(label_5)
vBoxLayout3.addWidget(label_6)
hBoxLayout = QHBoxLayout()
hBoxLayout.addLayout(vBoxLayout1)
hBoxLayout.addLayout(vBoxLayout2)
hBoxLayout.addLayout(vBoxLayout3)
hBoxLayout.setContentsMargins(0, 0, 0, 0)
vBoxLayout1.setSpacing(0)
vBoxLayout2.setSpacing(10)
vBoxLayout3.setSpacing(15)
hBoxLayout.setSpacing(5)
window.setLayout(hBoxLayout)
self.setCentralWidget(window)
self.setWindowTitle("布局间距示例程序")——第1-35行代码：请参见本文第5.4章节的代码解析内容（完全一样）。
——第37行代码：通过调用 setContentsMargins() 方法设置水平布局对象（hBoxLayout）的4个方向上的内容边距（左侧边距=0，顶部边距=0，右侧边距=0，底部边距=0）。
——第38行代码：通过调用 setSpacing() 方法设置垂直布局对象（vBoxLayout1）的间距为0。
——第39行代码：通过调用 setSpacing() 方法设置垂直布局对象（vBoxLayout2）的间距为10。
——第40行代码：通过调用 setSpacing() 方法设置垂直布局对象（vBoxLayout3）的间距为15。
——第41行代码：通过调用 setSpacing() 方法设置水平布局对象（hBoxLayout）的间距为5。
——第43行代码：通过调用窗口对象（window）的 setLayout() 方法将水平布局对象（hBoxLayout）设置为窗口对象的布局管理器。
——第45行代码：调用窗口的 setCentralWidget() 方法设置主窗口的中央部件为窗口对象（window）。
——第46行代码：调用窗口的 setWindowTitle() 方法设置主窗口的标题为"布局间距示例程序"。
三、设置文件运行入口部分
此部分代码解析请参加本文第5.4章节中对应部分的代码解析内容（完全一样）。
6.5 示例程序运行
直接在 Visual Studio Code 上点击主窗体上运行图标按钮来运行该示例程序。
上图是程序运行后的窗口，可以看到已经实现布局间距示例目标：
——最外层红框表示水平布局，其间距为5（即里面的3个垂直布局之间的间距为5，有2处）。
——里面最左侧是一个垂直布局（放置标签1），其间距为0。
——里面中间的蓝框是一个垂直布局（其中从上往下依次放置标签2和标签3），其间距为10（即里面的标签2和标签3之间的间距为10，有1处）。
——里面右侧的绿框是一个垂直布局（其中从上往下依次放置标签4、标签5和标签6），其间距为15（即里面的标签4、标签5和标签6之间的间距为15，有2处）。
——在拉伸（或压缩）窗口时，各标签安装默认的尺寸策略进行自适应同步缩放。
——在拉伸（或压缩）窗口时，标签四周的内容边距以及各个标签之间的间距始终保持不变。
注：上图运行窗口中并没有红框、蓝框，均为进行说明后加的。
7. 布局间隔部件示例
7.1 示例原型
在进行 GUI 应用程序编码之前，一般建议先勾画出 GUI 框架（窗体及各部件的布局等）。本示例原型如下：
7.2 示例目标
本示例目标是创建一个 Python GUI 应用程序，在主窗口中如原型图示放置6个标签。
本示例目标基于第6.2章节示例目标，不同之处在于用间隔部件实现相同效果。
7.3 示例代码
本示例代码基于第6.3章节示例代码修改。
利用 Visual Studio Code 编辑代码，并另存为文件（如：C:\MyPySide6\MyPySide6LayoutQSpacerItemApp.py）。
from PySide6.QtWidgets import (QApplication, QMainWindow, QWidget, QHBoxLayout, QVBoxLayout, QLabel, QSpacerItem)
class MyMainWindow(QMainWindow):
def __init__(self):
super(MyMainWindow, self).__init__()
window = QWidget()
label_1 = QLabel("标签一")
label_2 = QLabel("标签二")
label_3 = QLabel("标签三")
label_4 = QLabel("标签四")
label_5 = QLabel("标签五")
label_6 = QLabel("标签六")
label_1.setStyleSheet("background-color: SkyBlue;") # 135 206 255 #87CEFF
label_2.setStyleSheet("background-color: Pink;") # 255 192 203 #FFC0CB
label_3.setStyleSheet("background-color: PaleGreen;") # 152 251 152 #98FB98
label_4.setStyleSheet("background-color: Cyan;") # 0 255 255 #00FFFF
label_5.setStyleSheet("background-color: Gold;") # 255 215 0 #FFD700
label_6.setStyleSheet("background-color: Orange;") # 255 165 0 #FFA500
vBoxLayout1 = QVBoxLayout()
vBoxLayout1.addWidget(label_1)
vBoxLayout2 = QVBoxLayout()
vBoxLayout2.addWidget(label_2)
vBoxLayout2.addWidget(label_3)
vBoxLayout3 = QVBoxLayout()
vBoxLayout3.addWidget(label_4)
vBoxLayout3.addWidget(label_5)
vBoxLayout3.addWidget(label_6)
hBoxLayout = QHBoxLayout()
hBoxLayout.addLayout(vBoxLayout1)
hBoxLayout.addLayout(vBoxLayout2)
hBoxLayout.addLayout(vBoxLayout3)
hBoxLayout.setContentsMargins(0, 0, 0, 0)
hBoxLayout.setSpacing(0)
vBoxLayout2.insertSpacing(1, 10)
vBoxLayout3.insertSpacing(1, 15)
vBoxLayout3.insertSpacing(3, 15)
hBoxLayout.insertSpacing(1, 5)
spacerItem = QSpacerItem(5, 5)
hBoxLayout.insertSpacerItem(3, spacerItem)
window.setLayout(hBoxLayout)
self.setCentralWidget(window)
self.setWindowTitle("布局间隔部件示例程序")
if __name__ == '__main__':
import sys
app = QApplication(sys.argv)
gui = MyMainWindow()
gui.show()
sys.exit(app.exec_())7.4 代码解析
本示例代码基于第6.3章节示例代码修改，所以就只对有变化的代码语句进行解析了。
本示例代码共分三部分：
一、导入模块（或类）部分
from PySide6.QtWidgets import (QApplication, QMainWindow, QWidget, QHBoxLayout, QVBoxLayout, QLabel, QSpacerItem)——第1行代码：表示从 PySide6.QtWidgets 模块导入后续代码中会用到的 QApplication 类、QMainWindow 类、QWidget 类、QHBoxLayout 类、QLabel 类、QSpacerItem 类。
二、自定义MyMainWindow类部分
其次，自定义 MyMainWindow 类（即主窗口，继承自 QMainWindow 类）：
class MyMainWindow(QMainWindow):
def __init__(self):
......
hBoxLayout.setContentsMargins(0, 0, 0, 0)
hBoxLayout.setSpacing(0)
vBoxLayout2.insertSpacing(1, 10)
vBoxLayout3.insertSpacing(1, 15)
vBoxLayout3.insertSpacing(3, 15)
hBoxLayout.insertSpacing(1, 5)
spacerItem = QSpacerItem(5, 5)
hBoxLayout.insertSpacerItem(3, spacerItem)
window.setLayout(hBoxLayout)
self.setCentralWidget(window)
self.setWindowTitle("布局间隔部件示例程序")在原示例代码上第39行（hBoxLayout.setContentsMargins(0, 0, 0, 0)）与第45行代码（window.setLayout(hBoxLayout)）之间新增相关代码语句：
——第40行代码：通过调用 setSpacing(spacing) 方法设置水平布局内各子布局或部件之间的间距值（为0）。
——第42行代码：通过调用 insertSpacing() 方法在垂直布局对象2的指定位置（索引值为1，即标签2和标签3之间）插入一个固定尺寸（10px）的间隔部件。
——第43行代码：通过调用 insertSpacing() 方法在垂直布局对象3的指定位置（索引值为1，即标签4和标签5之间）插入一个固定尺寸（15px）的间隔部件。
——第44行代码：通过调用 insertSpacing() 方法在垂直布局对象3的指定位置（索引值为3，即标签5和标签6之间）插入一个固定尺寸（15px）的间隔部件。
——第45行代码：通过调用 insertSpacing() 方法在水平布局对象的指定位置（索引值为1，即垂直布局对象1和垂直布局对象2之间）插入一个固定尺寸（5px）的间隔部件。
——第46行代码：通过实例化 QSpacerItem 类创建一个间隔部件对象（spacerItem），构造时设置其宽度和高度均为5px。
——第47行代码：通过调用 insertSpacerItem() 方法在水平布局对象的指定位置（索引值为3，即垂直布局对象2和垂直布局对象3之间）插入一个指定的间隔部件对象（spacerItem）。
——第52行代码：调用窗口的 setWindowTitle() 方法设置主窗口的标题为"布局间隔部件示例程序"。
三、设置文件运行入口部分
此部分代码解析请参加本文第5.4章节中对应部分的代码解析内容（完全一样）。
7.5 示例程序运行
直接在 Visual Studio Code 上点击主窗体上运行图标按钮来运行该示例程序。
上图是程序运行后的窗口，对比第6.5章节的示例程序运行窗口，发现实现了相同效果。
结束语
本文是《Qt for Python 学习笔记》系列第十三篇，较为详细地介绍了 Qt for Python 布局管理中的布局内容边距和布局间距相关内容，让读者对此有个较为全面的了解和掌握。
接下来会介绍 Qt for Python 布局管理中的网格布局，敬请期待！
希望本文能对您有所帮助！若文中存在疏忽不足或错误，还请不吝赐教！
相关推荐
- 得物可观测平台架构升级:基于GreptimeDB的全新监控体系实践
-
一、摘要在前端可观测分析场景中，需要实时观测并处理多地、多环境的运行情况，以保障Web应用和移动端的可用性与性能。传统方案往往依赖代理Agent→消息队列→流计算引擎→OLAP存储...
- warm-flow新春版:网关直连和流程图重构
-
本期主要解决了网关直连和流程图重构，可以自此之后可支持各种复杂的网关混合、多网关直连使用。-新增Ruoyi-Vue-Plus优秀开源集成案例更新日志[feat]导入、导出和保存等新增json格式支持...
- 扣子空间体验报告
-
在数字化时代，智能工具的应用正不断拓展到我们工作和生活的各个角落。从任务规划到项目执行，再到任务管理，作者深入探讨了这款工具在不同场景下的表现和潜力。通过具体的应用实例，文章展示了扣子空间如何帮助用户...
- spider-flow:开源的可视化方式定义爬虫方案
-
spider-flow简介spider-flow是一个爬虫平台，以可视化推拽方式定义爬取流程，无需代码即可实现一个爬虫服务。spider-flow特性支持css选择器、正则提取支持JSON/XML格式...
- solon-flow 你好世界!
-
solon-flow是一个基础级的流处理引擎（可用于业务规则、决策处理、计算编排、流程审批等......）。提供有“开放式”驱动定制支持，像jdbc有mysql或pgsql等驱动，可...
- 新一代开源爬虫平台:SpiderFlow
-
SpiderFlow：新一代爬虫平台，以图形化方式定义爬虫流程，不写代码即可完成爬虫。-精选真开源，释放新价值。概览Spider-Flow是一个开源的、面向所有用户的Web端爬虫构建平台，它使用Ja...
- 通过 SQL 训练机器学习模型的引擎
-
关注薪资待遇的同学应该知道，机器学习相关的岗位工资普遍偏高啊。同时随着各种通用机器学习框架的出现，机器学习的门槛也在逐渐降低，训练一个简单的机器学习模型变得不那么难。但是不得不承认对于一些数据相关的工...
- 鼠须管输入法rime for Mac
-
鼠须管输入法forMac是一款十分新颖的跨平台输入法软件，全名是中州韵输入法引擎，鼠须管输入法mac版不仅仅是一个输入法，而是一个输入法算法框架。Rime的基础架构十分精良，一套算法支持了拼音、...
- Go语言 1.20 版本正式发布:新版详细介绍
-
Go1.20简介最新的Go版本1.20在Go1.19发布六个月后发布。它的大部分更改都在工具链、运行时和库的实现中。一如既往，该版本保持了Go1的兼容性承诺。我们期望几乎所...
- iOS 10平台SpriteKit新特性之Tile Maps(上)
-
简介苹果公司在WWDC2016大会上向人们展示了一大批新的好东西。其中之一就是SpriteKitTileEditor。这款工具易于上手，而且看起来速度特别快。在本教程中，你将了解关于TileE...
- 程序员简历例句—范例Java、Python、C++模板
-
个人简介通用简介：有良好的代码风格，通过添加注释提高代码可读性，注重代码质量，研读过XXX，XXX等多个开源项目源码从而学习增强代码的健壮性与扩展性。具备良好的代码编程习惯及文档编写能力，参与多个高...
- Telerik UI for iOS Q3 2015正式发布
-
近日，TelerikUIforiOS正式发布了Q32015。新版本新增对XCode7、Swift2.0和iOS9的支持，同时还新增了对数轴、不连续的日期时间轴等；改进TKDataPoin...
- ios使用ijkplayer+nginx进行视频直播
-
上两节，我们讲到使用nginx和ngixn的rtmp模块搭建直播的服务器，接着我们讲解了在Android使用ijkplayer来作为我们的视频直播播放器，整个过程中，需要注意的就是ijlplayer编...
- IOS技术分享|iOS快速生成开发文档(一)
-
前言对于开发人员而言，文档的作用不言而喻。文档不仅可以提高软件开发效率，还能便于以后的软件开发、使用和维护。本文主要讲述Objective-C快速生成开发文档工具appledoc。简介apple...
- macOS下配置VS Code C++开发环境
-
本文介绍在苹果macOS操作系统下，配置VisualStudioCode的C/C++开发环境的过程，本环境使用Clang/LLVM编译器和调试器。一、前置条件本文默认前置条件是，您的开发设备已...
- 一周热门
- 最近发表
- 标签列表
-
- mybatiscollection (79)
- mqtt服务器 (88)
- keyerror (78)
- c#map (65)
- resize函数 (64)
- xftp6 (83)
- bt搜索 (75)
- c#var (76)
- mybatis大于等于 (64)
- xcode-select (66)
- httperror403.14-forbidden (63)
- logstashinput (65)
- hadoop端口 (65)
- dockernetworkconnect (63)
- esxi7 (63)
- vue阻止冒泡 (67)
- c#for循环 (63)
- oracle时间戳转换日期 (64)
- jquery跨域 (68)
- php写入文件 (73)
- java大写转小写 (63)
- kafkatools (66)
- mysql导出数据库 (66)
- jquery鼠标移入移出 (71)
- 取小数点后两位的函数 (73)