详解Python GUI编程之PyQt5入门到实战

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: [e-mail]
@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: [e-mail]
@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: [e-mail]
@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: [e-mail]
@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: [e-mail]
@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: [e-mail]
@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: [e-mail]
@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: [e-mail]
@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: [e-mail]
@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: [e-mail]
@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: [e-mail]
@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_())

到此这篇关于详解python gui编程之pyqt5入门到实战的文章就介绍到这了,更多相关pyqt5入门内容请搜索以前的文章或继续浏览下面的相关文章希望大家以后多多支持！