科百科
当前位置: 首页 范文大全

qt 布局顺序(QtforPython布局管理)

时间:2023-08-01 作者: 小编 阅读量: 4 栏目名: 范文大全

前言本系列介绍如何在Python中使用QtforPython进行GUI应用程序开发。——在垂直布局的内容区域中从上往下依次放置部件1和部件2。在Windows平台上,Qt提供的默认布局边距值为9px。该参数可省略,缺省值为0。从QtDesigner主窗口中的中可以得知这2个界面部件对应的均为Spacer类。对象检查器中的Spacer类但是当我们想对Spacer类进一步探索时,却发现在Qt中竟然找不到Spacer类的定义。

前言

本系列介绍如何在 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.overloaddef setContentsMargins(self, left:int, top:int, right:int, bottom:int) -> None: ...@typing.overloaddef 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个对应界面部件(如下图示)。

间隔分组类别(Spacers)

其中:

——Horizontal Spacer 为水平间隔界面部件,Spacer 类,用于类似弹簧的水平间隔。

——Vertical Spacer 垂直间隔界面部件,Spacer 类,用于类似弹簧的垂直间隔。


从 Qt Designer 主窗口中的【对象检查器】中可以得知这2个界面部件对应的均为 Spacer 类。

对象检查器中的 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 sysapp = 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 sysapp = 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 sysapp = 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 #87CEFFlabel_2.setStyleSheet("background-color: Pink;")# 255 192 203 #FFC0CBlabel_3.setStyleSheet("background-color: PaleGreen;")# 152 251 152 #98FB98label_4.setStyleSheet("background-color: Cyan;")# 0 255 255 #00FFFFlabel_5.setStyleSheet("background-color: Gold;")# 255 215 0 #FFD700label_6.setStyleSheet("background-color: Orange;")# 255 165 0 #FFA500vBoxLayout1 = 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 sysapp = 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 布局管理中的网格布局,敬请期待!

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

,
    推荐阅读
  • 美东汽车评级(三年七倍的美东汽车)

    1美东汽车的业务作为一个典型的汽车经销商,美东汽车的业务主要包括两块,新车销售和售后。新车销售的收入常年占总收入比重超过80%。因此在美东汽车整个毛利结构中,售后业务收入虽然不高,但是毛利比重却达到60%,并呈现持续提升的趋势。2018年3月底,政策上宣布将要降低进口车的关税,从25%降至15%,关税变动将于7月1日生效。作为BBA三杰之一的宝马,每年对于国内豪车头把交椅的争抢也是费尽心力。

  • 魔兽世界roll点规则(魔兽世界新主城roll币兑换)

    右边的艾泽里特护甲重铸师可以重置艾泽里特护甲的特质,让你重新选择:选择重铸一件物品,把想要重铸的艾泽里特护甲放进去,交钱就可以重铸了:这个艾泽里特护甲重铸的价格是翻倍的,第一次5金,第二次10金,第三次20金,以此类推,上不封顶(貌似),而且不是按装备收费,是按你的重铸次数,就是你把同一件装备重铸3次,第三次收费20金,此时你重铸下一件装备还是收费40金,而不是从5金开始从头收。

  • 烧烤加盟店10年利润(开特色烧烤加盟店的经验)

    开特色烧烤加盟连锁店有两大难题。5,大忌讳繁华商圈开特色烧烤加盟连锁店尽管选址要看周边的商业布局,但不是要你的特色烧烤加盟连锁店非要开在他们之间的最繁华地段。网上订餐是趋势,也是开特色烧烤加盟连锁店的优势,朋友们要把握好这个历史发展的大商机。

  • 国际学校初中英语教材(英语课程中的本土文化)

    多数非英语国家把英语作为首要外语,并高度重视本国英语教育的发展。中国和韩国地域相近,文化紧密相关。因此,在文化选材和呈现方面,韩国英语教科书能够对我国提供一定的指导和借鉴。文化共现又进一步分为包含韩国本土文化和不包含韩国本土文化两类。为了方便统计,每种文化要素的能力要求按最高层级统计。(一)文化类型特点经统计,三册韩国初中英语教材中共含文化要素92个,各册数量不均,呈下降趋势。

  • steam怎么快速切换账号(Steam多账号自动切换工具)

    下面内容希望能帮助到你,我们来一起看看吧!steam怎么快速切换账号Steam多账号自动切换工具是一款支持快速切换自己STEAM账号的软件,该软件通过Steam多账号自动切换工具能够快速切换自己的Steam账号,通常是用于用不同的账号购买了非常多游戏的玩家或者工作室使用。

  • 牛杂怎么烧(如何做牛杂好吃)

    汤底料:八角、草果、橙皮、桂皮、干辣椒、孜然粒、花椒面各5克、萝卜两斤,精盐、老抽、白糖、白酒、味精适量。先把主要的原料和萝卜洗净,把切好的原料放到烧开的水里,并不断撇去浮沫,见肉呈白红色,过滤去汤水,再加人干净的清水;加入萝卜和用纱布袋装好的锅底汤料,用旺火烧沸约30分钟后,改用小火继续烧1.5小时,煮至牛肉、牛杂酥而不烂,加入精盐、老抽、白糖、白酒、味精即可。

  • lol手游会和端游一样吗(lol是手游还是网游)

    2、官方最多给老玩家回馈一些奖励,甚至可能有一两款皮肤回馈,这些还是可以想想的,但是完全互通是不可能的。

  • 治感冒的风池穴图(经穴之可祛风散寒)

    另外,风邪引起的病还有一个特点就是会引起痒的症状。因此,在我们身体的肌表被风邪侵犯时就会发生发热怕风,出疹,嗓子痒而咳嗽,鼻塞流涕,鼻子痒而打喷嚏的症状。“寒”寒为阴邪,其性清冷,凝滞收引,故易伤人阳气,阻碍气血运行。身体出现怕冷、无汗、鼻塞流涕、肌肉僵硬酸痛正是风寒邪气束缚肌表影响肌表气血运行的结果。出现风寒症状后要把握一个大原则:开表祛邪!人体一旦招风受凉,最先感应到的就是风池穴。

  • 曹操是最强英雄(69秒点铁成金曹操竟是改造文章的祖师爷)

    提到“东临碣石以观沧海”,世人都晓得是出自曹操的名篇《观沧海》,然而你知道么,这句诗竟然是曹孟德改嫁的,原文出自司马相如。在近日播出的《国学小名士》中,嘉宾李山和郦波就对此进行了解读。原来不止《观沧海》,曹操许多的诗篇都是如此,譬如“青青子衿,悠悠我心,但为君故,沉吟至今”,李山就赞誉曹操有“点铁成金”的才能。

  • 大蒜用哪种肥料最好,大蒜养殖怎么施肥好

    基肥以有机肥为主,施用量直接关系到大蒜的商品性和植物的越冬性能。春季气温上升,大蒜心叶和根系开始生长时,每亩施用尿素15-20公斤为宜。大蒜从鳞片芽、花芽分化到抽薹是营养生长和生殖生长的阶段。适当施用硫肥可以提高大蒜和蒜薹的产量和品质;铜、硼、锌等营养元素对大蒜产量也有明显影响。在大蒜生长期,对蒜苗进行追肥。