1. PyQt5基础
1.1 GUI编程学什么
- 大致了解你所选择的GUI库
- 基本的程序的结构:使用这个GUI库来运行你的GUI程序
- 各种控件的特性和如何使用
- 控件的样式
- 资源的加载
- 控件的布局
- 事件和信号
- 动画特效
- 界面跳转
- 设计工具的使用
1.2 PyQT是什么
QT是跨平台C++库的集合,它实现高级API来访问现代桌面和移动系统的许多方面。这些服务包括定位和定位服务、多媒体、NFC和蓝牙连接、基于Chromium的web浏览器以及传统的UI开发。PyQt5是Qt v5的一组完整的Python绑定。它被实现为超过35个扩展模块,并使Python在所有支持的平台(包括IOS和Android)上被用作C++的替代应用程序开发语言。PyQT5也可以嵌入在基于C++的应用程序中,以允许这些应用程序的用户配置或增强这些应用程序的功能。
1.3 PyQT的优势
- 简单好用
- 功能强大
- 跨平台支持
- 性能高
- 文档齐全:PyQT本身就是对QT库Python的绑定,在绑定的时候保持了原有的QT库的API。也就是说,PyQT除了自己的文档外,也几乎可以通用QT文档。
- 稳定性高:面向对象、信号与槽的机制、界面设计与业务代码完全隔离
- 生态支持:QU Designer进行图形界面设计、ui转换成py文件、资源处理
- 开源免费:PyQT是双重许可的,开发人员可以在GPL和商业许可之间进行选择。采用GPL协议,软件著作权属于开发者本人所有,受国际相关版权法保护,允许其他用户对原作者软件进行复制和发行,也可以更改后发型自己的软件。
1.4 开发环境的安装
首先,基本的 Python3 环境和 PyCharm 开发工具的安装,由于比较简单,博主在这里不再详细演示了!实在有问题的可以自行Google或者百度。其次就是GUI开发环境的安装,也就是安装PyQT5。这里演示在Python的虚拟环境中来安装PyQT5(Ubuntu Linux系统):
# 在Python全局环境中安装pipenv $ pip3 install pipenv -i https://pypi.tuna.tsinghua.edu.cn/simple # 创建项目目录 $ mkdir pyqt5-pro # 进入项目目录 $ cd pyqt5-pro/ # 创建虚拟环境 $ pipenv --three # 激活虚拟环境(激活环境后会自动创建Pipfile文件) $ pipenv shell # 为加速安装,将源改为国内源 (pyqt5-pro) $ vim Pipfile url = "https://pypi.tuna.tsinghua.edu.cn/simple" # 安装pyqt5库 (pyqt5-pro) $ pipenv install pyqt5
这个时候我们使用Pycharm打开这个项目文件夹:
可以从设置中看到该项目依赖的Python环境:
1.5 第一个pyqt5桌面应用
示例代码:
from PyQt5.Qt import * import sys if __name__ == '__main__': # 创建QApplication类的实例 app = QApplication(sys.argv) # 创建一个窗口 window = QWidget() # 设置窗口标题 window.setWindowTitle('Hello World!') # 设置窗口尺寸 window.resize(400, 400) # 移动窗口位置 window.move(1000, 300) # 创建label控件 label = QLabel(window) # 为控件设置文本 label.setText('Hello World!') # 移动空间的位置 label.move(160, 160) # 显示窗口 window.show() # 进入程序的主循环,并通过exit函数确保主循环安全结束 sys.exit(app.exec_())
效果图[在windows平台中显示有差别于Linux(注意我这不是Mac OS系统,只是ubuntu linux系统使用了Mac OS的主题)]:
2. QtDesigner的使用
2.1 安装和配置
安装Qt的工具包:
pip install PyQt5-tools -i https://pypi.douban.com/simple
安装完成后,QTdesigner 就在你的 python 环境下的扩展包里面了!
将QtDesigner集成到Pycharm:
2.2 快速入门
可以通过配置好的PyCharm扩展工具直接打开QTDesigner:
简单介绍QTDesigner几个主要部分:
Ctrl+S后可以将其保存到项目根目录:
2.3 将ui文件转换成py文件
第一种方法:
$ python -m PyQt5.uic.pyuic demo.ui -o demo.py
第二种方法:
$ pyuic5 demo.ui -o demo.py
第三种方法:把第一种方法中命令集成到 PyCharm 中,首先需要使用 $ which python
查看当前使用的Python目录,
(pyqt5-pro) $ which python /home/thanlon/.local/share/virtualenvs/pyqt5-pro-ihgfaRRJ/bin/python
将其复制粘贴到【Program】部分。然后再把 -m PyQt5.uic.pyuic $FileName$ -o $FileNameWithoutExtension$.py
加入到【Arguments】部分。再把 $FileDir$
加入到【Working directory】中:
转换之后,在项目目录下会生成.py文件:
2.4 水平布局
使用水平布局的方式在QtDesigner中做一些简单的操作,如下图所示:
将.ui文件转换成.py文件后新建 RunMainWinHorizontalLayout.py
文件用来运行转换之后的.py文件 MainWinHorizontalLayout.py
:
import sys import MainWinHorizontalLayout from PyQt5.QtWidgets import QApplication, QMainWindow if __name__ == '__main__': # 创建QApplication类的实例 app = QApplication(sys.argv) # 创建一个主窗口 mainWindow = QMainWindow() # 创建Ui_MainWindow的实例 ui = MainWinHorizontalLayout.Ui_MainWindow() # 调用setupUi在指定窗口(主窗口)中添加控件 ui.setupUi(mainWindow) # 显示窗口 mainWindow.show() # 进入程序的主循环,并通过exit函数确保主循环安全结束 sys.exit(app.exec_())
运行这个Python文件得到:
2.5 垂直布局
使用垂直布局的方式在QtDesigner中了做一些简单的操作,如下图所示:
将.ui文件转换成.py文件后新建 RunMainWinVerticalLayout.py
文件用来运行转换之后的.py文件 MainWinVerticalLayout.py
:
import sys import MainWinVerticalLayout from PyQt5.QtWidgets import QApplication, QMainWindow if __name__ == '__main__': # 创建QApplication类的实例 app = QApplication(sys.argv) # 创建一个主窗口 mainWindow = QMainWindow() # 创建Ui_MainWindow的实例 ui = MainWinVerticalLayout.Ui_MainWindow() # 调用setupUi在指定窗口(主窗口)中添加控件 ui.setupUi(mainWindow) # 显示窗口 mainWindow.show() # 进入程序的主循环,并通过exit函数确保主循环安全结束 sys.exit(app.exec_())
运行这个.py文件得到:
2.6 同时使用水平布局和垂直布局
“姓名”和“薪资”两行都使用水平布局,“备注+文本框”和它们一起使用垂直布局:
将.ui文件转换成.py文件后新建 RunMainWinHVLayout.py
文件用来运行转换之后的.py文件:
import sys import RunMainWinVHLayout from PyQt5.QtWidgets import QApplication, QMainWindow if __name__ == '__main__': # 创建QApplication类的实例 app = QApplication(sys.argv) # 创建一个主窗口 mainWindow = QMainWindow() # 创建Ui_MainWindow的实例 ui = RunMainWinVHLayout.Ui_MainWindow() # 调用setupUi在指定窗口(主窗口)中添加控件 ui.setupUi(mainWindow) # 显示窗口 mainWindow.show() # 进入程序的主循环,并通过exit函数确保主循环安全结束 sys.exit(app.exec_())
2.7 栅格布局
下面是使用栅格布局设计的:
将.ui文件转换成.py文件后新建 RunMainWinGridLayout.py
文件用来运行转换之后的.py文件:
import sys import MainWinGridLayout from PyQt5.QtWidgets import QApplication, QMainWindow if __name__ == '__main__': # 创建QApplication类的实例 app = QApplication(sys.argv) # 创建一个主窗口 mainWindow = QMainWindow() # 创建Ui_MainWindow的实例 ui = MainWinGridLayout.Ui_MainWindow() # 调用setupUi在指定窗口(主窗口)中添加控件 ui.setupUi(mainWindow) # 显示窗口 mainWindow.show() # 进入程序的主循环,并通过exit函数确保主循环安全结束 sys.exit(app.exec_())
2.8 表单布局
下面是使用表单布局设计的:
将.ui文件转换成.py文件后新建 RunMainWinFormLayout.py
文件用来运行转换之后的.py文件:
import sys import MainWinFormLayout from PyQt5.QtWidgets import QApplication, QMainWindow if __name__ == '__main__': # 创建QApplication类的实例 app = QApplication(sys.argv) # 创建一个主窗口 mainWindow = QMainWindow() # 创建Ui_MainWindow的实例 ui = MainWinFormLayout.Ui_MainWindow() # 调用setupUi在指定窗口(主窗口)中添加控件 ui.setupUi(mainWindow) # 显示窗口 mainWindow.show() # 进入程序的主循环,并通过exit函数确保主循环安全结束 sys.exit(app.exec_())
右键选择布局的时候选择“在窗体布局中布局”。
2.9 容器布局
布局和容器之间可以相互转换,下面以 QFrame 和 Grid Layout 相互转换为例子。第一个是把容器 QFrame 转换成 Grid Layout,第二个是把 Grid Layout 转换成容器 QFrame:
将 .ui 文件转换成 .py 文件后新建 RunMainWinContainerLayout.py
文件用来运行转换之后的 .py 文件:
import sys from PyQt5.QtWidgets import QApplication, QMainWindow import MainWinContainerLayout if __name__ == '__main__': # 创建QApplication类的实例 app = QApplication(sys.argv) # 创建一个主窗口 mainWindow = QMainWindow() # 创建Ui_MainWindow的实例 ui = MainWinContainerLayout.Ui_MainWindow() # 调用setupUi在指定窗口(主窗口)中添加控件 ui.setupUi(mainWindow) # 显示窗口 mainWindow.show() # 进入程序的主循环,并通过exit函数确保主循环安全结束 sys.exit(app.exec_())
2.10 绝对布局
直接把空间放到容器或者窗口中默认是绝对布局,根据坐标属性可以控制显示的位置:
将 .ui 文件转换成 .py 文件后新建 RunMainWinAbsoluteLayout.py
文件用来运行转换之后的 .py 文件,发现出现报错:
/home/thanlon/PycharmProjects/venv/pyqt5-pro/bin/python /home/thanlon/PycharmProjects/pyqt5-pro/2.QtDesigner/绝对布局/RunMainWinHorizontalLayout.py
Traceback (most recent call last):
File "/home/thanlon/PycharmProjects/pyqt5-pro/2.QtDesigner/绝对布局/RunMainWinHorizontalLayout.py", line 2, in <module>
import MainWinAbsoluteLayout
File "/home/thanlon/PycharmProjects/pyqt5-pro/2.QtDesigner/绝对布局/MainWinAbsoluteLayout.py", line 75, in <module>
from PyQt5 import QtWebKitWidgets
ImportError: cannot import name 'QtWebKitWidgets' from 'PyQt5' (/home/thanlon/PycharmProjects/venv/pyqt5-pro/lib/python3.8/site-packages/PyQt5/__init__.py)
可以使用 from PyQt5.QtWebEngineWidgets import *
替换 from PyQt5 import QtWebKitWidgets
。
MainWinAbsoluteLayout.py:
# -*- coding: utf-8 -*- from PyQt5 import QtCore, QtGui, QtWidgets class Ui_MainWindow(object): def setupUi(self, MainWindow): ... # self.webView = QtWebKitWidgets.QWebView(self.centralwidget) self.webView = QWebEngineView(self.centralwidget) ... # from PyQt5 import QtWebKitWidgets from PyQt5.QtWebEngineWidgets import *
RunMainWinAbsoluteLayout.py:
import sys import MainWinAbsoluteLayout from PyQt5.QtWidgets import QApplication, QMainWindow if __name__ == '__main__': # 创建QApplication类的实例 app = QApplication(sys.argv) # 创建一个主窗口 mainWindow = QMainWindow() # 创建Ui_MainWindow的实例 ui = MainWinAbsoluteLayout.Ui_MainWindow() # 调用setupUi在指定窗口(主窗口)中添加控件 ui.setupUi(mainWindow) # 显示窗口 mainWindow.show() # 进入程序的主循环,并通过exit函数确保主循环安全结束 sys.exit(app.exec_())
2.11 布局中的间隔和分割线
间隔分为水平和垂直间隔,分别是 Horizontal Spacer 和 Vertical Spacer 两个控件。分割线也分为水平和垂直分割线,使用的控件分别是 Horizontal Line 和 Vertical Line。分割线控件可以让两个控件之间有一条分割线,通常用分割线控件将相同或类似功能的控件放在一起,形成一个组。
RunMainWinSpacerLineLayout.py:
import sys from PyQt5.QtWidgets import QApplication, QMainWindow import MainWinSpacerLineLayout if __name__ == '__main__': # 创建QApplication类的实例 app = QApplication(sys.argv) # 创建一个主窗口 mainWindow = QMainWindow() # 创建Ui_MainWindow的实例 ui = MainWinSpacerLineLayout.Ui_MainWindow() # 调用setupUi在指定窗口(主窗口)中添加控件 ui.setupUi(mainWindow) # 显示窗口 mainWindow.show() # 进入程序的主循环,并通过exit函数确保主循环安全结束 sys.exit(app.exec_())
2.12 控件最大尺寸和最小尺寸
控件最大尺寸和最小尺寸分别由控件的 minimunmSize 和 maximumSize 属性来设置的,
2.13 尺寸策略
每个控件都有期望尺寸,每一个控件的期望尺寸都是不一样的。未设置控件的最大值和最小值,推荐设置的尺寸,即建议尺寸。对大多数控件,期望尺寸是固定值,不能够去设置的。我们可以获取控件的期望尺寸:
RunMainWinSizePolicyLayout.py:
# -*- coding: utf-8 -*- from PyQt5 import QtCore, QtGui, QtWidgets class Ui_MainWindow(object): def setupUi(self, MainWindow): pass # 打印pushButton控件的期望尺寸 push_button_width = self.pushButton.sizeHint().width() push_button_height = self.pushButton.sizeHint().height() print('pushButton控件期望尺寸的宽度:{}px'.format(push_button_width)) print('pushButton控件期望尺寸的高度:{}px'.format(push_button_height)) """ pushButton控件期望尺寸的宽度:48px pushButton控件期望尺寸的高度:25px """ pass # 打印line_Edit控件的期望尺寸 line_Edit_width = self.lineEdit.sizeHint().width() line_Edit_height = self.lineEdit.sizeHint().height() print('lineEdit控件期望尺寸的宽度:{}px'.format(line_Edit_width)) print('lineEdit控件期望尺寸的高度:{}px'.format(line_Edit_height)) """ lineEdit控件期望尺寸的宽度:142px lineEdit控件期望尺寸的高度:25px """ pass def retranslateUi(self, MainWindow): pass
还有最小期望尺寸的概念,对于很多控件期望尺寸和最小期望尺寸是一样的,如 pushButton 控件:
# -*- coding: utf-8 -*- from PyQt5 import QtCore, QtGui, QtWidgets class Ui_MainWindow(object): def setupUi(self, MainWindow): pass # 打印pushButton控件的最小期望尺寸 push_button_minimum_width = self.pushButton.minimumSizeHint().width() push_button_minimum_height = self.pushButton.minimumSizeHint().height() print('pushButton控件最小期望尺寸的宽度:{}px'.format(push_button_minimum_width)) print('pushButton控件最小期望尺寸的高度:{}px'.format(push_button_minimum_height)) """ pushButton控件最小期望尺寸的宽度:48px pushButton控件最小期望尺寸的高度:25px """ pass def retranslateUi(self, MainWindow): pass
也有不一样的如 lineEdit 控件:
# -*- coding: utf-8 -*- from PyQt5 import QtCore, QtGui, QtWidgets class Ui_MainWindow(object): def setupUi(self, MainWindow): pass # 打印line_Edit控件的最小期望尺寸 line_Edit_minimum_width = self.lineEdit.minimumSizeHint().width() line_Edit_minimum_height = self.lineEdit.minimumSizeHint().height() print('lineEdit控件最小期望宽度:{}px'.format(line_Edit_minimum_width)) print('lineEdit控件最小期望高度:{}px'.format(line_Edit_minimum_height)) """ lineEdit控件最小期望宽度:59px lineEdit控件最小期望高度:25px """ pass def retranslateUi(self, MainWindow): pass
尺寸策略的应用,使用常用的属性值 Expanding:
RunMainWinExpendingLayout.py:
import sys from PyQt5.QtWidgets import QApplication, QMainWindow import MainWinExpandingLayout if __name__ == '__main__': # 创建QApplication类的实例 app = QApplication(sys.argv) # 创建一个主窗口 mainWindow = QMainWindow() # 创建Ui_MainWindow的实例 ui = MainWinExpandingLayout.Ui_MainWindow() # 调用setupUi在指定窗口(主窗口)中添加控件 ui.setupUi(mainWindow) # 显示窗口 mainWindow.show() # 进入程序的主循环,并通过exit函数确保主循环安全结束 sys.exit(app.exec_())
2.14 设置控件之间的伙伴关系
把两个控件关联到一起,通过其中一个控件控制另外一个控件。使用 Form Layout 布局在里面添加 Label 和 Line Edit 空间,
预览后同时按键盘中的 “ALT”和“A” 鼠标会定位到姓名的文本框中。同理,“ALT”和“B” 鼠标会定位到年龄的文本框中。
RunMainWinBuddyLayout.py:
import sys import MainWinBuddyLayout from PyQt5.QtWidgets import QApplication, QMainWindow if __name__ == '__main__': # 创建QApplication类的实例 app = QApplication(sys.argv) # 创建一个主窗口 mainWindow = QMainWindow() # 创建Ui_MainWindow的实例 ui = MainWinBuddyLayout.Ui_MainWindow() # 调用setupUi在指定窗口(主窗口)中添加控件 ui.setupUi(mainWindow) # 显示窗口 mainWindow.show() # 进入程序的主循环,并通过exit函数确保主循环安全结束 sys.exit(app.exec_())
2.15 修改控件的Tab顺序
控件布局好之后,如果是要求用户输入的控件,可以使用 Tab 键进行切换。实际上使用 Tab 键切换默认是按照控件添加顺序,当然还可以修改控件的 Tab 顺序。修改控件的 Tab 顺序有两种方法,方法一:选择 Edit --> 编辑 Tab 顺序:
双击序号可切换序号:
也可以选中序号,右键选择”制表符顺序列表“来调整顺序:
2.16 信号与槽的设置
信号(signal)与槽(slot)是 QT 的核心机制,也是 PyQt 的核心机制。信号:对象或者控件发出去的消息。单击一个按钮的时候按钮就会向外部发送单击的消息,这些发送出去的信号需要一些代码来拦截,这些代码就是槽。槽的本质是函数或方法,单击一个按钮其实就是执行了槽所对应的函数或方法,这个函数或方法本质上就相当于这个按钮的单击事件。
简单理解就是:信号就是一个单击事件,槽就是单击事件所对应的事件函数。一个信号可以和多个槽绑定,一个槽可以拦截多个信号。
下面使用 QtDesigner 来完成信号与槽的绑定:
选择编辑信号/槽,为 “关闭窗口” 按钮添加点击事件,槽为 close( ) 函数:
预览之后,点击按钮会关闭窗口:
例子1:控制文本输入框的显示和隐藏
预览后的效果:
例子2:控制文本输入框是否可用
预览后的效果:
2.17 添加菜单和工具栏
使用 QtDesigner 创建一个主窗口时,默认会在主窗口的上方添加一行菜单栏,在最下方添加一行状态栏。如果我们需要添加工具栏则需要单击右键选择【添加工具栏】,这部分主要探讨如何在窗口中创建菜单和工具栏以及分别向菜单栏、工具栏中添加菜单项、按钮。
默认菜单已经创建,所以只需要为菜单添加菜单项:
创建工具栏并且将按钮添加到工具栏中:
3. PyQt5核心API的使用
3.1 创建主窗口
有三种类型的窗口,分别是 QMainWindow、QDialog 和 QWidget。QMainWindow:可以包括菜单栏、工具栏、状态栏和标题栏,是最常见的窗口形式。QDialog:是对话窗口的基类。没有菜单栏、工具栏、标题栏。QWidget:不确定窗口的类型,就可以使用 QWidget。创建一个主窗口:
FirstMainWindow.py:
""" @from:https://pythoneers.cn @author: qq3330447288 @contact: erics1996@yeah.net @software: PyCharm @file: FirstMainWindow.py @time: 2020/11/17 上午9:50 """ import sys from PyQt5.QtWidgets import QMainWindow, QApplication from PyQt5.QtGui import QIcon class FirstMainWin(QMainWindow): def __init__(self): """ 初始化 :param parent:控件放到parent """ super(FirstMainWin, self).__init__() # 设置主窗口的标题 self.setWindowTitle('第一个窗口应用') # 设置窗口的尺寸 self.resize(400, 300) # 获取当前的状态栏(默认是有状态栏的) self.status = self.statusBar() # 设置状态栏显示的消息(消息只存在5s) self.status.showMessage('只显示5s的消息!', 5000) if __name__ == '__main__': # 创建一个应用程序对象(传入参数) app = QApplication(sys.argv) # 设置应用程序的图标 app.setWindowIcon(QIcon('../images/Dragon.ico')) # 创建窗口类的对象 main = FirstMainWin() # 显示窗口 main.show() # 调用exit()进入程序的主循环 sys.exit(app.exec_())
3.2 主窗口居中显示
PyQt5中没有API直接让窗口居中,所以需要自己去写。主窗口居中显示需要计算窗口的左上角的坐标值,横坐标可以通过屏幕的宽度减去窗口的宽度除以2,纵坐标可以通过屏幕的高度减去窗口的高度除以2。完成计算后可以使用move方法移动窗口。
CenterWindow.py:
""" @from:https://pythoneers.cn @author: qq3330447288 @contact: erics1996@yeah.net @software: PyCharm @file: FirstMainWindow.py @time: 2020/11/17 上午9:50 """ import sys from PyQt5.QtWidgets import QMainWindow, QApplication, QDesktopWidget from PyQt5.QtGui import QIcon class CenterMainWin(QMainWindow): def __init__(self): """ 初始化 :param parent:控件放到parent """ super(CenterMainWin, self).__init__() # 设置主窗口的标题 self.setWindowTitle('窗口居中') # 设置窗口的尺寸 self.resize(400, 300) # 获取当前的状态栏(默认是有状态栏的) self.status = self.statusBar() # 设置状态栏显示的消息(消息只存在5s) self.status.showMessage('只显示5s的消息!', 5000) def center(self): # 获取屏幕坐标系 screen = QDesktopWidget().screenGeometry() # 获取窗口坐标系 size = self.geometry() left = (screen.width() - size.width()) / 2 top = (screen.height() - size.height()) / 2 # 移动窗口 self.move(left, top) if __name__ == '__main__': # 创建一个应用程序对象(传入参数) app = QApplication(sys.argv) # 设置应用程序的图标 app.setWindowIcon(QIcon('../images/Dragon.ico')) # 创建窗口类的对象 main = CenterMainWin() # 显示窗口 main.show() # 窗口居中 main.center() # 调用exit()进入程序的主循环 sys.exit(app.exec_())
3.3 退出应用程序
退出应用程序,即退出整个窗口,
QuitApplication.py:
""" @from:https://pythoneers.cn @author: qq3330447288 @contact: erics1996@yeah.net @software: PyCharm @file: QuitApplication.py @time: 2020/11/17 上午10:48 """ import sys from PyQt5.QtWidgets import QMainWindow, QPushButton, QHBoxLayout, QWidget, QApplication class QuitApplication(QMainWindow): def __init__(self): super(QuitApplication, self).__init__() self.resize(300, 150) self.setWindowTitle('退出应用程序') # 添加按钮 self.buttion1 = QPushButton('退出应用程序') # 将信号与槽关联。信号绑定到方法,每一个信号都有一个connect方法 self.buttion1.clicked.connect(self.onClickButton) # 设置水平布局(将按钮放到布局中) layout = QHBoxLayout() layout.addWidget(self.buttion1) # 把布局放到QWidget(所有的控件都放到Qwiget,Qwiget可以充满整个窗口) main_frame = QWidget() main_frame.setLayout(layout) # 框架放到窗口上 self.setCentralWidget(main_frame) def onClickButton(self): # 通过sender获取button sender = self.sender() # 获取button的文本 print(sender.text() + ' 按钮被按下!') # 创建应用程序对象 app = QApplication.instance() # 退出应用程序 app.quit() if __name__ == '__main__': app = QApplication(sys.argv) main = QuitApplication() main.show() sys.exit(app.exec_())
3.4 屏幕坐标系
窗口的位置可以通过窗口的左上角的坐标来描述,这个坐标就是相对于屏幕坐标系。我们可以获取窗口相关的一系列参数:
""" @from:https://pythoneers.cn @author: qq3330447288 @contact: erics1996@yeah.net @software: PyCharm @file: ScreenGeometry.py @time: 2020/11/17 上午11:15 """ import sys from PyQt5.QtWidgets import QApplication, QWidget, QPushButton def on_click_btn(): """ 单击button打印窗口的坐标和宽度和高度 :return: """ print('onclick') print('------1------') print('widget.x() = %d' % widget.x()) # 窗口横坐标 print('widget.y() = %d' % widget.y()) # 窗口纵坐标 print('widget.width() = %d' % widget.width()) # 工作区宽度 print('widget.height() = %d' % widget.height()) # 工作去高度 print('------2------') print('widget.geometry().x() = %d' % widget.geometry().x()) # 工作区横坐标 print('widget.geometry().y() = %d' % widget.geometry().y()) # 工作区纵坐标 print('widget.geometry().width() = %d' % widget.geometry().width()) # 工作区宽度 print('widget.geometry().height() = %d' % widget.geometry().height()) # 工作区高度 print('------3------') print('widget.geometry().x() = %d' % widget.frameGeometry().x()) # 窗口横坐标 print('widget.geometry().y() = %d' % widget.frameGeometry().y()) # 窗口纵坐标 print('widget.geometry().width() = %d' % widget.frameGeometry().width()) # 窗口宽度 print('widget.geometry().height() = %d' % widget.frameGeometry().height()) # 窗口高度(包括标题栏) if __name__ == '__main__': app = QApplication(sys.argv) # 使用Qwigit创建窗口 widget = QWidget() # 在窗口放按钮 btn = QPushButton(widget) # 设置按钮的文本 btn.setText('按钮') # 设置按钮相对于窗口(工作区)的位置 btn.move(10, 10) # 绑定槽 btn.clicked.connect(on_click_btn) # 设置工作区的尺寸 widget.resize(300, 300) # 设置窗口的坐标(对于屏幕的位置) widget.move(200, 200) # 设置窗口标题栏文字 widget.setWindowTitle('屏幕坐标系') # 显示窗口 widget.show() # 进入事件循环 sys.exit(app.exec_())
窗口相对于坐标系的位置和尺寸,侧面可以得到标题栏的高度是31px。
3.5 设置窗口和应用程序图标
使用 setWindowIcon 方法来设置图标,窗口的 setWindowIcon 方法用于设置窗口的图标,只在 Windows 中可用,只能在标题栏左上角显示图标。QApplication 中的 setWindowIcon 方法可以用来设置主窗口的图标和应用程序的图标,但是如果主窗口已经设置了的图标,这里只能用于设置应用程序的图标。
""" @from:https://pythoneers.cn @author: qq3330447288 @contact: erics1996@yeah.net @software: PyCharm @file: WinAndApplicationIcon.py.py @time: 2020/11/17 上午11:33 """ import sys from PyQt5.QtWidgets import QMainWindow, QApplication from PyQt5.QtGui import QIcon class WinAndApplicationIcon(QMainWindow): def __init__(self): super(WinAndApplicationIcon, self).__init__() self.init_ui() def init_ui(self): # 设置主窗口的标题 self.setWindowTitle('设置窗口图标') # 同时设置主窗口的尺寸和位置 self.setGeometry(400, 400, 300, 200) # 设置窗口图标 self.setWindowIcon(QIcon('../images/Basilisk.ico')) if __name__ == '__main__': # 创建一个应用程序对象(传入参数) app = QApplication(sys.argv) # 设置应用程序的图标 app.setWindowIcon(QIcon('../images/Dragon.ico')) # 可以用来设置主窗口的图标和应用程序的图标,但是如果主窗口已经设置了的图标,这里只能用于设置应用程序的图标 # 创建窗口类的对象 main = WinAndApplicationIcon() # 显示窗口 main.show() # 调用exit()进入程序的主循环 sys.exit(app.exec_())
3.6 控件添加提示消息
当鼠标放在控件上的时候,可以显示提示消息。使用 setToolTip 方法设置的消息内容支持富文本。
""" @from:https://pythoneers.cn @author: qq3330447288 @contact: erics1996@yeah.net @software: PyCharm @file: ToolTip.py @time: 2020/11/17 上午11:39 """ import sys from PyQt5.QtGui import QFont from PyQt5.QtWidgets import QMainWindow, QToolTip, QHBoxLayout, QWidget, QPushButton, QApplication class ToolTip(QMainWindow): def __init__(self): super(ToolTip, self).__init__() self.init_ui() def init_ui(self): QToolTip.setFont(QFont('SansSerif', 12)) self.setToolTip('你好,<b>Erics</b>') self.setGeometry(300, 300, 300, 150) self.setWindowTitle('设置控件提示消息') self.button1 = QPushButton('按钮') self.button1.setToolTip('这是一个按钮!') layout = QHBoxLayout() layout.addWidget(self.button1) main_frame = QWidget() main_frame.setLayout(layout) self.setCentralWidget(main_frame) if __name__ == '__main__': app = QApplication(sys.argv) tool_tip = ToolTip() tool_tip.show() sys.exit(app.exec_())
4. PyQt5中常用控件API的使用
4.1 QLabel控件的基本用法
QLabel 控件是用来显示文本信息的,QLabel 控件相关的方法如下:
方法名
说明
setAlignment()
设置文本的对齐方式
setIndent()
设置文本缩进
text()
获取文本内容
setBuddy()
设置伙伴关系
setText()
设置文本内容
selectedText()
返回所选的字符
setWordWrap()
设置是否允许换行
QLabel 控件常用的信号(事件)
信号
说明
linkHoverd
当鼠标滑过QLabel控件时触发
linkActivated
当鼠标单击QLabel控件时触发
""" @from:https://pythoneers.cn @author: qq3330447288 @contact: erics1996@yeah.net @software: PyCharm @file: QLabelDemo.py @time: 2020/11/17 下午5:56 """ import sys from PyQt5.QtGui import QPalette, QPixmap from PyQt5.QtCore import Qt from PyQt5.QtWidgets import QWidget, QLabel, QVBoxLayout, QApplication class QLabelDemo(QWidget): def __init__(self): super().__init__() # 初始化窗口界面 self.init_ui() def init_ui(self): # 创建4个QLabel控件 label1 = QLabel(self) label2 = QLabel(self) label3 = QLabel(self) label4 = QLabel(self) # 设置label1文本(支持html标签) label1.setText('<font color="orange">这是一个文本标签</font>') # 创建调色板 palette = QPalette() palette.setColor(QPalette.Window, Qt.blue) # 设置控件的背景色 # 设置label1使用创建的调色板(设置label1控件的背景色) label1.setPalette(palette) # 设置label1自动填充背景 label1.setAutoFillBackground(True) # 设置label1居中对齐 label1.setAlignment(Qt.AlignCenter) # 设置label2的文本 label2.setText('<a href="#">欢迎你使用Python GUI程序!</a>') # 跳转网页或者是点击事件 # 设置label2文本居中 label3.setAlignment(Qt.AlignCenter) # 设置提示信息 label3.setToolTip('这是一个图片标签!') # 设置标签下显示图片 label3.setPixmap(QPixmap('../images/python.jpg')) # 设置label4的文本 label4.setText('<a href="https://pythoneers.cn">感谢您访问我的网站!</a>') # 屏蔽事件(点击之后打开网页,而不是触发事件) label4.setOpenExternalLinks(True) # False是响应事件 # 设置label4右对齐 label4.setAlignment(Qt.AlignRight) # 设置提示信息 label4.setToolTip('这是一个超链接!') # 创建垂直布局对象 vbox = QVBoxLayout() # 将label1、label2、label2、label3控件添加到布局中 vbox.addWidget(label1) vbox.addWidget(label2) vbox.addWidget(label3) vbox.addWidget(label4) # 滑过label2标签的信号绑定到槽(函数) label2.linkHovered.connect(self.linkHovered) # 点击label4标签的信号绑定槽(函数) label4.linkActivated.connect(self.linkClicked) # 设置窗口的布局 self.setLayout(vbox) # 设置窗口标题 self.setWindowTitle('QLabel控件演示') def linkHovered(self): """ 当鼠标划过标签label2时触发事件 :return: """ print('当鼠标划过标签label2时触发事件') def linkClicked(self): """ 当鼠标单击标签label4时触发事件 :return: """ print('当鼠标单击标签label4时触发事件') if __name__ == '__main__': app = QApplication(sys.argv) mainWindow = QLabelDemo() mainWindow.show() sys.exit(app.exec_())
4.2 QLabel与伙伴控件
这里使用代码设置伙伴控件如下:
QLabelBuddy.py:
""" @from:https://pythoneers.cn @author: qq3330447288 @contact: erics1996@yeah.net @software: PyCharm @file: QLabelBuddy.py @time: 2020/11/17 下午6:26 """ import sys from PyQt5.QtWidgets import QDialog, QLabel, QLineEdit, QPushButton, QGridLayout, QApplication class QLabelBuddy(QDialog): def __init__(self): super().__init__() # 初始化实例的时候执行 self.init_ui() def init_ui(self): # 设置窗口标题栏文本 self.setWindowTitle('QLabel与伙伴控件') # 创建QLabel控件 nameQLabel = QLabel('&Name', self) # 创建QLineEdit控件 nameQLineEdit = QLineEdit(self) # 设置伙伴控件 nameQLabel.setBuddy(nameQLineEdit) # 创建QLabel控件 passwordQLabel = QLabel('&Pwd', self) # 创建QLineEdit控件 passwordQLineEdit = QLineEdit(self) # 设置伙伴控件 passwordQLabel.setBuddy(passwordQLineEdit) ok_btn = QPushButton('&OK') cancel_btn = QPushButton('&Cancel') # 创建栅格布局 mainLayout = QGridLayout(self) # 将nameQLabel添加到栅格布局中 mainLayout.addWidget(nameQLabel, 0, 0) # 将nameQLineEdit添加到栅格布局中 mainLayout.addWidget(nameQLineEdit, 0, 1, 1, 2) # 将passwordQLabel添加到栅格布局中 mainLayout.addWidget(passwordQLabel, 1, 0) # 将passwordQLineEdit添加到栅格布局中 mainLayout.addWidget(passwordQLineEdit, 1, 1, 1, 2) # 将ok_btn添加到布局中 mainLayout.addWidget(ok_btn, 2, 1) # 将cancel_btn添加到布局中 mainLayout.addWidget(cancel_btn, 2, 2) """ 行索引rowIndex和列索引columnIndex是控件在栅格布局中位置,占用的行数row和占用的列数column是控件的尺寸 mainLayout.addWidget(控件对象, 行索引rowIndex, 列索引columnIndex, 占用的行数row, 占用的列数column) """ if __name__ == '__main__': app = QApplication(sys.argv) QLabel_Buddy = QLabelBuddy() QLabel_Buddy.show() sys.exit(app.exec_())
4.3 QLineEdit控件与回显模式
QLineEdit 控件的基本功能是输入单行文本,这个控件还有其它高级内容,如设置回显模式、掩码。回显有4种模式:
- Normal:正常显示输入的内容(正常回显)
- NoEcho:不显示任何内容(不回显)
- Password:输入内容被点替代(回显但显示的是点)
- PasswordEchoEdit:输入的过程中正常回显,当光标离开输入框则显示的是点
QLineEditEchoMode.py
:
""" @from:https://pythoneers.cn @author: qq3330447288 @contact: erics1996@yeah.net @software: PyCharm @file: QLineEditEchoMode.py @time: 2020/11/24 上午4:06 """ import sys from PyQt5.QtWidgets import QWidget, QFormLayout, QLineEdit, QApplication class QLineEditEchoMode(QWidget): def __init__(self): super(QLineEditEchoMode, self).__init__() self.initUI() def initUI(self): self.setWindowTitle('文本输入框的回显模式') # 创建表单布局对象 formLayout = QFormLayout() # 创建四个LineEdit控件 normalLineEdit = QLineEdit() noEchoLineEdit = QLineEdit() passwordLineEdit = QLineEdit() passwordEchoOnEdit = QLineEdit() # 将空间添加到布局中 formLayout.addRow('Normal', normalLineEdit) formLayout.addRow('NoEcho', noEchoLineEdit) formLayout.addRow('Password', passwordLineEdit) formLayout.addRow('PasswordEchoEdit', passwordEchoOnEdit) # 设置默认的文本提示内容(类似于设置HTML表单中的Placeholder属性) normalLineEdit.setPlaceholderText('Normal') noEchoLineEdit.setPlaceholderText('NoEcho') passwordLineEdit.setPlaceholderText('Password') passwordEchoOnEdit.setPlaceholderText('PasswordEchoOnEdit') # 设置回显模式 normalLineEdit.setEchoMode(QLineEdit.Normal) noEchoLineEdit.setEchoMode(QLineEdit.NoEcho) passwordLineEdit.setEchoMode(QLineEdit.Password) passwordEchoOnEdit.setEchoMode(QLineEdit.PasswordEchoOnEdit) # 应用表单布局 self.setLayout(formLayout) if __name__ == '__main__': app = QApplication(sys.argv) main = QLineEditEchoMode() main.show() sys.exit(app.exec_())
4.4 QLineEdit控件的校验器
通过校验器可以限制文本输入控件的输入,如限制只能输入整数、浮点数或满足一定条件的字符串。
QLineEditEchoMode.py:
""" @from:https://pythoneers.cn @author: qq3330447288 @contact: erics1996@yeah.net @software: PyCharm @file: QLineEditValidator.py @time: 2020/11/24 上午5:14 """ from PyQt5.QtWidgets import QWidget, QFormLayout, QLineEdit, QApplication from PyQt5.QtGui import QIntValidator, QDoubleValidator, QRegExpValidator from PyQt5.QtCore import QRegExp # 引入正则表达式的类 import sys class QLineEditValidator(QWidget): def __init__(self): super(QLineEditValidator, self).__init__() self.initUI() def initUI(self): self.setWindowTitle('QLineEdit控件的校验器') # 创建表单布局对象 formLayout = QFormLayout() # 创建三个QLineEdit控件 intLineEdit = QLineEdit() doubleLineEdit = QLineEdit() validatorLineEdit = QLineEdit() # 将控件添加到布局中 formLayout.addRow('整数类型', intLineEdit) formLayout.addRow('浮点类型', doubleLineEdit) formLayout.addRow('字母和数字(正则表达式)', validatorLineEdit) # 为QLineEdit控添默认提示内容 intLineEdit.setPlaceholderText('整数') doubleLineEdit.setPlaceholderText('浮点') validatorLineEdit.setPlaceholderText('字母和数字') """ 1.设置整数校验器(只能输入[1,99]之间的整数) """ # 创建QDoubleValidator校验器对象 intValidator = QIntValidator(self) # 设置校验范围 intValidator.setRange(1, 99) """ 2.设置浮点校验器(只能输入[-99.xx,99.xx],精度要求保留小数点后2位) """ # 创建QDoubleValidator校验器对象 doubleValidator = QDoubleValidator(self) # 设置校验范围 doubleValidator.setRange(-99, 99) # 正常显示浮点数 doubleValidator.setNotation(QDoubleValidator.StandardNotation) # 设置精度,保留小数点后两位 doubleValidator.setDecimals(2) """ 3.设置字母和数字(正则表达式)校验器 """ # 正则表达式 reg = QRegExp('[a-zA-Z0-9]+$') # 正则表达式校验器 validator = QRegExpValidator(self) # 将正则表达式和正则表达式校验器绑定到一起 validator.setRegExp(reg) """ 设置校验器:绑定校验器和控件 """ intLineEdit.setValidator(intValidator) doubleLineEdit.setValidator(doubleValidator) validatorLineEdit.setValidator(validator) # 应用表单布局 self.setLayout(formLayout) if __name__ == '__main__': app = QApplication(sys.argv) main = QLineEditValidator() main.show() sys.exit(app.exec_())
4.5 使用掩码限制QLineEdit控件的输入
掩码
说明
A
ASCII字母字符必须输入(A-Z、a-z)
a
ASCII字母字符允许但不是必须输入(A-Z、a-z)
N
ASCII字母和数字字符必须输入(A-Z、a-z 、0-9)
n
ASCII字母和数字字符允许但不是必须输入(A-Z、a-z 、0-9)
X
任何字符都必须输入
x
任何字符允许但不是必须输入
9
ASCII数字字符必须输入(0-9)
0
ASCII数字字符允许但不是必须输入(0-9)
D
ASCII数字字符必须输入(1-9)
d
ASCII数字字符允许但不是必须输入(1-9)
#
ASCII数字字符或加减符号允许但不是必须输入
H
十六进制格式字符必须输入(A-F,a-f,0-9)
h
十六进制格式允许但不是必须输入(A-F,a-f,0-9)
B
二进制格式字符是必须输入(0,1)
b
二进制格式字符允许但不是必须输入(0,1)
>
所有的字母字符都大写
<
所有的字母字符都小写
!
关闭大小写转换
使用\转义上面列出的字符
QLineEditMask.py:
""" @from:https://pythoneers.cn @author: qq3330447288 @contact: erics1996@yeah.net @software: PyCharm @file: QLineEditMask.py @time: 2020/11/25 下午11:41 """ from PyQt5.QtWidgets import QWidget, QApplication, QFormLayout, QLineEdit import sys class QLineEditMask(QWidget): def __init__(self): # 调用父类QWidget的__init__方法 super(QWidget, self).__init__() # 调用类的实例方法初始化窗口界面 self.initUI() def initUI(self): # 设置窗口标题 self.setWindowTitle('5.掩码限制QLineEdit控件的输入') # 创建表单布局 formLayout = QFormLayout() # 创建QLineEdit控件 ipLineEdit = QLineEdit() macLineEdit = QLineEdit() dateLineEdit = QLineEdit() licenseLineEdit = QLineEdit() # 设置掩码规则(ASCII数字字符允许但不是必须输入0-9),没有输入时显示下划线 ipLineEdit.setInputMask('000,000,000,000;_') # 置掩码规则( 十六进制格式允许但不是必须输入A-F,a-f,0-9),没有输入时显示下划线 macLineEdit.setInputMask('HH:HH:HH:HH:HH:HH;_') # 置掩码规则(ASCII数字字符允许但不是必须输入0-9),没有输入时显示下划线 dateLineEdit.setInputMask('0000-00-00;_') # 置掩码规则(ASCII字母字符必须输入A-Z、a-z,如果输入a-z则小写转大写),没有输入时显示#号 licenseLineEdit.setInputMask('>AAAAA-AAAAA-AAAAA-AAAAA-AAAAA;#') # 将QLineEdit控件添加到表单布局中 formLayout.addRow('ip地址', ipLineEdit) formLayout.addRow('mac地址', macLineEdit) formLayout.addRow('日期', dateLineEdit) formLayout.addRow('序列号', licenseLineEdit) # 设置窗口的布局为表单布局 self.setLayout(formLayout) if __name__ == '__main__': # 创建应用程序对象 app = QApplication(sys.argv) # 创建窗口类的对象 mainWindow = QLineEditMask() # 显示窗口 mainWindow.show() # 调用exit()进入程序的主循环 sys.exit(app.exec_())