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

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

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

前言本系列介绍如何在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 布局管理中的网格布局,敬请期待!

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

,
    推荐阅读
  • 男生个性签名(你喜欢吗)

    接下来我们就一起去了解一下吧!男生个性签名只要给我辉煌,我必昌狂!男人不靠帅,全靠风度带。不要跟哥牛,哥会扔砖头!我能抵抗一切,除了诱惑。不要迷恋哥,哥是属于她的。不要崇拜哥,哥兜里的钱不多。有钱才有魅力,这是个死道理。女人无情,男人何必自做多情。别说低调,哥走的就是这个调。不是哥迷恋传说,只是传说太美。哥在戒烟抽烟影响哥的良民形象。

  • 苏轼与佛印和尚(苏轼骂佛印像牛粪)

    苏轼骂佛印像牛粪【本文由賨人客独家原创,未经允许,不得转载,抄袭必究!】中学课本上,我们曾经学过一篇文章,叫《核舟记》,里面有这样一段描述:“船头坐三人,中峨冠而多髯者为东坡,佛印居右,鲁直居左佛印绝类弥勒,袒胸露乳。

  • 怎么做油炸小馒头(油炸小馒头的做法)

    怎么做油炸小馒头?下面内容希望能帮助到你,我们来一起看看吧!怎么做油炸小馒头准备好超市买的奶香小馒头。奶香浓郁口感更好。把馒头放在蒸笼上蒸熟,水开约5分钟左右即可;炒菜锅烧热,放入适量的玉米油,待油温六、七成轻轻搁入蒸好的小馒头,这个时候改用文火炸,用筷子不停翻转,直至馒头均匀成金黄色即可。

  • 有求必应中的应的意思(有求必应什么意思)

    接下来我们就一起去了解一下吧!有求必应中的应的意思有求必应的应释义:回答。有求必应的意思是:只要有人请求帮助,就一定答应。

  • 36条过江通道(21条过江通道未来五年)

    近日,南京市举行“十四五”重点专项规划系列专题新闻发布会(第三场),《南京市“十四五”综合交通运输体系发展规划》正式发布。到2025年,已建和在建的过江通道达18处21条。南京北站南京北站是北沿江高铁、宁淮城际、宁蚌城际以及京沪、宁启等普速客车的共用站房,更是北沿江高铁的控制性工程,是打造“轨道上的长三角”的重要节点工程,建成后将实现南京都市圈北翼1小时可达。

  • 三国杀名将传橙将阵容(三国杀名将传破虏孙坚登场)

    破虏孙坚于本次版本中正式登场,誓要守卫汉室江山与江东的富庶安宁。孙坚钓鱼不讲究“愿者上钩”的智者境界,而追求“多多益善”,喜欢钓一串鲜鱼与家人共享。飞升1:敌方武将攻击处于状态的破虏孙坚,则该敌方武将本次攻击将失效,每回合每个武将最多触发2次。全体生命增加20%,全体攻击增加12%。飞升3:自身处于状态时,己方每有1个武将存活,则敌方比破虏孙坚御甲高的武将,获得的御甲效果额外降低10%。

  • 西红柿烩牛腩怎么做(西红柿炖牛腩的做法)

    西红柿烩牛腩怎么做?食材:牛腩500g,西红柿500g,葱10g,姜10g,香菜10g,现在小编就来说说关于西红柿烩牛腩怎么做?要牛腩就是靠近牛肋骨的松软的肉,西红柿葱和姜。把牛腩切成小块,不要太大也不要太小,太大不容易煮透,熟后不容易嚼烂,太小又影响口感,你吃的时候也不好找到他们。牛腩冷水下锅焯一下,锅里放点姜片和料酒,还可以放一勺醋,去血去腥,焯完后捞出沥干水备用。西红柿炒成糊状后将牛腩倒入,放一点白糖和盐,翻炒匀。

  • 你若盛开好运自来(你若盛开蝴蝶自来)

    当邓老师的业务下滑,他们就抱怨我给他的业务少了,也不再请我吃饭,连一瓶水也舍不得请我喝。没业务,就是陌生人,不认识邓老师了,也不搭理邓老师了,也不回我的消息了!只要邓老师说有业务,一定有回音!

  • 卷帘门弹簧松了怎么收紧(收紧方法说明)

    卷帘门弹簧松了怎么收紧扭转弹簧的安装方法是先用手抓住扭转弹簧的壳体,面向人(从前方)向上的方向必须抓住。右手握住后,用扳手将固定在门体上螺丝松掉。钢卷帘必须比门体长80厘米才能达到最佳效果。

  • 好记性不如烂笔头什么意思(好记性不如烂笔头)

    各位同学,大家好。作为伟大的思想家、政治家、哲学家、革命家、经济学家、社会学家,马克思能成为这么多方面的“大家”,离不开一个好习惯,就是记,记笔记。隔一段时间,马克思就要重读一次他的笔记和书上作了记号的地方。就这样,马克思记忆的内容就越来越多,而且记忆力越来越好。终于,马克思花了40年的时间,完成了《资本论》这本伟大的著作。我国著名的词学家夏承焘把它概括为三个字:“小”、“少”、“了”。