主要模组简介绍

在Qt官网的介绍中，PyQt包括三个主要的基础模组。

• QtCore：提供核心非 GUI 功能，如信号和 槽、属性、项目模型的基类、 序列化等。
• QtGui：使用GUI功能扩展QtCore：事件，窗口 和屏幕，OpenGL和基于光栅的2D绘画，如 以及图像。
• QtWidgets：为您的应用程序提供现成的小部件， 包括 UI 的图形元素。

调用方式

如果需要调用某个模块，可以先在官网搜索该模块所在的基础模块，在程序中按以上的方式对应调用即可。

QT 官网

QT for python

1
2
3

from PySide6.QtWidgets import ...
from PySide6.QtGui import ...
from PySide6.QtCore import ...

安装与环境配置

安装

1

pip install -i https://pypi.tuna.tsinghua.edu.cn/simple/ pyside6

安装PySide6时就已经安装Qt Designer、uic和rcc工具。我们只需要在PyCharm里配置一下即可。

配置

使用PyCharm集成开发工具,在安装 QtTools库以后,还要对 QtDesigner和 PyUIC进行环境配置,将其集成到 PyCharm中

image-20230109003938283

QtDesigner

Qt Designer是PyQt和PySide通用的工具,通过拖拽窗口部件和属性编辑完成GUI的设计工作,保存为*.ui文件

拷到项目中使用。

安装完 pyside6直接在命令行运行 pyside6-designer即可打开 designer

从顶部菜单栏选择:File -> Settings,弹出 Seetings窗口；选择:Tools -> ExternalTools,在右侧点击 “+” 弹出 CreateTool窗口

image-20230116005934006

• Name:填写 QtDesigner,标识作用

• Program:填写 designer.exe 的路径,例如 F:\ProgramData\miniconda3\envs\notes\Scripts\pyside6-designer.exe

• Arguments:不用填写

• Working directory:填写生成 UI 文件的保存路径

  • 要将 .ui文件保存在当前``Project 路径下,则填写`
  • 要将 .ui文件保存在当前 Project路径下,\program 子目录中,则填

在项目名称(新建ui时)或你要编辑的ui文件上打开右键菜单,找到External Tools(或你设置的Group名称),打开PySide6 QtDesinger。

可以通过uic工具转成py文件使用,也可以通过以下代码调用

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24

import sys

from PySide6.QtCore import QFile, QIODevice
from PySide6.QtUiTools import QUiLoader
from PySide6.QtWidgets import QApplication

if __name__ == "__main__":

    app=QApplication(sys.argv)

    ui_file_name="01-窗口创建/demo.ui"
    ui_file=QFile(ui_file_name)
    if not ui_file.open(QIODevice.ReadOnly):
            print(f"Cannot open {ui_file_name}: {ui_file.errorString()}")
        sys.exit(-1)
    loader=QUiLoader()
    window=loader.load(ui_file)
    ui_file.close()
    if not window:
            print(loader.errorString())
        sys.exit(-1)
    window.show()

    sys.exit(app.exec())

PyUIC

pyuic安装在 Scripts目录下,对应 pyside6-uic.exe

PyUIC将QtDesigner生成的ui文件转换为py文件

从顶部菜单栏选择:File -> Settings,弹出 Seetings窗口；选择:Tools -> ExternalTools,在右侧点击 “+” 弹出 CreateTool窗口

CreateTool 窗口依次填写:

• Name:填写 PyUIC,标识作用
• Program:填写 pyside6-uic 的路径,需要区分虚拟环境和系统环境 F:\ProgramData\miniconda3\envs\notes\Scripts\pyside6-uic.exe
• Arguments:填写 -o ui_.py
• Working directory:填写将 .ui 文件转换为 .py 文件的保存路径,填写

在要转换的ui文件上点击右键,在右键菜单里使用上述配置好的uic工具即可转换为同名的py文件。

PyRCC

Program中配置的是pyside6-rcc.exe的文件路径

F:\ProgramData\miniconda3\envs\notes\Scripts\pyside6-rcc.exe

image-20230116012639083

• Name:填写 PyRCC
• Program:填写 pyside6-rcc 的路径,F:\ProgramData\miniconda3\envs\notes\Scripts\pyside6-rcc.exe
• Arguments中填写 -o rcc_.py
• Working directory中填写

新建一个resource.qrc文件,把用到的图片资源写到配置文件里

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19

<!DOCTYPE RCC>

<RCC version="1.0">

    <qresource> 

        <file alias="contacts.png">ico/contacts.png</file>

        <file alias="exit.png">ico/exit.png</file>

        <file alias="about.png">ico/about.png</file>

        <file alias="config.png">ico/config.png</file>

        <file alias="help.png">ico/help.png</file>

    </qresource>

</RCC>

也可以用Qt Designer右下角的资源编辑器进行编辑

image-20230116013508159

编辑保存后,到PyCharm中在要转换的qrc文件上点击右键,在右键菜单里使用上述配置好的rcc工具即可转换为同名的py文件。

引用py文件中的资源使用的时候用冒号加图片路径,如:

1

QtGui.Qpixmap(':images/file.png')

要把程序打包成可执行文件的时候,先把资源文件转成py后调用就方便多了。

基础了解

元对象系统

翻译信息:

本文翻译自 PySide6 官方文档 The Meta-Object System

协议:本翻译遵守原文档使用的GNU Free Documentation License version 1.3 授权

译者:muzing

翻译时间:2022.06

译者注:本文原文由Qt 6(C++) 文档直接转换而来,似乎代码部分并未完全替换为有效的 Python 代码,建议与 C++ 原版文档对比阅读

Qt 的元对象系统(meta-object system)和自省(introspection)功能的概述。

Qt 的元对象系统为对象间通信、运行时类型信息和动态属性系统提供了信号与槽机制。

元对象系统基于三件事:

1.QObject 类为可以利用元对象系统的对象提供基类。
2.类声明私有部分中的 Q_OBJECT 宏用于启用元对象特性,例如动态属性、信号和槽。
3.元对象编译器(moc) 为每个 QObject 子类提供实现元对象功能所需的代码。

moc 工具读取 C++ 源文件。如果它找到一个或多个包含 Q_OBJECT 宏的类声明,它会生成另一个 C++ 源文件,其中包含每个类的元对象代码。这个生成的源文件要么是 #include 被包含在类的源文件中,要么(更常见地)是被编译并与类的实现链接。

除了提供对象间通信的信号与槽机制(这是引入系统的主要原因),元对象代码还提供以下附加功能:

• metaObject() 返回类的关联 meta-object
• className() 在运行时将类名作为字符串返回,无需通过 C++ 编译器支持本机运行时类型信息(RTTI)
• inherits() 函数返回对象是否继承 QObject 继承树中指定类的类的实例
• tr() 翻译字符以进行国际化
• setProperty() 和 property() 按名称动态设置和获取属性
• newInstance() 构造一个新的类实例

也可以在 QObject 类上使用qobject_cast() 执行动态转换。qobject_cast() 函数的行为类似于 标准 C++ 的 dynamic_cast(),其优点是不需要 RTTI 支持,并且可以跨动态库边界工作。它尝试将其参数转换为尖括号中指定的指针类型,如果对象的类型正确(在运行时确定),则返回非零指针；如果对象的类型不兼容,则返回 None。

例如,假设 MyWidget 继承自 QWidget 并使用Q_OBJECT 宏声明:

1

obj = MyWidget()

QObject * 类型的 obj 变量实际上是指 MyWidget 对象,所以我们可以适当地转换它:

1

widget = QWidget(obj)

成功从 QObject 转换到 QWidget,因为对象其实是一个 MyWidget,它是 QWidget 的子类。由于我们知道 obj 是一个 MyWidget,所以也可以将其转换为 MyWidget *:

1

myWidget = MyWidget(obj)

转换至 MyWidget 成功,因为 qobject_cast() 没有区分内置 Qt 类型和自定义类型。

1
2

label = QLabel(obj)
# label is 0

另一方面,转换为 QLabel 失败。指针然后被设置为 0。这使得可以在运行时根据类型以不同的方式处理不同类型的对象:

1
2
3

if(QLabel label = QLabel(obj)) {            label.setText(tr("Ping"))
} else if(QPushButton button = QPushButton(obj)) {
    button.setText(tr("Pong!"))

虽然可以在没有 Q_OBJECT 宏和元对象代码的情况下使用QObject 作为基类,但如果不使用Q_OBJECT 宏,则信号和槽、以及此处描述的其他功能都将不可用。从元对象系统的角度来看,没有元代码的 QObject 子类等价于最接近的具有元对象代码的祖先 。这意味着,例如,className() 不会返回类的实际名称,而是这个祖先的类名。

因此,我们强烈建议 QObject 的所有子类都使用Q_OBJECT 宏,无论它们是否真的使用信号、槽和属性。

对象模型

翻译信息:

本文翻译自 Qt6 官方文档 Object Model

协议:本翻译遵守原文档使用的GFDLv1.3 授权

译者:muzing

翻译时间:2022.06

标准 C++ 对象模型为对象范例提供了非常有效的运行时支持。但它的静态性质在某些具体问题领域不够灵活。GUI 编程是一个需要运行时效率和高灵活性的领域。Qt 通过将 C++ 的速度与 Qt 对象模型的灵活性相结合,来实现这一点。

Qt 为 C++ 添加了如下特性:

• 一种非常强大的无缝对象通信机制,称为信号与槽
• 可查询和可设计的对象属性
• 强大的事件与事件过滤器
• 上下文相关的用于国际化的字符串翻译
• 精巧的间隔驱动计时器,可以在事件驱动的 GUI 中优雅地集成许多任务
• 以自然方式组织对象所有权的,分层和可查询的对象树
• 受保护的指针(QPointer)在被引用的对象被销毁时自动设置为 0。这与普通的 C++ 指针不同,后者在其对象被销毁时变成空指针
• 跨库边界工作的动态转换
• 支持创建自定义类型

这些 Qt 特性中的许多是基于从QObject 的继承,用标准 C++ 技术实现。其他的,比如对象通信机制和动态属性系统,需要由 Qt 自带的元对象编译器(moc)提供的元对象系统。

元对象系统是一种 C++ 扩展,使得该语言更适合真正的组件 GUI 编程。

重要的类

这些类构成了 Qt 对象模型的基础。

Qt 对象:身份？值？

上面列出的 Qt 对象模型的一些附加功能要求我们将 Qt 对象视为身份(identities),而不是值(values)。值被复制或分配,身份被克隆。克隆意味着创建一个新的身份,而不是旧身份的精确复制品。例如,双胞胎有不同的身份。他们可能看起来相同,但名称不同、位置不同,并且可能有完全不同的社交圈子。

克隆身份是比复制或分配更复杂的操作。我们可以在 Qt 对象模型中看到这意味着什么。

一个 Qt 对象……

• 可能有一个唯一的QObject::objectName()。如果我们复制一个 Qt 对象,该给这个副本起什么名字呢？
• 在对象层次结构中占据一个位置。如果我们复制一个 Qt 对象,副本应该放在哪里？
• 可以连接到其他 Qt 对象以向它们发出信号或接收它们发出的信号。如果我们复制一个 Qt 对象,该如何将这些连接转移到副本中呢？
• 可以在运行时添加未在 C++ 类中声明的新属性。如果我们复制一个 Qt 对象,副本是否应该包括添加到原始对象的属性？

出于这些原因,Qt 对象应该被视为身份而不是值。身份是克隆的,而不是复制或分配的,克隆身份是比复制或分配值更复杂的操作。因此,QObject 及其所有直接或间接继承的子类,都被禁用了复制构造函数和赋值运算符。

对象树与所有状态

概述

QObjects 在对象树(object trees)中组织自身。当创建一个以另一个对象为父对象的QObject 时,它会被添加到父对象的children() 列表中,并在父对象被销毁时销毁。事实证明,这种方式非常适合 GUI 对象的需求。例如,一个QShortcut(键盘快捷键)是相关窗口的子对象,因此当用户关闭该窗口时,快捷键也会被销毁。

QQuickItem 是 Qt Quick 模块的基本视觉元素,继承自QObject,但有一个与 QObject 父对象不同的视觉父项的概念。一个项目的视觉父项可能并不是其父对象。参阅Concepts - Visual Parent in Qt Quick 获取更多详细信息。

QWidget,即 Qt Widgets 模块的基础类,扩展了父子关系。一个普通子对象也成为一个子控件,也就是说,它会被显示在父级的坐标系中,并被其父级的边界按图形方式裁剪。例如,当应用程序在关闭消息框后销毁它时,正如我们所希望的那样,消息框的按钮和标签也被销毁,这是因为按钮和标签是消息框的子控件。

您也可以自行删除子对象,它们会自动从其父控件中移除自己。例如,当用户移除一项工具栏时,可能会导致应用程序删除其QToolBar 对象之一,在这种情况下,工具栏的父对象QMainWindow 将检测到变化,并相应地重新配置其屏幕空间。

当应用程序视觉上或行为上表现异常时,调试函数QObject::dumpObjectTree() 和QObject::dumpObjectInfo() 通常很有用。

QObjects 的构造/销毁顺序

当QObjects 在堆上创建(即,使用new 创建)时,可以以任意顺序从它们构建对象树,稍后,可以以任意顺序销毁树中的对象。当任何QObjects 被删除时,如果该对象有父对象,则析构函数会自动从其父对象中删除该对象。如果该对象有子对象,则析构函数会自动删除每个子对象。不管销毁的顺序,没有QObjects 会被删除两次。

当QObjects 在栈上创建时,适用相同的行为。通常,破坏顺序仍不会造成问题。考虑一下代码段:

1
2
3
4
5
6

int main()
{
    QWidget window;
    QPushButton quit("Quit", &window);
    ...
}

父对象 window 和子对象 quit 都是QObjects,因为QPushButton 继承自QWidget,QWidget 又继承自QObjects。这段代码是正确的:quit 的析构函数没有被调用两次,因为 C++ 语言标准 (ISO/IEC 14882:2003) 指定本地对象的析构函数按其构造函数的相反顺序调用。因此,先调用子对象 quit 的析构函数,然后将自己从其父对象 window 中移除,再调用window 的析构函数。

但是考虑一下如果交换构造顺序会发生什么,如第二个片段所示:

1
2
3
4
5
6
7
8

int main()
{
    QPushButton quit("Quit");
    QWidget window;

    quit.setParent(&window);
    ...
}

在这种情况下,破坏顺序会引发问题。首先调用父对象的析构函数,因为它是最后被创建的。然后调用其子对象 quit 的析构函数,但这是不正确的,因为 quit 是一个局部变量。当 quit 随后超出作用域时,其析构函数再次被调用,这一次是正确的,但已经发生了破坏。

继承关系图

QtWidgets

所有可视控件都继承自QWidget类

QtWidgets

可利用__subclasses__魔法方法获取各个组件的继承关系

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34

def get_direct_inherited(widget):
    """获取组件被直接继承的子类,不包含多层继承的"""
    return widget.__subclasses__()


def get_inherit_subclass(widget):
    """"获取组件被继承以及多层继承的所有子类"""
    all_inherit_list=list()

    def get_subclass(cls):
        return cls.__subclasses__()

    def get_widget_all_inherit(_subclass):
        nonlocal all_inherit_list

        if get_subclass(_subclass) !=0:
            for subclass in get_subclass(_subclass):
                all_inherit_list.append("-----------------")
                all_inherit_list.append(subclass)
                get_widget_all_inherit(subclass)

    cls_inherit_list=get_subclass(widget)
    for subclass_inherit in cls_inherit_list:
        all_inherit_list.append(subclass_inherit)
        get_widget_all_inherit(subclass_inherit)

    return all_inherit_list


if __name__=='__main__':
    from PySide6.QtWidgets import QWidget

    get_direct_inherited(QWidget)
    # get_inherit_subclass(QWidget)

Qt 命名空间

QtCore.Qt 命名空间下包含了整个 Qt 库中所使用的各种标识符。

这些标识符大多为枚举(enum)或标志(flags)类型。本文收录部分标识符文档的中文翻译,按字母顺序排列。

###Alignment

Qt.AlignmentFlag 中又分为水平对齐方式与垂直对齐方式,具体有如下数种:

水平对齐:

垂直对齐:

若需同时设置水平、垂直两个维度的对齐方式,只需将两个Flags用或运算符连接,例如:
Qt.AlignCenter 等价于 Qt.AlignVCenter | Qt.AlignHCenter

###CursorMoveStyle

此枚举值描述文本光标移动的风格。逻辑风格中,键盘左箭头意味着光标向文本的前方移动(对于从右至左的文本,前方意味着右方)；而视觉风格中,键盘左箭头意味着光标向视觉上的左侧移动,而不考虑文本书写方向。

###FocusPolicy

###LayoutDirection

控制 Qt 的布局与文字方向。

对于阿拉伯语、希伯来语等特定语言,需要从右至左布局。

###ScrollBarPolicy

此枚举类型描述了QAbstractScrollArea 滚动条的各种模式。水平滚动条与垂直滚动条的模式相互独立。

###TextElideMode

此枚举值指定显示需省略的文本时省略号应出现的位置:

Qt.ElideMiddle 通常是最适合 URL 的选择(例如,”http://bugreports.qt.../QTWEBSITE-13/"),而 Qt.ElideRight 适合其他字符串。

###TextFormat

###TextInteractionFlag

###WindowModality

此枚举值用于控制窗口的模态行为。对话框窗口大多为模态窗口。

###WindowType

此枚举值用于为控件指定各种窗口系统(window-system)属性。它们一般比较少见,但在少数情况下是必要的。其中一些标志取决于底层窗口管理器是否支持。

主要类型包括:

还有许多标志可用于自定义顶级窗口的外观。这对其他窗口没有影响:

模块简介

PySide是Qt在Python的绑定,是将C++开发环境下的Qt移植到Python环境下。由于Python 语句简单,用Python语言开发Qt应用程序就变得相对容易。

下面内容是PySide几个主要模块的简介,其中 QtWidgets、QtCore和QtGui 是基本模块,开发GUI时都会用这三个模块,其他模块是扩展模块。模块有 QtWidgets、QtCore、QtGui,QtWebEngineWidgets、QtChart、QtMultimedia、QtSql 和 QtPrintSupport。

• QtWidgets是窗口模块,提供窗口类和窗口上的各种控件(按钮、菜单、输人框、列表框等)类。
• QtCore 是核心模块,是其他模块的应用基础,包括五大模块:元对象系统、属性系统、对象模型、对象树、信号与槽。QtCore 模块涵盖了 PySide 核心的非 GUI 功能,此模块被用于处理程序中涉及的时间、文件、目录、数据类型、文本流、链接、MIME.线程或进程等对象。
• QtGui 模块涵盖多种基本图形功能的类,包括事件处理、2D图形、基本的图像和字体文本等。
• QtSql模块提供了常用关系型数据库的接口和数据库模型,方便读写数据库中的数据。
• QtMultimedia 模块包含处理多媒体事件的类库,通过调用API接口访问摄像头、语音设备,播放音频和视频,录制音频和视频及拍照等。
• QtChart 和QtDataVisualization 模块用于数据可视化,可以绘制二维和三维数据图表。
• QtPrintSupport 模块提供打印支持,能识别系统中安装的打印机并进行打印,可以对打印参数进行设置,提供打印对话框和打印预览对话框。
• QtBluetooth 模块包含了处理蓝牙的类库,它的功能包括扫描设备、连接、交互等。QtNetwork 模块包含用于网络编程的类库,这组类库通过提供便捷的TCP/IP及UDP的c/s程式码集合,使得网络编程更容易。
• QtWebEngine 和 QtWebEngineWidgets 模块借助开源的Chromium浏览器,在应用程序中嵌入 Web 浏览功能。
• QtXml模块包含了用于处理XML的类库,提供实现SAX和DOMAPI的方法。· QtOpenGL、QtOpenGLFunctions 和 QtOpenGLWidgets 模块使用OpenGL 库来渲染3D和2D图形,该模块使得Qt GUI库和OpenGL库无缝集成。
• QtDesigner模块可以为Qt Designer 创建白定义控件。
• QtSvg 模块为显示矢量图形文件的内容提供了函数。
• QtTest模块包含了可以通过单元测试调试PySide应用程序的功能。
• QtStateMachine 模块可以创建和执行状态图。
• QtHelp 模块可以为应用程序集成在线帮助。
• QtConcurrent 模块支持多线程程序。
• Qt3DCore、Qt3DInput、Qt3DRender、Qt3DAnimation、Qt3DLogic、Qt3DExtras等模块提供三维渲染、三维实时动画。

QWidget窗口的创建

PySide6的窗口类主要有三种,分别为QWidget、QMainWindow 和QDialog,其中QMainWindow 和 QDialog 从QWidget类继承而来。要创建和显示窗口,需要用这3个类中的任意一个类实例化对象,并让窗口对象显示并运行起来。窗口类在PySide6的QtWidgets 模块中,使用窗口类之前,需要用”from PySide6.QtWidgets import QWidget,QMainWindow,QDialog”语句把它们导人进来。

下面的代码创建一个空白的QWidget 窗口,读者需要理解这段代码,这是整个PySide6

可视化编程最基础的知识。

1
2
3
4
5
6
7
8
9

import sys
from PySide6.QtWidgets import QApplication, QWidget

app = QApplication(sys.argv)  # 创建应用程序实例对象
myWindow = QWidget()  # 创建窗口实例对象
myWindow.show()  # 显示窗口
n = app.exec()  # 执行 exec()方法,进入事件循环,若遇到窗口退出命令,返回整数工
sys.exit(n)  # 通知Python系统,结束程序运行

1.第1行导入系统模块sys,这个系统模块是指Python系统,而不是操作系统。
2.第2行导入QApplication 类和 QWidget 类,PySide6 的类都是以大写字母”Q”开始。
3.第4行创建OAnnlicatinn 类的实例对象ann.为窗口的创建进行初始化、其中svs.
4.argv是字符串列表,记录启动程序时的程序文件名和运行参数,可以通过print(sys.argv)函数输出sys.argv的值,sys.argv的第1个元素的值是程序文件名及路径,也可以不输入参数sys.argv 创建 QApplication 实例对象app。QApplication可以接受的两个参数是-nograb 和-dograb,-nograb告诉Python禁止获取鼠标和键盘事件,dograb则忽略-nograb选项功能,而不管-nograb参数是否存在于命令行参数中。一个程序中只能创建一个QApplication 实例,并且要在创建窗口前创建。
5.第5行用不带参数的QWidget 类创建QWidget 窗口实例对象myWindow,该窗口是独立窗口,有标题栏。
6.第6行用show()方法显示窗口,这时窗口是可见的。
7.第7行执行QApplication实例对象的exec()方法,开始窗口的事件循环,从而保证窗口一直处于显示状态。如果窗口上有其他控件,并为控件的消息编写了处理程序,则可以完成相应的动作。如果用户单击窗口右上角的关闭窗口按钮×正常退出界面,或者因程序崩溃而非正常终止窗口的运行,都将引发关闭窗口(closeA1lWindows())事件,这时app的方法exec()会返回一个整数,如果这个整数是0表示正常退出,如果非0表示非正常退出。请注意,当执行到app的exec()方法时,会停止后续语句的执行,直到所有可视化窗体都关闭(退出)后才执行后续的语句。需要注意的是,还有一个与exec()方法功能相同的方法exec_(),但exec_()方法已过时。
8.第8行调用系统模块的exit()方法,通知Python解释器程序已经结束,如果是sys.exit(0)状态,则Python 认为是正常退出；如果不是sys.exit(0)状态,则Python 认为是非正常退出。无论什么情况,sys.exit()都会抛出一个异常SystemExit,这时可以使用try…except语句捕获这个异常,并执行except中的语句,例如清除程序运行过程中的临时文件；如果没有try…except语句,则 Python解释器终止 sys.exit()后续语句的执行。第7行和第8行可以合并成一行sys.exit(app.exec())来执行。运行上面的程序,会得到一个窗口,这还只是一个空白窗口,在窗口上没有放置任何控件。
9.第78行可以这么简写sys.exit(app.exec())

在PyQt中使用qrc/rcc资源系统

本文摘自在PyQt中使用qrc/rcc资源系统 - muzing的杂货铺

Qt 资源系统简介

Qt 资源系统(The Qt Resource System)是一种独立于平台的资源管理器,用于在应用程序的可执行文件中存储二进制文件。对 PyQt 而言,这意味着在 Python 代码中直接以二进制形式存储图标、QSS、长文本翻译等资源文件。使用Qt 资源管理系统可以有效防止资源文件丢失,对于需要打包发布 的 PyQt 程序尤其实用。

在项目中使用Qt 资源系统,大致分为三个步骤:编写 .qrc 文件、使用rcc 编译资源、导入与使用。下文将一一详细讲解。

qrc 文件

简介与示例

Qt 资源集合文件(Qt Resource Collection File)一般以 .qrc 作为扩展名保存,故简称 .qrc 文件。其文件格式基于XML,用于将文件系统(硬盘)中的资源文件与 Qt 应用程序关联起来。.qrc 还可以实现为资源分组、设置别名等功能。

下面是一个简单的例子:

Resources 目录下包含图标、关于文档等资源文件。

1
2
3
4
5
6
7
8

$ tree Resources
Resources
├── Icons
│   ├── Py2exe-GUI_icon_72px.png
│   └── Python_128px.png
├── Texts
│   └── About_zh.md
└── resources.qrc

在此处新建一个 resources.qrc 文件,内容如下:

1
2
3
4
5
6
7
8

<!DOCTYPE RCC>
<RCC>
    <qresource>
        <file>Icons/Py2exe-GUI_icon_72px.png</file>
        <file>Icons/Python_icon.ico</file>
        <file>Texts/About_zh.md</file>
    </qresource>
</RCC>

注意文件的相对路径是以 .qrc 所在的目录 Resources\ 为根目录开始计算的。

这样便建立了硬盘上文件系统中原文件与 Qt 资源系统中资源路径之间的联系。

使用前缀进行分组

在文件系统中,可以通过目录对不同类型的资源进行分组。在上面的例子中,图标文件都在 Icons/ 目录下,而长文本在 Texts/ 下。在 .qrc 中,也可以通过指定 <qresource> 标签的 prefix 属性来对资源进行分组:

1
2
3
4
5
6
7
8
9
10

<!DOCTYPE RCC>
<RCC>
    <qresource prefix="icons">
        <file>Icons/Py2exe-GUI_icon_72px.png</file>
        <file>Icons/Python_icon.ico</file>
    </qresource>
    <qresource prefix="texts">
        <file>Texts/About_zh.md</file>
    </qresource>
</RCC>

为资源创建别名

有些资源的文件名很长,每次使用时都输入完整文件名较为繁琐。可以通过在 <file> 标签中添加 alias 属性为其创建别名,方便未来在资源路径中使用:

1
2
3
4
5
6
7
8
9
10

<!DOCTYPE RCC>
<RCC>
    <qresource prefix="icons">
        <file alias="Py2exe-GUI_icon">Icons/Py2exe-GUI_icon_72px.png</file>
        <file alias="Python_icon">Icons/Python_icon.ico</file>
    </qresource>
    <qresource prefix="texts">
        <file alias="About_Text">Texts/About_zh.md</file>
    </qresource>
</RCC>

使用rcc 编译资源

rcc 简介

Qt 提供了Resource Compiler 命令行工具(简称 rcc),用于在构建过程中将资源嵌入 Qt 应用程序。对于 PyQt.也有对应版本的 rcc 工具,用于将 .qrc 中指定的资源文件数据编译至 Python 对象。

rcc 的安装与基本使用

当通过 pip 安装 PySide6 或其他 PyQt 时,会同时自动安装对应版本的 rcc 工具。这些工具的调用命令有所不同(详见下表),但使用方式与功能是一致的。激活已安装 PyQt 的 Python 虚拟环境,在命令行(注意不是 Python 交互式解释器)中输入对应的 rcc 命令即可。

使用PySide6 提供的 pyside6-rcc 工具编译出的 .py 文件,也可以放入 PyQt6 项目中使用,只需将文件开头的 from PySide6 import QtCore 替换为 from PyQt6 import QtCore 即可。

例如,对于 PySide6,在命令行调用命令

1

pyside6-rcc -o compiled_resources.py resources.qrc

即可将 resources.qrc 中列出的资源文件编译到输出文件 compiled_resources.py 中。

rcc 命令行选项

此处以 pyside6-rcc 6.4.1 为例,列出了完整的选项列表(翻译版):

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52

$ pyside6-rcc --help
Usage: /path/to/your/python3/site-packages/PySide6/Qt/libexec/rcc[options]inputs
Qt Resource Compiler version 6.4.1

Options:
  -h, --help                            显示关于命令行选项的帮助
  
  --help-all                            显示包括Qt独有选项在内的所有帮助
  
  -v, --version                         显示版本信息
  
  -o, --output <file>                   将输出写入到 <file> 中,而不是 stdout 中

  -t, --temp <file>                     为大资源文件使用临时文件 <file>
  
  --name <name>                         用<name> 创建一个外部初始化函数
  
  --root <path>                         用根目录 <path> 作为资源访问路径的前缀
  
  --compress-algo <algo>                使用<algo> 算法压缩输入文件([zlib], none)
  
  --compress <level>                    按 <level> 级别压缩输入文件
  
  --no-compress                         禁用所有压缩,等同于 --compress-algo=none
  
  --no-zstd                             禁止使用zstd 压缩
  
  --threshold <level>                   衡量是否值得进行压缩的阈值
  
  --binary                              输出一个作为动态资源使用的二进制文件
  
  -g, --generator <cpp|python|python2>  选择生成器
  
  --pass <number>                       Pass number for big resources
  
  --namespace                           关闭命名空间宏
  
  --verbose                             启用verbose 模式
  
  --list                                只列出 .qrc 文件条目,不生成代码
  
  --list-mapping                        只输出 .qrc 中定义的资源路径与文件系统路径的
                                        映射,不生成代码
                                        
  -d, --depfile <file>                  向 <file> 中写入一个包含 .qrc 依赖项的 depfile

  --project                             输出一个包含当前目录下所有文件的资源文件
  
  --format-version <number>             写入 RCC 格式的版本

Arguments:
  inputs                                输入文件(*.qrc)

编译出的 Python 文件

运行成功后,在 .qrc 中声明的所有资源文件都已经被编译到 compiled_resources.py 这个 Python 文件中,不妨打开查看其内容:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23

# 以下为 compiled_resources.py 文件中内容

# Resource object code(Python 3)
# Created by: object code
# Created by: The Resource Compiler for Qt version 6.4.1
# WARNING! All changes made in this file will be lost!

from PySide6 import QtCore

qt_resource_data = b"......"

qt_resource_name = b"......"

qt_resource_struct = b"......"

def qInitResources():
    QtCore.qRegisterResourceData(0x03, qt_resource_struct, qt_resource_name, qt_resource_data)

def qCleanupResources():
    QtCore.qUnregisterResourceData(0x03, qt_resource_struct, qt_resource_name, qt_resource_data)

qInitResources()

最上方的注释标明了该文件由与 Qt6.4.1 版本匹配的资源编译器生成。并警告用户不要直接编辑该文件,因为所有修改都会被下一次编译操作覆盖掉。

接下来是三段长长的二进制编码字符串,其中正是资源文件:

• qt_resource_data - 资源文件内容数据
• qt_resource_name - 资源文件名称
• qt_resource_struct - 资源结构

还有两个函数 qInitResources() 与 qCleanupResources(),分别对应向 Qt 中注册资源与清理资源。

代码的最后一行调用了注册资源函数。

在主程序中使用

对于 PyQt 程序,从「直接加载使用资源文件」切换到「使用Qt 资源系统读取资源」,还需要如下步骤:

1.在主程序中导入编译后的资源
2.用「资源路径」替换「文件路径」
3.由使用Python 内置 open() 函数改为使用Qt 中QFile 类或QDir 类提供的 open() 方法

导入编译后的资源

在主程序中添加 import 导入语句,将刚才获得的 compiled_resources.py 导入:

1

import compiled_resources  # type: ignore

因为 import 的过程会执行该模块中的所有代码,也就自动调用了 qInitResources() 函数,完成了资源的注册与加载。

PyCharm 等 IDE 可能将此行代码判断为 “未使用的 import 语句” 而提示一个弱警告。可以通过在该行末尾添加特殊的 # type: ignore 注释来显式告知静态检查器忽略此行,消除这种不必要的警告。

资源路径

对于直接使用资源原文件,会使用其在文件系统中的路径,例如

1

icon = QPixmap("Icons/Python_icon.ico")

而在 Qt 资源系统中使用,则需要将文件路径替换为「资源路径」。资源路径由 .qrc 文件决定。

对于最一般的情况,直接在文件名前添加 :/ 即可得到其资源路径:

1
2
3

<qresource>
    <file>Icons/Python_icon.ico</file>
</qresource>

1

icon = QPixmap(":/Python_icon.ico")

对于有前缀进行分组的,则需要在文件名前添加 ://作为资源路径:

1
2
3

<qresource prefix="icons">
    <file>Icons/Python_icon.ico</file>
</qresource>

1

icon = QPixmap(":/icons/Python_icon.ico")

对于指定了别名的,可以直接使用别名:

1
2
3

<qresource prefix="icons">
    <file alias="Py_ico">Icons/Python_icon.ico</file>
</qresource>

1

icon = QPixmap(":/icons/Py_ico")

读取资源文件

需要使用Qt 提供的QFile 或QDir 读取编译后的资源文件,而不再能使用Python 提供的 open() 函数等。

例如,一段从 Markdown 文件中读取应用程序”关于”文本的代码,使用直接读取原资源文件的写法如下:

1
2
3
4
5

def get_about_text():
    about_file = open(../../Resources/About.md", "r", encoding="utf-8")  # 调用Python内置的open()
    about_text = about_file.read()
    about_file.close()
    return about_text

而使用Qt 资源系统后,需要修改为如下形式:

1
2
3
4
5
6
7
8
9

from PySide6.QtCore import QFile, QIODevice

def get_about_text():
    # 使用Qt风格读取文本文件
    about_file = QFile(":/texts/About_Text")  # 使用Qt中的QFile类
    about_file.open(QIODevice.ReadOnly | QIODevice.Text)  # 打开文件
    about_text = str(about_file.readAll(), encoding="utf-8")  # 读取文件,并将 QBtyeArray 转为 str
    about_file.close()
    return about_text

对于图片,可以在创建QIcon、QImage、QPixmap 对象时将直接资源路径作为参数传入:

1

icon = QPixmap(":/icons/Python_icon.ico")

在 IDE 中配置

在 PyCharm 中配置使用rcc

可以将 rcc 工具添加至 PyCharm 中,避免每次使用都需要输入繁琐的命令行。(目前版本的 PyCharm 中已经原生内置了对 pyrcc4 和 pyside-rcc 的支持,但其他版本的 rcc 工具快捷使用仍需自行在「外部工具」中创建。)

打开 文件 -> 设置 -> 工具 -> 外部工具(File -> Settings -> Tools -> External Tools)

打开设置-工具-外部工具

然后创建工具。配置可以参考下图,仍然以 pyside6-rcc 为例:

在 PyCharm 中配置 rcc 工具

其中比较重要的是「工具设置」里面的三行配置:

1
2
3

程序:        /pyside6-rcc
实参:        -o compiled_.py 
工作目录:     

其中凡是以一对 $ 包裹的字符,均为 PyCharm 提供的宏,分别代表「Python 解释器目录」、「不带扩展名的文件名」、「文件名」和「文件所在目录」。

完成配置后,在待编译的 .qrc 文件上打开右键菜单,找到「外部工具 - pyside6-rcc」,点击即可运行,非常方便。

在右键菜单中使用pyside6-rcc外部工具

使用VS Code 编辑 qrc

安装Qt for Python 插件后,VS Code 编辑器会对 .qrc 文件提供一定的语法高亮、亦可一键编译。

1
2

# VS Code 插件安装命令:
ext install seanwu.vscode-qt-for-python

Qt for Python 插件提供了丰富的功能

使用QtCreator 编辑 qrc

此小节参考自 https://blog.csdn.net/anbuqi/article/details/120455219。

直接在文本编辑器中以 XML 形式编写复杂的 .qrc 文件时,较为繁琐、易出错,可以考虑安装 Qt 官方的QtCreater IDE 来生成 .qrc 文件。

1
2
3
4
5
6
7

$ tree resource
resource
├── icon
│   ├── ic_last_step.svg
│   ├── ic_next_step.svg
│   └── ic_start.svg
└── res.qrc

首先启动 QtCreater,在 resource/ 目录中新建 res.qrc 文件:

创建qrc文件与添加图标路径

然后以 icon 前缀创建一个分组:

添加前缀

接着用Add Files 按钮把图标文件添加进来,并保存:

将图标文件添加到路径中

此时得到了 res.qrc:

1
2
3
4
5
6
7

<RCC>
    <qresource prefix="/icon">
        <file>icon/ic_last_step.svg</file>
        <file>icon/ic_next_step.svg</file>
        <file>icon/ic_start.svg</file>
    </qresource>
</RCC>

为了缩短引用路径,还可以为每个图标文件设置别名(alias):

设置别名

现在得到这样的 res.qrc:

1
2
3
4
5
6
7

<RCC>
    <qresource prefix="/icon">
        <file alias="ic_last_step">icon/ic_last_step.svg</file>
        <file alias="ic_next_step">icon/ic_next_step.svg</file>
        <file alias="ic_start">icon/ic_start.svg</file>
    </qresource>
</RCC>

进阶话题

国际化多语言

有时应用程序需要在不同的语言环境下使用不同的文件,可以通过设置 lang 属性来轻松实现。下面是一个例子:

1
2
3
4
5
6

<qresource>
    <file>cut.jpg</file>
</qresource>
<qresource lang="fr">
    <file alias="cut.jpg">cut_fr.jpg</file>
</qresource>

当系统语言为其他语言时,Qt 程序将会使用文件 cut.jpg；而当系统语言为法语时,会自动替换为 cut_fr.jpg。

压缩

rcc 会尝试压缩内容以优化硬盘空间使用。默认情况下,它将进行启发式检查以确认是否值得压缩。如果不能充分压缩,则将直接存储非压缩的内容。可以使用-threshold选项控制此判断的阈值。例如,默认情况下阈值为 70,表示只有在压缩后的文件比原文件小 70%(不超过原文件大小的 30%)时才有必要压缩。

1

rcc -threshold 25 myresources.qrc

在某些情况下也可以关闭压缩功能。一种常见情况是,某些资源已经是压缩后的格式(例如 .png 文件),再次压缩几乎不会进一步减小文件体积,但会占用CPU 成本。另一种情况是,硬盘空间非常充裕,期望应用程序在运行时可以将内容存储在干净的内存页中。在命令行中添加 -no-compress 命令以关闭压缩。

1

rcc -no-compress myresources.qrc

还可以控制 rcc 使用的压缩算法与压缩级别,例如:

1

rcc -compress 2 -compress-algo zlib myresources.qrc

表示使用zlib 压缩算法,压缩等级为 2。

除了在命令行调用rcc 时指定选项,还可以在 .qrc 文件中控制阈值、压缩算法与压缩等级:

1
2
3

<qresource>
    <file compress="1" compress-algo="zstd">data.txt</file>
</qresource>

rcc 具体支持的压缩算法类型与压缩等级,参见官方文档。

参考资料

1.Qt6 官方文档:The Qt Resource System
2.Qt6 官方文档:Resource Compiler(rcc)
3.Qt for Python 官方教程:Using .qrc Files(pyside6-rcc)
4.pyside6(1):Qt 资源系统和qrc文件使用
5.Stack Overflow: How can resources be provided in PyQt6(which has no pyrcc)?

信号与槽

信号与槽概念

对于可视化编程,需要将界面上的控件有机结合起来,实现控件功能的联动和交互操作。

通过信号(signal)与槽(slot)机制实现的交互功能。

信号与槽是PySide6编程的基础,也是Qt的一大创新,有了信号与槽的编程机制,在PySide6中处理界面上各个控件的交互操作时变得更加直观和简单。

信号是指从QObject类继承的控件(窗口、按钮、文本框、列表框等)在某个动作下或状态发生改变时发出的一个指令或一个信息

例如一个按钮被单击(clicked)、右击一个窗口(customContextMenuRequested)、一个输入框中文字的改变(textChanged)等

当这些控件的状态发生变化或者外界对控件进行输人时,让这些控件发出一个信息,来通知系统其某种状态发生了变化或者得到了外界的输入,以便让系统对外界的输人进行响应。

槽是系统对控件发出的信号进行的响应,或者产生的动作,通常用函数来定义系统的响应或动作。

例如对于单击”计算”按钮,按钮发出被单击的信号,然后编写对应的函数,当控件发出信号时,就会自动执行与信号关联的函数。

信号与槽的关系可以是一对一,也可以是多对多,即一个信号可以关联多个槽函数,一个槽函数也可以接收多个信号。PySide6已经为控件编写了一些信号和槽函数,使用前需要将信号和槽函数进行连接,另外用户还可以自定义信号和自定义槽函数。

重载型信号的处理

重载型信号连接

查询控件的信号时,会发现有些控件有多个名字相同但是参数不同的信号。

例如对于按钮有clicked()和 clicked(bool)两种信号,一种不需要传递参数的信号,另一种传递布尔型参数的信号。

这种信号名称相同、参数不同的信号称为重载(overload)型信号。

对于重载型信号定义自动关联槽函数时,需要在槽函数前加修饰符@Slot(type)声明是对哪个信号定义槽函数,其中type是信号传递的参数类型。

例如如果对按钮的clicked(bool)信号定义自动关联槽函数,需要在槽函数前加入@Slot(bool)进行修饰；如果对按钮的clicked()信号定义自动关联槽函数,需要在槽函数前加人@Slot()进行修饰。

需要注意的是,在使用@Slot(type)修饰符前,应提前用from PySide6.QtCore import Slot语句导人槽函数。

定义一个信号后就有连接connect()、发送emit()、断开disconnect()属性

重载型信号断开

已连接的信号非重载类型的直接使用signaName.disconnect()断开连接即可

重载类型的使用signaName[type].disconnect()断开连接

手动关联内置信号的自定义槽函数

除了使用控件内置信号定义自动连接的槽函数外,还可以将控件内置信号手动连接到其他函数上,这时需要用到信号的 connect()方法。

btnCalculate.clicked.connect(self.method)语句将按钮的单击信号clicked与method()函数进行连接

也可以在主程序中,在消息循环语句前用myWindow.ui.btnCalculate.clicked.connect(myWindow.method)语句进行消息与槽函数的连接

基类QObject

QObject是所有的Qt对象的基类,所有的对象都是直接或者间接的继承自QObject

对象名称,属性

API

应用场景

• 用于qss的ID选择器,属性选择器,方便统一设置样式

  QObject.qss

  1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18

  QLabel#notice { font-size: 20px; color: gray; border: 1px solid gray; border-radius: 8px; } QLabel#notice[notice_level="normal"]{ color: green; border-color: green; } QLabel#notice[notice_level="warning"]{ color: yellow; border-color: yellow; } QLabel#notice[notice_level="error"]{ color: red; border-color: red; }

• 用于装饰器的信号与槽

父子对象操作

API

1

参数1:QObject对象或者多个QObject对象元组

1

参数2:setProperty设置的属性名称,可以省略

1

参数3:查找选项,有两个可选

Qt.FindChildrenRecursively(递归查找,默认选项)/Qt.FindDirectChildrenOnly(只查找直接子对象) |

应用场景

内存管理机制

当创建一个QObject时,如果使用了其他对象作为其父对象 那么,它就会被添加到父对象的children()列表中.当父对象被销毁时,这个QObject也会被销毁

• 涉及到Qt对象内存管理机制
• 如果一个控件,没有任何父控件,那么就会被当成顶层控件(窗口)
• 如果想要一个控件被包含在另外一个控件内部,就需要设置父子关系

顶层控件

如果一个控件,没有任何父控件,那么就会被当成顶层控件(窗口)

多个顶层窗口相互独立

如果想要一个控件被包含在另外一个控件内部,就需要设置父子关系

• 显示位置受父控件约束
• 生命周期也被父对象接管

案例

1.创建两个独立的窗口

要求

设置不同的标题
社会我顺哥
人狠话不多
涉及知识点
创建窗口
设置窗口标题
掌握级别
了解如果创建控件没有设置任何父对象, 会有什么效果

2.创建一个窗口, 包含另外两个子控件QWidget

要求

两个子控件必须在同一个窗口内部
涉及知识点
控件的父子关系
掌握级别
掌握给一个控件设置父控件的两种方式

3.创建一个窗口, 包含多个子控件QWidget和QLabel

要求

要求让所有的QLabel类型子控件都设置背景颜色为cyan
即使后续再增加新的QLabel子控件
涉及知识点
控件的父子关系设置
获取一个控件的子控件
样式设置
掌握级别
了解

信号处理

API

应用场景

• 监听信号, 响应用户行为
• 信号与槽机制

案例

1.当用户点击按钮的时候, 打印”点我嘎哈?”

要求

用户点了按钮, 你就负责打印
涉及知识点
按钮创建, 设置
监听按钮点击的信号
掌握级别
了解信号监听部分

2.在所有修改的窗口标题前, 添加前缀”撩课-“

要求

比如, 后续我们修改标题为”Hello Sz”; 最终会自动变为”撩课-Hello Sz!”
支持多次修改
涉及知识点
设置窗口标题
监听窗口标题改变信号
临时取消/恢复信号与槽的连接
掌握级别
了解信号监听部分

类型判定

API

• isWidgetType() 是否是控件类型 继承自QWidget类
• inherits(父类) 一个对象是否继承(直接或者间接)自某个类

应用场景

过滤筛选控件

案例

1.创建一个窗口, 包含多个QLabel或其他控件

要求

将包含在窗口内所有的QLabel控件, 设置背景色cyan
涉及知识点
子控件获取
控件类型判定
样式设置
掌握级别
掌握控件判定部分

对象删除

obj.deleteLater()

删除一个对象时, 也会解除它与父对象之间的关系 deleteLater()并没有将对象立即销毁,而是向主消息循环发送了一个event,下一次主消息循环收到这个event之后才会销毁对象 这样做的好处是可以在这些延迟删除的时间内完成一些操作,坏处就是内存释放会不及时

想要移除某一个对象的时候使用,bu同于python的del方法,会删除对象对应的子组件

事件处理

API

应用场景

• 事件机制
• 拦截事件, 监听特定行为

定时器

API

应用场景

• 轮询
• 倒计时

案例

1.创建一个窗口, 并设置一个子控件QLabel

要求

展示10s倒计时
倒计时结束, 就停止计时
涉及知识点
标签额创建和设置
自定义标签类的封装
定时器的使用
掌握级别
了解定时器基本操作

2.创建一个窗口, 通过定时器不断增加该窗口的尺寸大小

要求

每100ms 宽高均增加1px
涉及知识点
窗口控件的封装
定时器的使用
掌握级别
了解定时器

语言翻译

tr()

应用场景:多语言国际化支持

信号

QApplication

1
2

QApplication(self) -> None
QApplication(self, arg__1: Sequence[str]) -> None

在进行可视化编程时,无论出现几个窗口,都要创建一个而且只能创建一个QApplication类的实例对象,为窗口的正确显示提供基本的条件。

QApplication的实例对象代表整个运行程序,通过对QApplication实例对象的设置可以对整个应用程序进行设置。

QApplication类提供的方法如表所示,其中一些方法及参数在后续的内容中进行介绍。

需要注意的是,参数类型是以”Qt”开始的枚举类型时,需要用”from PySide6.QtCore import Qt”语句从 QtCore 模块中导入 Qt.例如 setEffectEnabled(Qt.UIEffect,enable=True)方法中,枚举类型Qt.UIEffect 是指 PySide6.QtCore.Qt中的枚举类型；Union[paral, para2…]是类型选择,表示可以从所列的类型中选择其中的一个数据类型作为参数。

QApplication方法一览

例子

下同下面的程序创建两个窗口,通过QApplication的实例对象app为整个程序设置标题栏上的名称和图标,在第2个窗口上单击”响铃与预警”按钮,将会发出响铃,并使第一个窗口在任务栏上闪烁。

image-20230225015948793

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44

import sys
from PySide6.QtWidgets import QApplication, QWidget, QLabel, QPushButton
from PySide6.QtCore import Qt
from PySide6.QtGui import QPixmap


class myWidget(QWidget):

    def __init__(self, parent=None):
        super().__init__(parent)
        self.setupui()

        self.button.clicked.connect(self.bell_alert)

    def setupui(self):
        self.setWindowTitle('Hello')
        self.resize(300, 150)

        self.label = QLabel(self)  # 在窗口上创建标签
        self.label.setText('欢迎学习pyside6编程！')
        self.label.setGeometry(80, 50, 150, 20)

        self.button = QPushButton(self)
        self.button.setText("响铃与预瞥")
        self.button.setGeometry(90, 100, 100, 20)

    def bell_alert(self):
        QApplication.beep()  # 程序发出响铃声
        QApplication.alert(win, duration=0)  # 第2个窗口发出预警


if __name__ == "__main__":
    app = QApplication(sys.argv)
    app.setApplicationDisplayName("欢迎程序")  # 设置所有窗口标题栏上显示的名称
    app.setEffectEnabled(Qt.UIEffect.UI_AnimateCombo)
    app.setWindowIcon(QPixmap(r'../../Resources/animal/m1.png'))  # 为所有窗口设置图标

    win = QWidget()  # 创建第1个窗口
    win.show()

    myWindow = myWidget()  # 用myWidget()创建第2个窗口
    myWindow.show()

    sys.exit(app.exec())

参数/单位类

坐标点类QPoint和QPointF

电脑屏幕的坐标系的原点在左上角,从左到右是x轴方向,从上往下是y轴方向。

要定位屏幕上的一个点的位置,需要用到QPoint类或QPointF类,这两个类的区别是QPoint用整数定义x和y值,QPointF用浮点数定义x和y值。

QPoint类和 QPointF类在QtCore 模块中,使用前需用from PySide6.QtCore import QPoint,QPointF语句导人到当前程序中。

用QPoint 和 QPointF 类定义坐标点实例的方法如下所示,其中xpos和ypos分别表示x和y坐标。

1
2
3
4
5
6
7
8
9
10

QPoint()
QPoint() -> None
QPoint(QPoint: PySide6.QtCore.QPoint) -> None
QPoint(xpos: int, ypos: int) -> None

QPointF()
QPointF() -> None
QPointF(QPointF: Union[PySide6.QtCore.QPointF, PySide6.QtCore.QPoint]) -> None
QPointF(p: PySide6.QtCore.QPoint) -> None
QPointF(xpos: float, ypos: float) -> None

QPoint 类和 QPointF 类的方法

QPoint或 QPointF 可以当作二维向量,用于加减运算,也可以与一个整数或浮点数相乘或相除,还可以逻辑判断,例如下面的代码。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20

from PySide6.QtCore import QPoint, QPointF

p1=QPoint(-3, 4)
p2=QPointF(5, 8)

print(QPoint.dotProduct(p1, p1), QPointF.dotProduct(p1, p2))

p3=p2 - p1

p4=p1 * 3

print(p3.x(), p3.y(), p4.x(), p4.y())
print(p1==p2, p1 !=p2)

"""
运算结果如下:
25 17.0
8.0 4.0 -9 12
False True
"""

尺寸类Qsize和QsizeF

一个控件或窗口有长度和高度属性,长度和高度可以用QSize类或QSizeF 类来定义

QSize 类和 QSizeF 类在 QtCore 模块中,使用前需用from PySide6.QtCore import QSize,QSizeF语句导人到当前程序中。

用QSize 和 QSizeF 定义尺寸实例的方法如下,其中w和h分别表示宽度或高度,QSize 用整数定义,QSizeF 用浮点数定义。

1
2
3
4
5
6
7
8
9
10
11

QSize():
QSize(self) -> None
QSize(QSize: PySide6.QtCore.QSize) -> None
QSize(w: int, h: int) -> None


QSizeF():
QSizeF(self) -> None
QSizeF(QSizeF: Union[PySide6.QtCore.QSizeF, PySide6.QtCore.QSize]) -> None
QSizeF(sz: PySide6.QtCore.QSize) -> None
QSizeF(w: float, h: float) -> None

QSize 和QSizeF 的方法基本相同

QSizeF的常用方法如表所示。

• 主要方法是用setWidth(float)、setHeight(float)设置宽度和高度；用width()、height()方法获取宽度和高度。
• scale(width:float, height: float,Qt.AspectRatioMode)方法中,Qt.AspectRatioMode 可以取以下:
  • Qt.IgnoreAspectRatio(不保持比例关系,缩放后的QSizeF尺寸(width,height))
  • Qt.KeepAspectRatio(保持原比例关系,缩放后的QSizeF 在(width,height)内部尽可能大)
  • Qt.KeepAspectRatioByExpanding(保持原比例关系,缩放后的QSizeF 在(width,height)外部尽可能小),参数值不同,返回的值也不同；
• shrunkBy(Union[QMargins,QMarinsF])方法中,根据页边距 QMargins或 QMarginsF指定的收缩距离,返回新的 QSizeF,QMargins 和 QMarginsF

QSize 和 QSizeF类也可以进行加减乘除运算和逻辑运算,例如下面的代码

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29

from PySide6.QtCore import QSize, QSizeF, QMargins, Qt

s1=QSize(5, 6)
s2=QSizeF(8, 10)

s3=s2 - s1
print("s3:", s3.width(), s3.height())

s4=s1
print("s4:", s4.width(), s4.height())

margin=QMargins(1, 2, 3, 4)
s5=s2.shrunkBy(margin)
print("s5:", s5.width(), s5.height())

s1=QSize(5, 6)
ss=s1.scaled(10, 20, Qt.AspectRatioMode.IgnoreAspectRatio)
print("IgnoreAspectRatio:", ss.width(), ss.height())

ss=s1.scaled(10, 20, Qt.AspectRatioMode.KeepAspectRatioByExpanding)
print("KeepAspectRatioByExpanding", ss.width(), ss.height())

"""
s3: 3.0 4.0
s4: 5 6
s5: 4.0 4.0
IgnoreAspectRatio: 10 20
KeepAspectRatioByExpanding 16 20
"""

矩形框类QRect和QRectF

矩形框类QRect和QRectF

矩形框可以定义一个矩形区域,含有 QPoint 和QSize 信息的类形的左上角是QPoint 的信息,矩形框的宽度和高度是 QSize 信息。对于一个控件,在窗口中有位置宽度和高度信息,控件的位置可以通过其左上角的位置确定,控件的位置、宽度和高度都可以通过矩形框类来定义。

矩形框类分为 QRect 和 QRectF 两种它们在 QtCore 块中使用前需要用from PySide6.QtCore import QRect, QRectF语句导人到当前程序中。

用QRect 或 QRectF 类来定义矩形框实例对象,可以采用以下几种方法,其中 QRect用整数定义,QRectF 用浮点数定义。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15

QRect:
QRect(self) -> None
QRect(QRect: PySide6.QtCore.QRect) -> None
QRect(left: int, top: int, width: int, height: int) -> None
QRect(topleft: PySide6.QtCore.QPoint, bottomright: PySide6.QtCore.QPoint) -> None
QRect(topleft: PySide6.QtCore.QPoint, size: PySide6.QtCore.QSize) -> None


QRectF:
QRectF(self) -> None
QRectF(QRectF: Union[PySide6.QtCore.QRectF, PySide6.QtCore.QRect]) -> None
QRectF(left: float, top: float, width: float, height: float) -> None
QRectF(rect: PySide6.QtCore.QRect) -> None
QRectF(topleft: Union[PySide6.QtCore.QPointF, PySide6.QtCore.QPoint], bottomRight: Union[PySide6.QtCore.QPointF, PySide6.QtCore.QPoint]) -> None
QRectF(topleft: Union[PySide6.QtCore.QPointF, PySide6.QtCore.QPoint], size: Union[PySide6.QtCore.QSizeF, PySide6.QtCore.QSize]) -> None

矩形框QRect类的常用方法如表所示:

用QRect或QRectF 定的矩形有4个角点 topLeft,topRight,bottomLeft、bottomRight,4 个边 left,right,top,bottom 和1 个中心 center 几何特征,通过一些方法可以获取或者移动角点位置、边位置或中心位置

用表中的方法获取右边线、底边线、右下角左下角和右上角的坐标值时,如下图所示,右下角的 x 值和值返回值比真实值都小1右边线和底边线比真实值都小1。

在算右下角的坐标时,可以用rect.x()十rect.width()"和"rect.y()十rect.height()语句到x和y坐标

image-20230213235023364

intersected()方法可以计算两个矩形的交矩形而united()方法可以计算两个矩形的矩形,它们的运算关系如图

image-20230213235216333

矩形框类常用于定义控件的左上角的位置和宽度、高度,例如下面的语句定义一个标签Label 的左上角坐标为(80,150),宽度是 100,高度是 20

1
2
3

label=QLabel(self)
rect=QRect(80, 150, 100, 20)
label.setGeometry(rect)

页边距类QMargins和QMarginsF

页边距类 QMargins 和 QMarginsF 通常应用于布局窗口和打印中,设置布局控件窗口内的工作区距边框的左边、顶部、右边和底部的距离,如图所示

在打印中设置打印区域距纸张四个边的距离。用布局或窗口的 setContentsMargins(QMargins)方法可设置页边距。

image-20230213235710525

使用前需要使用from PySide6.QtCore import QMargins, QMarginsF导入。

QMargins 定义的页边距是整数,QMarginsF 定义的页边距是浮点数(float)。用QMargins和QMarginsF 创建页边距对象的方法如下所示。

1
2
3
4
5
6
7
8
9
10
11
12

QMargins:
QMargins(self) -> None
QMargins(QMargins: PySide6.QtCore.QMargins) -> None
QMargins(left: int, top: int, right: int, bottom: int) -> None


QMarginsF:
QMarginsF(self) -> None
QMarginsF(QMarginsF: Union[PySide6.QtCore.QMarginsF, PySide6.QtCore.QMargins]) -> None
QMarginsF(left: float, top: float, right: float, bottom: float) -> None
QMarginsF(margins: PySide6.QtCore.QMargins) -> None

QMargins和QMarginsF 的方法基本相同QMarginsF 的常用方法下表所示,其中isNull()方法获取页边距是否为空,如果所有边距都接近0,则返回值是True。

字体类QFont类

字体类 QFont 可以设置界面控件上显示的字体,字体属性包括字体名称、字体尺寸粗体字、倾斜字、上/下划线、删除线等。

如果指定的字体在使用时没有对应的字体文件,Qt 将自动选择最接近的字体,如果要显示的字符在字体中不存在,则字符会被显示为一个空心方框。

字体类在QtGui模块中使用前需要用from PySide6.QtGui import QFont语句把字体类导人进来。用字体类定义字体实例对象的方法如下。

1
2
3
4
5

QFont(self) -> None
QFont(families: Sequence[str], pointSize: int=-1, weight: int=-1, italic: bool=False) -> None
QFont(family: str, pointSize: int=-1, weight: int=-1, italic: bool=False) -> None
QFont(font: Union[PySide6.QtGui.QFont, str, Sequence[str]]) -> None
QFont(font: Union[PySide6.QtGui.QFont, str, Sequence[str]], pd: PySide6.QtGui.QPaintDevice) -> None

参数:

• families 或 family 是字体名称;
• pointSize 是字体尺寸,取值为负值或0时,字体尺寸与系统有关,通常是12 点;
• weight 是字体粗细程度;
• italic 是斜体

字体类 QFont 的常用方法分为两种,一种是设置字体属性的方法,另一种是获取字体属性的方法。设置字体属性的方法名称以”set”开始不含 set 的方法是取字体的属性值字体类 QFont 的常用方法如表所示,主要方法介绍如下。

• 窗口上的各种控件及窗口都会有字体属性,通过控件或窗口的 font()方法可以获取字体,然后对获取的字体按照表所示的方法进行字体属性设置,设置完成后通过控件或窗口的 setFont(QFont)方法将设置好的字体重新赋给控件或窗口。当然也可以定义一个全新的字体对象,再通过控件或窗口的 setFont(QFont)方法将这个全新的字体赋给控件或窗口,可以用QApplication 的 setFont(QFont)方法为整个应用程序设置默认字体。
• 用setFamily(str)方法设置字体名称,名称中可以用逗号将多个字体名称隔开PySide6 自动根据逗号将名称分解成多个字体名称,也可以直接用setFamilies(Sequence[str])方法设置多个字体名称,第1个是主字体。需要注意的是字体名称的大小写敏感,当设置的字体名称不支持时,会自动搜索匹配的字体,当字体不支持文字符号时,文字符号用方框来表示
• setPixelSize(int)方法使用像素作为单位来设置字体大小。setPointSize(int)方法设置实际中我们肉眼看到的字体的大小,与像素无关。使用setPixelSize(int)方法设置字体尺寸时,在像素大小不同的设备上显示的大小也不同。使用setPointSize(int)方法设置的字体尺寸,在不同设备上显示的大小是相同的。如果指定了pointSize,则像素 pixelSize 尺寸的属性值是-1;反之,如果指定了 pixelSize,则pointSize属性值是-1。字体尺寸也可以用setPointSizeF(float)方法设置,其中参数是浮点数。
• 用setCapitalization(QFont, Capitalization)方法设置大小写方法,枚举类型 QFont.Capitalization 可以取 QFont.MixedCase、QFont, AllUppercase、QFontAllLowercase、QFont,SmallCaps 或 QFont,Capitalize(每个字的首字母大写)。
• 用setWeight(QFont,Weight)方法设置字体的粗细程度,举类型 QFontWeight可以取 QFont, Thin,QFont, ExtraLight,QFont, Light,QFont, Normal、QFont.Medium,QFont, DemiBold、QFont, Bold,QFont, ExtraBold 或 QFont, Black,对应值分别是 100、200、·· 900,字体由细到粗。
• 用setStyle(QFont,Style)方法设置字体的风格,举类型QFont.Style 可以取QFont, StyleNormal,QFont, Styleltalic 或 QFont, StyleOblique
• 用setStretchint()方法设置拉伸百分比,参数大于 100 表示拉长,小于100表示缩的短,参数也可以用枚举值(见下)设置。AnyStretch拉伸系数仅应用于轮廓字体。位图字体将忽略拉伸因子。
  • QFont.AnyStretch(值为0表示可匹配其他字体属性)标识可匹配其他字体的属性,它将接受任何拉伸因子,不会对字体应用任何变换。
  • QFont.UltraCondensed(值为 50)
  • QFont,ExtraCondensed(值为 62)
  • QFont.Condensed(值为 75)
  • QFont,SemiCondensed(值为87)
  • QFont,Unstretched(值为100)
  • QFont.SemiExpanded(值为 112)
  • QFont Expanded(值为 125)
  • QFont.ExtraExpanded(值为150)
  • QFont,UltraExpanded(值为 200)来
• 用setLetterSpacing(QFont,SpacingType,float)方法设置字符间隙,其中 QFont.SpacingType 可以取 QFont,PercentageSpacing(用百分比来表示,大于 100 增大间隙,小于 100 减小间隙)或 QFont.AbsoluteSpacing(用绝对值来表示正值增大间隙,负值减小间隙)。
• 用toString()方法将宇体的属性以宇符串形式输出,这样可以把字体属性保存到文件中。用fromString(str)方法从字符申获取字体属性。

下面的程序在窗口上创建10个标签控件(QLabel),分别给 10个标签设置不同的字体属性,同时给应用程序设置默认字体。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70

import sys
from PySide6.QtGui import QFont
from PySide6.QtWidgets import QApplication, QWidget, QLabel


class win_demo(QWidget):
    def __init__(self):
        super().__init__()
        self.set_wininit()

        self.fonts=list()
        self.labels=list()

        self.createFont()  # 调用函数
        self.createLabels()  # 调用函数
        self.getLabelFont()  # 调用函数

    def set_wininit(self):
        self.resize(800, 600)  # 设置窗口大小
        self.setWindowTitle("hello world")  # 设置窗口标题

    def createFont(self):  # 生成10个字体
        # 字体列表
        fontName=('宋体', '仿宋', '黑体', '楷体', '隶书', '幼圆', '华文中宋', '方正舒体', '华文黑体', 'Times New Roman')

        for i in range(10):
            f=QFont()
            f.setPointSizeF(25.5)
            f.setFamily(fontName[i])
            self.fonts.append(f)

        self.fonts[0].setBold(True)
        self.fonts[1].setItalic(True)
        self.fonts[2].setStrikeOut(True)
        self.fonts[3].setOverline(True)
        self.fonts[4].setUnderline(True)
        self.fonts[5].setCapitalization(QFont.AllUppercase)
        self.fonts[6].setWeight(QFont.Thin)
        self.fonts[7].setWordSpacing(50)
        self.fonts[8].setStretch(70)
        self.fonts[9].setPixelSize(50)

    def createLabels(self):
        string="Nice to Meet You!很高兴认识你！"

        for i in range(10):
            label=QLabel(self)  # 在窗口上创建标签控件
            label.setGeometry(0, 50 * i, 800, 70)  # 标签位置和尺寸
            label.setText(str(i) + ':' + string)  # 设置标签文字
            label.setFont(self.fonts[i])  # 设置标签文字的字体
            self.labels.append(label)

    def getLabelFont(self):  # 获取每个字体的信息
        # 标签列表
        print("字体信息:")
        template="Label{}: family:{}, Bold:{}, Italic:{}, StrikeOut:{}, OverLine:{}, UnderLine:{}, Capitalization:{}, Weight:{}, WordSpacing:{}, Stretch:{}, PixelSize:{}, pointSize:{}"
        j=0
        for i in self.labels:
            f=i.font()  # 获取标签的字体
            print(template.format(j, f.family(), f.bold(), f.italic(), f.strikeOut(), f.overline(), f.underline(), f.pointSize(), f.capitalization(), f.weight(), f.wordSpacing(), f.stretch(), f.pixelSize()))
            j +=1


if __name__=='__main__':
    app=QApplication(sys.argv)
    win=win_demo()

    win.show()
    sys.exit(app.exec())

image-20230214013905368

颜色类QColor

PySide6 的颜色类是 QColor,需要导入 from PySide6.QtGui import QColor,颜色可以用以下方法表示:

• RGB(红,red；绿,green；蓝,blue)值来定义,还可以用
• HSV(色相,hue；饱和度,saturation；值,value)值、
• CMYK(青色,cyan；品红,magenta:色,yellow；黑色,black)
• HSL(色相,hue；饱和度,saturation；亮度,lightness)值来定义

RGB 和 HSV 可以用于电脑屏幕的颜色显示,红绿蓝三种颜色的值都为 0255,值越大表示这种颜色的分量越大,HSV 中 H 的取值为0359,S 和 V的取值都为0~255,除了定义红绿蓝3种颜色成分外,通常还需要定义alpha通道值,表示颜色的透明度。alpha通道的取值也是0~255,值越大表示越不透明。

用QColor类定义颜色的方法如下所示,其中 QColor(name:str)中 name 是颜色名称例如’Blue’、Beige’、LightPink’。

• 颜色值还可以用RGB 字符串或ARGB字符串来定义RGB字符串格是”#RRGGBB”,

• ARGB字符串格式是”#AARRGGBB”其中 RRGG和BB 分别是用十六进制表示的红、绿、蓝颜色的值,AA 是 alpha 通道的值例如”#00ff0000”表示红色。

• QtCore.Qt.GlobalColor 是指 QtCore.Qt 中定义的一些颜色校举常量,

• Qt.GlobalColor 是枚举常量,可以取

  • Qt.white
  • Qt.black
  • Qt.red
  • Qt.darkRed
  • Qt.green
  • Qt.darkGreen
  • Qt.blue
  • Qt.darkBlue
  • Qt.cyan
  • Qt.darkCyan
  • Qt.magenta
  • Qt.darkMagenta
  • Qt.yellow
  • Qt.darkYellow
  • Qt.gray
  • Qt.darkGray
  • Qt.lightGray

  Qt.transparent(透明黑色)

  Qt.color0(0 像素值,只针对 QBitmap 图像)或 Qt.color1(1像素值,只针对 QBitmap图像)。

  QColor.Spec 是枚举类型,可以取 QColor.RgbQColor.Hsv,QColor.Cmyk.QColor.Hsl、QColor,ExtendedRgb 或 QColor,Invalid,QColor, ExtendedRgb 表示的颜色值取浮点数时可以x小于 0 或大于 1。

1
2
3
4
5
6
7
8

QColor(self) -> None
QColor(arg__1: Any) -> None
QColor(color: PySide6.QtCore.Qt.GlobalColor) -> None
QColor(name: str) -> None
QColor(r: int, g: int, b: int, a: int=255) -> None
QColor(rgb: int) -> None
QColor(rgba64: PySide6.QtGui.QRgba64) -> None
QColor(spec: PySide6.QtGui.QColor.Spec, a1: int, a2: int, a3: int, a4: int, a5: int=0) -> None

颜色类 QColor 的常用方法如表所示:

颜色类的方法中一种是名称以 set 开始的方法,为设置颜色相关值;另外一种名称没有 set 的是取颜色相关值,如 setRed(int)设置颜色的红色值,而 red()是获取颜色的红色值。

设置或获取颜色的相关值时,一种是用整数表示的值,另一种是用浮点数表示的值,用浮点数表示的值,取值范围是 0~1用setNamedColor(str)方法使用颜色名称或字符串来定义颜色,例如 setNamedColor(‘blue)setNamedColor(‘# 0012FF34’)。用name(format; QColor.NameFormat=QColor.HexRgb)方法获取字符串颜色,其中 QColor,NameFormat 是举值可以取 QColor.HexRgb 或 QColor HexArgb,返回的颜色字符申分别是#RRGGBB和#AARRGGBBQ。Color 类一般不直接定义控件的颜色,而是与调色板或画刷一起使用。

Qcolor的方法

RGB值与颜色名称的对应关系

调色板类QPalette

使用调色板需要先导入:from PySide6.QtGui import QPalette

调色板实例对象的创建方式如下所示

1
2
3
4
5
6
7
8

from PySide6.QtGui import QPalette
QPalette(self) -> None
QPalette(button: PySide6.QtCore.Qt.GlobalColor) -> None
QPalette(button: Union[PySide6.QtGui.QColor, PySide6.QtGui.QRgba64, Any, PySide6.QtCore.Qt.GlobalColor, str, int]) -> None
QPalette(button: Union[PySide6.QtGui.QColor, PySide6.QtGui.QRgba64, Any, PySide6.QtCore.Qt.GlobalColor, str, int], window: Union[PySide6.QtGui.QColor, PySide6.QtGui.QRgba64, Any, PySide6.QtCore.Qt.GlobalColor, str, int]) -> None
QPalette(palette: Union[PySide6.QtGui.QPalette, PySide6.QtCore.Qt.GlobalColor, PySide6.QtGui.QColor]) -> None
QPalette(windowText: Union[PySide6.QtGui.QBrush, PySide6.QtCore.Qt.BrushStyle, PySide6.QtCore.Qt.GlobalColor, PySide6.QtGui.QColor, PySide6.QtGui.QGradient, PySide6.QtGui.QImage, PySide6.QtGui.QPixmap], button: Union[PySide6.QtGui.QBrush, PySide6.QtCore.Qt.BrushStyle, PySide6.QtCore.Qt.GlobalColor, PySide6.QtGui.QColor, PySide6.QtGui.QGradient, PySide6.QtGui.QImage, PySide6.QtGui.QPixmap], light: Union[PySide6.QtGui.QBrush, PySide6.QtCore.Qt.BrushStyle, PySide6.QtCore.Qt.GlobalColor, PySide6.QtGui.QColor, PySide6.QtGui.QGradient, PySide6.QtGui.QImage, PySide6.QtGui.QPixmap], dark: Union[PySide6.QtGui.QBrush, PySide6.QtCore.Qt.BrushStyle, PySide6.QtCore.Qt.GlobalColor, PySide6.QtGui.QColor, PySide6.QtGui.QGradient, PySide6.QtGui.QImage, PySide6.QtGui.QPixmap], mid: Union[PySide6.QtGui.QBrush, PySide6.QtCore.Qt.BrushStyle, PySide6.QtCore.Qt.GlobalColor, PySide6.QtGui.QColor, PySide6.QtGui.QGradient, PySide6.QtGui.QImage, PySide6.QtGui.QPixmap], text: Union[PySide6.QtGui.QBrush, PySide6.QtCore.Qt.BrushStyle, PySide6.QtCore.Qt.GlobalColor, PySide6.QtGui.QColor, PySide6.QtGui.QGradient, PySide6.QtGui.QImage, PySide6.QtGui.QPixmap], bright_text: Union[PySide6.QtGui.QBrush, PySide6.QtCore.Qt.BrushStyle, PySide6.QtCore.Qt.GlobalColor, PySide6.QtGui.QColor, PySide6.QtGui.QGradient, PySide6.QtGui.QImage, PySide6.QtGui.QPixmap], base: Union[PySide6.QtGui.QBrush, PySide6.QtCore.Qt.BrushStyle, PySide6.QtCore.Qt.GlobalColor, PySide6.QtGui.QColor, PySide6.QtGui.QGradient, PySide6.QtGui.QImage, PySide6.QtGui.QPixmap], window: Union[PySide6.QtGui.QBrush, PySide6.QtCore.Qt.BrushStyle, PySide6.QtCore.Qt.GlobalColor, PySide6.QtGui.QColor, PySide6.QtGui.QGradient, PySide6.QtGui.QImage, PySide6.QtGui.QPixmap]) -> None
QPalette(windowText: Union[PySide6.QtGui.QColor, PySide6.QtGui.QRgba64, Any, PySide6.QtCore.Qt.GlobalColor, str, int], window: Union[PySide6.QtGui.QColor, PySide6.QtGui.QRgba64, Any, PySide6.QtCore.Qt.GlobalColor, str, int], light: Union[PySide6.QtGui.QColor, PySide6.QtGui.QRgba64, Any, PySide6.QtCore.Qt.GlobalColor, str, int], dark: Union[PySide6.QtGui.QColor, PySide6.QtGui.QRgba64, Any, PySide6.QtCore.Qt.GlobalColor, str, int], mid: Union[PySide6.QtGui.QColor, PySide6.QtGui.QRgba64, Any, PySide6.QtCore.Qt.GlobalColor, str, int], text: Union[PySide6.QtGui.QColor, PySide6.QtGui.QRgba64, Any, PySide6.QtCore.Qt.GlobalColor, str, int], base: Union[PySide6.QtGui.QColor, PySide6.QtGui.QRgba64, Any, PySide6.QtCore.Qt.GlobalColor, str, int]) -> None

颜色组ColorGroup,颜色角色ColorRole

PySide6中各种控件和窗口的颜色都由调色板类QPalette来定义,可以为窗体和窗体上的控件设置前景色、背景色,可以用palette()方法和 setPalette(QPalette)方法获取和设置窗体及控件的调色板,另外可以通过QApplication类的setPalette(QPalette)方法为整个应用程序设置默认的调色板。

QPalette类有两个基本的概念,一个是颜色组ColorGroup,另一个是颜色角色ColorRole。

颜色组ColorGroup 分为3种情况:

• 激活状态(Active,获得焦点)、
• 非激活状态(Inactive,失去焦点)
• 失效状态(Disabled,不可用),例如进行多窗口操作时.单击其中的一个窗口,可以在窗口中输人数据,则这个窗口是激活状态,其他窗口是非活跃状态。

当将一个控件的enable属性设置为False时(可通过 setEnabled(bool)方法设置),这个控件就处于失效状态,失效状态的控件不能接受任意输入,例如按钮不能单击、输人框中不能输人文字。对于一个控件,例如一个Label 标签或 PushButton按钮,可以设置其文字的颜色,也可以设置其背景颜色。

颜色角色ColorRole的作用是对控件或窗体的不同部分分别设置颜色。将ColorGroup 和ColorRole结合起来,可以为控件不同部分不同状态设置不同的颜色。

一个窗口由多个控件构成,可以用颜色角色为窗口和窗口中的控件定义不同的颜色角色。

PySide6 中颜色组由枚举常量 QPalettc.ColorGroup 确定,QPalette,ColorGroup 可取:

• QPalette.ColorGroup.Active激活,获得焦点
• QPalette.ColorGroup.Normal常规状态
• QPalette.ColorGroup.Inactive非激活,失去焦点
• QPalette.ColorGroup.Disabled失效状态 Disabled,禁用

颜色角色由枚举常量 QPalette.ColorRole确定, QPalette.ColorRole的枚举值如表所示。

可以用QColor,Qt.GlobalColor QBrush 或 QGradient 来定义有初始颜色的调色板,其中 QColor 和 Qt.GlobalColor 定义的颜色是纯颜色而 QBrush 和 QGradient 定义的颜色是可以渐变的。有关 QBrush 和 QGradient 的使用方法参 QPainter内容。

调色板类QPalctte 的常用方法

• 窗口上的各种控件及窗口都会有调色板属性,通过控件或窗口的 palette()方法可以获取调色板,然后对获取的调色板进行颜色设置,设置完成后通过控件或窗口的setPalette(QPalette)方法将设置好的调色板重新赋给控件或窗口,当然也可以定义一个全新的调色板对象,通过控件或窗口的 setPalette(QPalette)方法将这个全新的调色板赋予控件或窗口。
• 对控件或窗口的不同部分不同状态设置颜色需要用调色板的 setColor()方法或setBrush()方法。用brush()方法可以获得不同状态不同角色的画刷,过画刷的color()方法可以获得颜色 QColor 对象。
• 如果需要设置控件的背景色,应将背景色设置成自动填充模式,通过控件的方法setAutoFillBackground(True)来设置。对于按钮通常还需要关闭3D效果,通过按钮的 setFlat(True)来设定

实例:

image-20230214233504539

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58

import sys  # Demo2_4.Py
from PySide6.QtWidgets import QApplication, QWidget, QLabel
from PySide6.QtGui import QFont, QColor, QPalette
from random import randint, seed


class SetPalette(QWidget):
    def __init__(self, parent=None):
        super().__init__(parent)

        self.setGeometry(200, 200, 1200, 500)  # 设置窗口尺寸
        self.setWindowTitle("设置调色板实例")

        self.createLabels()  # 调用函数
        self.setLabelColor()  # 调用函数
        self.getLabelColorRGB()  # 调用函数

    def createLabels(self):
        self.labels=list()
        font=QFont("黑体", pointSize=20)
        string="Nice to meet you!很高兴认识你!"

        for i in range(10):
            label=QLabel(self)  # 在窗口上创建标签控件
            label.setGeometry(5, 50 * i, 1200, 40)  # 标签位置和尺寸
            label.setText(str(i) + ': ! + string)# 设置标签文字')
            label.setFont(font)
            # 设置标签文字的字体
            self.labels.append(label)  # 标签列表

    def setLabelColor(self):
        seed(12)
        for label in self.labels:
            colorBase=QColor(randint(0, 255), randint(0, 255), randint(0, 255))  # 定义颜色
            colorText=QColor(randint(0, 255), randint(0, 255), randint(0, 255))  # 定义颜色

            palette=label.palette()

            palette.setColor(QPalette.ColorGroup.Active, QPalette.ColorRole.Window, colorBase)  # 定义背景色
            palette.setColor(QPalette.ColorGroup.Active, QPalette.ColorRole.WindowText, colorText)  # 定景色
            label.setAutoFillBackground(True)  # 设置背景自动填充
            label.setPalette(palette)  # 设置调色板

    def getLabelColorRGB(self):  # 获取标签前景颜色和背景颜色 RGB 值
        for label in self.labels:
            r, g, b, a=label.palette().window().color().getRgb()  # 获取背景颜色的 RGB 值
            rT, gT, bT, a=label.palette().windowText().color().getRgb()  # 获取文字颜色的 RGB 值
            text=(label.text() + "背景颜色:{} {} {}; 文字颜色:{} {} {}").format(r, g, b, rT, gT, bT)
            label.setText(text)


if __name__=='__main__':
    app=QApplication(sys.argv)

    windows=SetPalette()
    windows.show()
    sys.exit(app.exec())

图像类

image-20230212181021306

PySide6的图像类有QImage、QPixmap、QPicture、QBitmap 四大类,这几个类都是从QPaintDevice类继承而来的,它们的继承关系如图所示。

• QPixmap 适合将图像显示在电脑屏幕上,可以使用QPixmap 在程序之中打开png、jpeg 等图像文件。QBitmap 是 QPixmap 的一个子类,它的色深限定为1,颜色只有黑白两种,用于制作光标QCursor 或画刷 QBrush 等。

• QImage 专门读取像素文件,其存储独立于硬件,是一种QPaintDevice设备,可以直接在QImage上用QPainter绘制图像,可以在另一个线程中对其进行绘制,而不需要在GUI线程中处理,使用这一方式可以很大幅度提高GUI响应速度。

  当图片较小时,可直接用QPixmap进行加载,当图片较大时用QPixmap加载会占很大的内存,这时用QImage进行加载会快一些,QImage 可以转成QPixmap。QPicture 是一个可以记录和重现QPainter命令的绘图设备,它还可以保存QPainter绘制的图形,QPicture 将QPainter的命令序列化到一个I0设备上,保存为一个平台独立的文件格式。

• QPicture与平台无关,可以用到多种设备之上,比如svg、pdf、ps、打印机或者屏幕。

QtGui.QPixmap

用QPixmap 类创建实例的方法如下,其中 wh 和QSize 指定图像的像索数(尺寸大小),str 是一个图像文件。

1
2
3
4
5
6
7
8

from PySide6.QtGui import QPixmap
QPixmap(self) -> None
QPixmap(arg__1: PySide6.QtCore.QSize) -> None
QPixmap(arg__1: Union[PySide6.QtGui.QPixmap, PySide6.QtGui.QImage, str]) -> None
QPixmap(fileName: Union[str, bytes, os.PathLike], format: Union[bytes, NoneType]=None, flags: PySide6.QtCore.Qt.ImageConversionFlag=Instance(Qt.AutoColor)) -> None
QPixmap(image: Union[PySide6.QtGui.QImage, str]) -> None
QPixmap(w: int, h: int) -> None
QPixmap(xpm: Iterable) -> None

QImage,QPixmap,QBitmap,QPicture 这4个类都有 load()和 save()方法,用于从文件中加载图片和保存图片;QImage 和 QPixmap 类有 fill()方法可以填充某种颜色的图形;QPixmap类的 tolmage()方法可以将 QPixmage 图像转换成 QImage图像

QPixmap类的常用方法如表所示其中用save(str,format=None,quality=-1)方法可以保存图像成功则返回True。其中str是保存的文件路径和文件名;format是文件类型,用字节串表示,支持的格式如表2-11所示如果是None,则根据文件的扩展名确定类型;quality的取值为0~100的整数取-1表示采用默认值,对于有损压缩的文件格式来说,它表示图像保存的质量,质量越低压缩率越大。用load(str,format=None,flags=Qt.AutoColor)方法可以从文件中加载图像,其中flags是QtImageConversionFlag的枚举类型表示颜色的转换模式可以取QtAutoColor(由系统自动决定)QtColorOnly(彩色模式)或Qt.MonoOnly(单色模式)用setMask(QBitmap)方法设置遮掩图,黑色区域显示,白色区域不显示

QPixmap类的常用方法

QPixmap 可以读写的文件格式

例子

下面的程序在窗口上创建一个 QLabel 标签和一个 QPushButton 按钮,单击QPushButton 按钮选择图像文件,用图像文件创建QPixmap 对象,然后在QLabel标签中显示QPixmap 图像

image-20230215002227914

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39

import sys
from PySide6.QtWidgets import QApplication, QWidget, QLabel, QVBoxLayout, QPushButton, QFileDialog
from PySide6.QtGui import QPixmap
from PySide6.QtCore import Qt


class MyPixmap(QWidget):
    def __init__(self, parent=None):
        super().__init__(parent)
        self.setGeometry(200, 200, 800, 500)  # 设置窗口尺寸
        self.setupUi()  # 调用函数建立界面

    def setupUi(self):  # 创建界面
        self.label=QLabel("单击按钮打开图像文件!")  # 创建标签
        self.label.setAlignment(Qt.AlignCenter)  # 中心对齐
        font=self.label.font()  # 获取字体
        font.setPointSize(10)  # 设置字体大小
        self.label.setFont(font)  # 给标签设置字体
        self.open_button=QPushButton("打开图像文件(&O)")  # 创建按钮
        self.open_button.setFont(font)  # 给按钮设置字体

        self.vertical_layout=QVBoxLayout(self)  # 在窗口上创建竖直布局
        self.vertical_layout.addWidget(self.label)  # 在布局中添加标签
        self.vertical_layout.addWidget(self.open_button)  # 在布局中添加按钮

        self.open_button.clicked.connect(self.open_button_clicked)  # 按钮信号与槽的连接

    def open_button_clicked(self):
        fileName, filter=QFileDialog.getOpenFileName(filter="图像文件(*.png *.bmp *.jpg *.jpeg);; 所有文件(* .*)")  # 打开对话框获取文件名
        pixmap=QPixmap(fileName)  # 创建 QPixmap 图像
        self.label.setPixmap(pixmap)  # 在标签中显示图像


if __name__=='__main__':
    app=QApplication(sys.argv)
    window=MyPixmap()
    window.show()
    sys.exit(app.exec())

QtGui.QImage

QImage 是绘图设备可以直接用QPainter 在 QImage 上绘制图像,QImage 可以直接操作图像上的像素。用QImage类创建实例的方法如下:

1
2
3
4
5
6
7
8
9
10
11
12

from PySide6.QtGui import QImage

QImage(self) -> None
QImage(arg__1: str, arg__2: int, arg__3: int, arg__4: PySide6.QtGui.QImage.Format) -> None
QImage(arg__1: str, arg__2: int, arg__3: int, arg__4: int, arg__5: PySide6.QtGui.QImage.Format) -> None
QImage(arg__1: Union[PySide6.QtGui.QImage, str]) -> None
QImage(data: bytes, width: int, height: int, bytesPerLine: int, format: PySide6.QtGui.QImage.Format, cleanupFunction: Union[Callable, NoneType]=None, cleanupInfo: Union[int, NoneType]=None) -> None
QImage(data: bytes, width: int, height: int, format: PySide6.QtGui.QImage.Format, cleanupFunction: Union[Callable, NoneType]=None, cleanupInfo: Union[int, NoneType]=None) -> None
QImage(fileName: Union[str, bytes, os.PathLike], format: Union[bytes, NoneType]=None) -> None
QImage(size: PySide6.QtCore.QSize, format: PySide6.QtGui.QImage.Format) -> None
QImage(width: int, height: int, format: PySide6.QtGui.QImage.Format) -> None
QImage(xpm: Iterable) -> None

其中,format是QImage Format 的枚举值,指定QImage 的图形文件的格式其常用取值如下表所示:

• QImage.Format_ARGB32 表示采用32位ARGB 格式存储(0xAARRGGBB)
• QImage.Format_ARGB8565_Premultiplied 表示采用24 位预乘ARGB格式存储(8-5-6-5)
• QImage.Format_Mono 表示每个像素用1位存储
• QImage.Format.RGB32 表示用32位 RGB 格式存储(0xfIRRGGBB)
• QImage.Format_RGB888 表示用24位RGB格式存储(8-8-8)。

因为涉及存储格式,因此这里需要对图像的类型作一些说明:

• 单色图像就是黑白图像,用1位存储一个像素的颜色。

• 8 位图像是指使用一个8 位的索引把图像存储到颜色表中,因此 8 位图像的每个像占据 8位1B)的存储空间每个像素的颜色与颜色表中某个索引的颜色相对应。颜色表使用QVector 存储 QRgb 类型颜色该类型包含一个0xAARRGGBB 格式的四元组数据。

• 32 位图像没有颜色表每个像素包含一个 QRgb 类型的值,共有 3 种类型的 32 位图像,分别是 RGB(即 0xfRRGGBB)ARGB和预乘 ARGB。

• 带 alpha 通道的图像有两种处理方法:

  一种是直接 alpha,另一种是预乘alpha。直接 alpha 图像的 RGB 数值是原始的数值,而预乘 alpha 图像的 RGB 数值是乘以alpha通道后得到的数值,比如ARGB=(a,rg;),预乘 alpha 的值为(a,a * r,a * g,a * b),PySide6 预乘 alpha 通道图像的算法是把红绿、蓝通道的数值乘以alpha 通道的数值再除以 255

QImage类的常用方法如表所示:

QImage 可以对图像的像素颜色进行深入操作

• 可以对图像的颜色 RGB 值进行翻转
• 可以获取每个像素点的 RGB 值
• 可以设置每个像素点的 RGB值,因此在获取一个像素点的 RGB 值后应对其进行处理。例如将 RGB三个值取原 RGB值的平均值,可以使图像灰度化;
• RGB值都增加或减少一个相同的值,可以使图像亮度增加或降低,但是注意不要超过 255 和低于 0;
• 用卷积计算可以进行锐化模糊化、调节色调等处理,
• 对图像像索颜色的操作与图像的格式有关,例如对单色和 8bit 图像,存储的是索引和颜色表;对32bit 图像,存储的是ARGB值。

QtGui.QBitmap

QBitmap 是只能存储黑白图像的位图,可以用于图标(QCursor)或画刷(QBrush)QBitmap可以从图像文件或 QPixmap 中转换过来,也可以用QPainter 来绘制用QBitmap类创建位图实例对象的方法如下,fileName是图像文件路径

1
2
3
4
5
6
7
8

from PySide6.QtGui import QBitmap

QBitmap(self) -> None
QBitmap(QBitmap: Union[PySide6.QtGui.QBitmap, str]) -> None
QBitmap(arg__1: PySide6.QtCore.QSize) -> None
QBitmap(arg__1: Union[PySide6.QtGui.QPixmap, PySide6.QtGui.QImage, str]) -> None
QBitmap(fileName: str, format: Union[bytes, NoneType]=None) -> None
QBitmap(w: int, h: int) -> None

QBitmap类继承自 QPixmap,因此具有 QPixmap 的方法

• QBitmap的 clear()方法可以清空图像内容
• transformed(QTransform)方法可以对位图进行转换,返回转换后的位图、参数 QTransform 的介绍参考 Qpainter绘图的内容:fromImage(QImage,flags=Qt.AutoColor)方法可以从 QImage 中创建位图并返回位图,其中参数 ags 是Qt.lmageConversionFlag 的枚举值,表示转换模式,可以取 Qt.AutoColor(由系统自动决定)或 QL,Mono0nly(单色模式)。

QtGui.QPicture

QPicture 是一个读写设备,用QPainter 可以直接在 QPicture 上绘图,并可以记录和重放QPainter 的绘图过程。QPicture 采用专用的二进制存储格式,独立于硬件,可以在任何设备上显示用QPicture 类创建图像实例的方法如下所示,其中 formatVersion 用于设置匹配更早版本的 Qt.-1表示当前版本。

1
2
3
4

from PySide6.QtGui import QPicture

QPicture(arg__1: Union[PySide6.QtGui.QPicture, int]) -> None
QPicture(formatVersion: int=-1) -> None

QPicture类的常用方法如表

图类的应用实例

下面的程序将窗口划分为 4 个区域,在每个区域中分别显示同一张图片,左上角显示QPixmap 图,右上角显示 QBitmap 图,左下角显示经过灰度处理的 Qlmage 图,右下角显示经过亮化处理的 QImage 图。这里用到了 QPainter 类,我们将在第6章详细介绍 QPainter类的使用方法。程序的运行结果如图所示。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83

# -*- coding: UTF-8 -*-
# File date: Hi_2023/2/28 21:13
# File_name: 01-图类的应用实例.py
import sys
from PySide6.QtWidgets import QApplication, QWidget
from PySide6.QtGui import QPainter, QPixmap, QBitmap, QImage, QColor
from PySide6.QtCore import QRect


class ShowPictures(QWidget):
    def __init__(self, parent=None):
        super().__init__(parent)
        self.setWindowTitle("绘图")
        self.pix = QPixmap()
        self.bit = QBitmap()
        self.image = QImage()

        self.pix.load("../../Resources/animal/m1.png")
        self.bit.load("../../Resources/animal/m2.png")
        self.image.load("../../Resources/animal/m3.png")

        # 下面创建两个 image 图像,分别存储灰度图和明亮图
        self.image_1 = QImage(self.image.width(), self.image.height(), QImage.Format.Format_ARGB32)
        self.image_2 = QImage(self.image.width(), self.image.height(), QImage.Format.Format_ARGB32)

        self.gray()  # 用灰度处理函数
        self.bright()  # 调用明亮处理函数

    def paintEvent(self, param):
        w = int(self.width() / 2)  # 窗口的一半宽度
        h = int(self.height() / 2)  # 窗口的一半高度

        # 创建4个矩形区域
        rect1 = QRect(0, 0, w - 2, h - 2)
        rect2 = QRect(w, 0, w - 2, h - 2)
        rect3 = QRect(0, h, w, h)
        rect4 = QRect(w, h, w, h)

        # 在4个矩形区域绘画
        painter = QPainter(self)
        painter.drawPixmap(rect1, self.pix)
        painter.drawPixmap(rect2, self.bit)
        painter.drawPixmap(rect3, self.image_1)
        painter.drawPixmap(rect4, self.image_2)

    def gray(self):
        color = QColor()
        for i in range(1, self.image_1.width() + 1):
            for j in range(1, self.image_1.height() + 1):
                alpha = self.image.pixelColor(i, j).alpha()
                r = self.image.pixelColor(i, j).red()
                g = self.image.pixelColor(i, j).green()
                b = self.image.pixelColor(i, j).blue()
                average = int((r + g + b) / 3)
                color.setRgb(average, average, average, alpha)
                self.image_1.setPixelColor(i, j, color)
        self.image_1.save("gray.jpg")

    def bright(self):
        color = QColor()
        delta = 50  # RGB 增加值
        for i in range(1, self.image_1.width() + 1):
            for j in range(1, self.image_1.height() + 1):
                alpha = self.image.pixelColor(i, j).alpha()
                r = self.image.pixelColor(i, j).red() + delta
                g = self.image.pixelColor(i, j).green() + delta
                b = self.image.pixelColor(i, j).blue() + delta

                r = 255 if r > 255 else r
                g = 255 if g > 255 else g
                b = 255 if b > 255 else b
                color.setRgb(r, g, b, alpha)
                self.image_2.setPixelColor(1, j, color)

        self.image_2.save("bright.jpg")


if __name__ == '__main__':
    app = QApplication(sys.argv)
    window = ShowPictures()
    window.show()
    sys.exit(app.exec())

图标类QIcon

为了增加界面的美观性,可以为窗口和按钮类添加图标。窗口和控件通常有 Normal.ActiveDisabled和Selected状态,有些控件,例如ORadio Button,还可以有on和off状态根据控件所处的不同状态,控件的图标也会有不同的显示效果

• Normal
• Active
• Disabled
• Selected

图标类是QIcon用QIcon类创建图标实例的方法如下。可以从QPixmap中创建也可以从一个图片文件中直接创建,另外还可以利用资源文件中的图片创建图标。当从QPixmap 创建图标时,系统会自动产生窗口不同状态下对应的图像,比如窗口在禁用状态下其图标为灰色;从文件构造图标时,文件并不是立刻加载,而是当图标要显示时才加载。

1
2
3
4
5
6

from PySide6.QtGui import QIcon
QIcon(self) -> None
QIcon(engine: PySide6.QtGui.QIconEngine) -> None
QIcon(fileName: str) -> None
QIcon(other: Union[PySide6.QtGui.QIcon, PySide6.QtGui.QPixmap]) -> None
QIcon(pixmap: Union[PySide6.QtGui.QPixmap, PySide6.QtGui.QImage, str]) -> None

QIcon类的主要方法是 addFile()和 addPixmap(),它们的格式为 addFile(fileName[size- QSize()[,mode=Normal[,state=ff]]])和 addPixmap(QPixmap[, modeNormal[,state=0ff]]),其中,mode 可以取 QIcon.Normal(未活)、QIcon.Active(激活)、QIcon.Disabled(禁用)和 QIcon, Seleted(选中),state 可以取 QIcon.On 和 QIcon.off.另外,QIcon的 pixmap()方法可以获取图标的图像,isNull()方法可以判断图标的图像是否是无像素图像。

通过窗口的 setWindowIcon(QIcon)方法或控件的 setIcon(QIcon)方法可以为窗口和控件设置图标,通过应用程序QApplication 的 setWindowIcon(QIcon)方法可以为整个应用程序设置图标,例如下面的程序。

image-20230215205606256

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29

# -*- coding: UTF-8 -*-
# File date: Hi_2023/2/28 21:15
# File_name: 01- 重写contextMenuEvent法.py
import sys
from PySide6.QtWidgets import QApplication, QWidget, QPushButton
from PySide6.QtGui import QPixmap, QIcon


class MyWidget(QWidget):
    def __init__(self, parent=None):
        super().__init__(parent)
        pix = QPixmap()
        pix.load("../../Resources/animal/m1.png")

        icon = QIcon(pix)  # 设置窗口图标
        self.setWindowIcon(icon)
        btn = QPushButton(self)
        btn.setIcon(icon)  # 设置按钮图标


if __name__ == '__main__':
    app = QApplication(sys.argv)
    # pix=QPixmap(":/icons/pic/student.png")
    # #icon=QIcon(pix)

    windows = MyWidget()
    windows.show()
    sys.exit(app.exec())

光标类QCursor

将光标移动到不同的控件上,并且控件在不同的状态下,可以为控件设置不同的光标形状。定义光标需要用到QtGui模块中的QCursor类。定义光标形状有两种方法,一种是用标准的形状 QtCursorShape,另一种是用自己定义的图片来定义。如果用自定义的图片来定义光标形状,需要设置光标的热点 hotx 和 hotY,hotX 和 hotY 的值是整数如果取负值则以图片中心点为热点,即 hotX=bitmap().width()/2,hotY=bitmap()height()/2。

用QCursor创建光标实例的方式如下,其中 Qt.CursorShape 设置标准的光标形状,mask参数是遮掩图像,可以用QPiyman的setMask(QPixman)方法提前给光标设置遮掩图。

如光标图像和掩图的颜色值都是 1,则结果是黑色;

如光标图像和图的颜值都是0,则结果是透明色;

如果光标图像的颜色值是 ,而掩图的颜色值 1,则结果是色。反之在 Windows 上是 XOR 运算的结果,其他系统上未定义

1
2
3
4
5
6

from PySide6.QtGui import QCursor
QCursor(self) -> None
QCursor(bitmap: Union[PySide6.QtGui.QBitmap, str], mask: Union[PySide6.QtGui.QBitmap, str], hotX: int=-1, hotY: int=-1) -> None
QCursor(cursor: Union[PySide6.QtGui.QCursor, PySide6.QtCore.Qt.CursorShape, PySide6.QtGui.QPixmap]) -> None
QCursor(pixmap: Union[PySide6.QtGui.QPixmap, PySide6.QtGui.QImage, str], hotX: int=-1, hotY: int=-1) -> None
QCursor(shape: PySide6.QtCore.Qt.CursorShape) -> None

标准的光标形状是Qt.CursorShape 的举值,Qt.CursorShape 的枚举值及光标形状如表所示。

通过窗口和控件的 setCursor()方法可以设置光标形状如 setCursorOCursor(Qt.PointingHandCursor))

参数	形状	参数	形状	参数	形状
Qt.ArrowCursor	image-20230205001240998	Qt.UpArrowCursor	image-20230205001255960	Qt.CrossCursor	image-20230205001307176
Qt.IBeamCursor	image-20230205001350176	Qt.WaitCursor	image-20230205001401876	Qt.BusyCursor	image-20230205001411942
Qt.ForbiddenCursor	image-20230205001422983	Qt.PointingHandCursor	image-20230205001437064	Qt.WhatsThisCursor	image-20230205001452317
Qt.SizeVerCursor	image-20230205001505884	Qt.SizeHorCursor	image-20230205001515383	Qt.SizeBDiagCursor	image-20230205001526173
Qt.SizeAllCursor	image-20230205001536781	Qt.SplitVCursor	image-20230205001544693	Qt.SplitHCursor	image-20230205001552120
Qt.OpenHandCursor	image-20230205001601361	Qt.ClosedHandCursor	image-20230205001610114	Qt.BlankCursor	不显示空白