专栏列表

• Python教程（十）：面向对象编程（OOP）
• Python教程（十一）：单元测试与异常捕获
• Python教程（十二）：面向对象高级编程详解
• Python教程（十三）：常用内置模块详解
• Python教程（十四）：Requests模块详解
• Python教程（十五）：IO 编程
• Python教程（十六）：进程、线程、线程锁
• Python教程（十七）：协程、 asyncio与 aiohttp【异步IO】
• Python教程（十八）: 从零到一教会你用 Django【Web 开发】
• Python教程（十九）：使用Tkinter制作计算器

---

正文开始 ， 如果觉得文章对您有帮助，请帮我三连+订阅，谢谢💖💖💖

---

PyQt6 是一个用于创建跨平台桌面应用程序的 Python 绑定集合，它提供了对 Qt6 库的访问。Qt6 是一个强大的 C++ 库，用于开发具有图形用户界面的应用程序。PyQt6 允许 Python 开发者利用 Qt6 的强大功能来创建美观、响应迅速的应用程序。

环境准备

1 安装 Python

确保你的开发环境中安装了 Python。你可以从 Python 官网 下载并安装。

2 安装 PyQt6

使用 pip 安装 PyQt6：

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

创建 PyQt6 项目

1 创建项目目录

在你的工作目录中创建一个新的文件夹来存放你的项目文件：

mkdir my_pyqt6_project && cd my_pyqt6_project

2 创建主 Python 文件

在项目目录中创建一个 Python 文件，这将是你的 PyQt6 应用程序的入口点：

touch main.py

代码书写测试流程

1 导入 PyQt6 模块

在 main.py 文件中，首先导入 PyQt6 相关的模块：

from PyQt6.QtWidgets import QApplication, QMainWindow, QPushButton
from PyQt6.QtCore import Qt
import sys

2 创建主窗口类

创建一个继承自 QMainWindow 的类，并设置窗口的基本属性：

class MainWindow(QMainWindow):def __init__(self):super().__init__()self.setWindowTitle("PyQt6 应用程序")self.setGeometry(100, 100, 400, 300)  # 设置窗口位置和大小# 创建一个按钮并设置属性self.button = QPushButton("点击我", self)self.button.setGeometry(150, 130, 100, 30)  # 设置按钮位置和大小self.button.clicked.connect(self.on_button_clicked)def on_button_clicked(self):print("按钮被点击了")

3 创建应用程序实例并运行

在 main.py 文件的底部，创建 QApplication 实例，并运行应用程序：

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

在命令行中，运行你的 main.py 文件：

python main.py

核心解析：

PyQt6 中的模块

PyQt6 类是由一系列模块组成的，包括如下的模块：

• QtCore
• QtGui
• QtWidgets
• QtDBus
• QtNetwork
• QtHelp
• QtXml
• QtSvg
• QtSql
• QtTest

1. QtWidgets
   这是用于创建和管理 GUI 窗口、对话框、控件和项目的主要模块。它包括按钮、文本框、标签、菜单、工具栏等组件。

• QApplication：管理 GUI 应用程序的控制流和主要设置。
• QWidget：所有用户界面对象的基类。
• QMainWindow：主窗口的基类。
• QPushButton、QLabel、QLineEdit 等：用于创建不同类型的控件。

2. QtGui
   包含用于绘制文本、图像、图形和视频的类。它还包含颜色、字体、画笔和画刷等工具。

• QPainter：用于在窗口小部件上进行绘图。
• QIcon、QPixmap：用于处理图标和图像。
• QFont：用于创建和修改字体。

3. QtCore
   包含核心功能，如对象树、事件系统、计时器、信号和槽等。

• QObject：所有 Qt6 对象的基类，引入了事件处理和计时器。
• QThread：用于多线程编程。
• QTimer：用于创建计时器。
• QCoreApplication：管理应用程序的事件循环和核心设置。

4. QtSvg: 用于处理 SVG 文件和渲染 SVG 图像的模块。

5. QtNetwork: 提供网络通信功能的模块，包括 TCP/IP、UDP 和本地套接字。

6. QtSerialPort: 用于访问串行端口的模块。

7. QtSql: 提供对 SQL 数据库的访问，支持 SQLite、MySQL、PostgreSQL 等。

8. QtXml: 用于处理 XML 文档的模块。

9. QtWebSockets: 用于处理 WebSocket 通信的模块。

10. QtMultimedia: 用于处理音频、视频和相机的模块。

11. QtBluetooth: 用于处理蓝牙功能的模块。

12. QtPrintSupport: 用于打印功能的模块。

13. QtCharts: 用于创建图表的模块。

14. QtDataVisualization: 用于数据可视化的模块。

15. QtQuick: 用于创建 Qt Quick 应用程序的模块，支持 QML。

16. QtWebEngine: 提供 Web 浏览器功能的模块。

17. QtTest: 用于编写和执行单元测试的模块。

18. QtScxml: 用于状态机和基于状态的应用程序的模块。

19. QtDBus: 用于 D-Bus 通信的模块。

示例代码：

创建了一个主窗口，给窗口设置的状态栏，菜单栏工具栏，右键面板等功能

import sys
from PyQt6.QtWidgets import QApplication, QWidget, QToolTip, QPushButton, QMessageBox, QMainWindow, QMenu, QTextEdit, QLabel, QHBoxLayout, QVBoxLayout, QGridLayout, QLineEdit
from PyQt6.QtGui import QFont,QAction,QIconclass MenuBar(QMainWindow):def __init__(self):super().__init__()self.initUI()def initUI(self):# 设置左下角状态栏self.statusBar()self.statusBar().showMessage('程序准备好了')# 这里创建了一个文本编辑器组件，并把它设置到 QMainWindow 的中央。居中布局组件撑满了所有空白的部分。textEdit = QTextEdit("这是一个文本输入框")self.setCentralWidget(textEdit)# 设置工具栏self.toolbar = self.addToolBar('退出')exitAct = QAction(QIcon('logo.png'), '&退出', self)exitAct.setShortcut('Ctrl+Q')exitAct.setStatusTip('退出应用')exitAct.triggered.connect(QApplication.instance().quit)self.toolbar.addAction(exitAct)# 设置菜单栏menubar = self.menuBar()fileMenu = menubar.addMenu('&操作')fileMenu.addAction(exitAct)childMenu = QMenu("子菜单",self)childAction= QAction("子事件",self)childMenu.addAction(childAction)fileMenu.addMenu(childMenu)self.setGeometry(300, 300, 350, 250)self.setWindowTitle('主窗口示例')self.show()# 添加右键菜单def contextMenuEvent(self, event):cmenu = QMenu(self)newAct = cmenu.addAction("New")openAct = cmenu.addAction("Open")quitAct = cmenu.addAction("Quit")action = cmenu.exec(self.mapToGlobal(event.pos()))if action == quitAct:QApplication.instance().quit()# 启动
def main():app = QApplication(sys.argv)m = MenuBar()sys.exit(app.exec())if __name__ == '__main__':main()

PyQt6 常用的控件

1. QPushButton（按钮）

用于创建一个可点击的按钮。

• text：按钮上显示的文本。
• icon：按钮上的图标。
• clicked：当按钮被点击时发出的信号。

2. QLabel（标签）

用于显示文本或图像。

• text：标签上显示的文本。
• pixmap：标签上显示的图像。
• alignment：文本或图像的对齐方式。

3. QLineEdit（文本输入框）

用于让用户输入单行文本。

• text：输入框中的文本。
• placeholderText：输入框为空时显示的占位符文本。

4. QTextEdit（文本编辑框）

用于显示和编辑多行文本。

• text：编辑框中的文本。
• readOnly：设置编辑框是否只读。

5. QComboBox（下拉框）

允许用户从列表中选择一个选项。

• items：下拉框中的选项列表。
• currentText：当前选中的文本。

6. QListWidget（列表框）

显示一个列表，并允许用户选择其中的项。

• items：列表中的项。
• currentItem：当前选中的项。

7. QTableWidget（表格）

显示一个表格，可以包含多行和多列。

• rowCount：表格的行数。
• columnCount：表格的列数。
• item：表格中的单元格项。

8. QSlider（滑块）

允许用户通过滑动来选择一个值。

• minimum：滑块的最小值。
• maximum：滑块的最大值。
• value：滑块的当前值。

9. QProgressBar（进度条）

显示任务的进度。

• minimum：进度条的最小值。
• maximum：进度条的最大值。
• value：进度条的当前值。

10. QCheckBox（复选框）

允许用户选择一个或多个选项。

• text：复选框旁边的文本。
• checked：复选框是否被选中。

11. QRadioButton（单选按钮）

允许用户在一组选项中选择一个。

• text：单选按钮旁边的文本。
• checked：单选按钮是否被选中。

12. QSpinBox（数字选择框）

允许用户选择一个整数值。

• minimum：可选择的最小值。
• maximum：可选择的最大值。
• value：当前选中的值。

13. QGroupBox（组框）

用于将相关的控件组合在一起。

• title：组框的标题。

14. QStackedWidget（堆叠窗体）

允许在多个页面之间切换。

• currentIndex：当前显示的页面索引。

15. QMenuBar（菜单栏）

用于创建应用程序的菜单栏。

• actions：菜单栏中的操作列表。

16. QToolBar（工具栏）

用于创建工具栏，包含一组工具按钮。

• actions：工具栏中的操作列表。

17. QStatusBar（状态栏）

用于显示应用程序的状态信息。

• message：在状态栏上显示的消息。

18. QFileDialog（文件对话框）

用于打开、保存文件或浏览文件夹。

• fileMode：文件对话框的模式（例如，只读、写入等）。

19. QMessageBox（消息框）

用于显示消息框。

• text：消息框中的文本。
• icon：消息框中的图标类型。

20. QInputDialog（输入对话框）

用于获取用户的输入。

• text：输入对话框中的文本。

PyQt6 布局管理器

PyQt6 提供了几种布局管理器，包括 QHBoxLayout、QVBoxLayout、QGridLayout、QFormLayout 和 QStackedLayout。

1. 水平布局（QHBoxLayout）

水平布局管理器将控件水平排列。它按照控件添加到布局中的顺序从左到右排列控件。

from PyQt6.QtWidgets import QApplication, QWidget, QPushButton, QHBoxLayoutapp = QApplication([])
window = QWidget()
layout = QHBoxLayout()button1 = QPushButton('Button 1')
button2 = QPushButton('Button 2')
layout.addWidget(button1)
layout.addWidget(button2)
window.setLayout(layout)
window.show()
app.exec()

2. 垂直布局（QVBoxLayout）

垂直布局管理器将控件垂直排列。它按照控件添加到布局中的顺序从上到下排列控件。

from PyQt6.QtWidgets import QVBoxLayoutlayout = QVBoxLayout()
layout.addWidget(button1)
layout.addWidget(button2)
window.setLayout(layout)

3. 网格布局（QGridLayout）

网格布局管理器将控件放置在一个网格中，每个控件都占据网格的特定行和列。它非常适合创建表格形式的布局。

from PyQt6.QtWidgets import QGridLayoutlayout = QGridLayout()
layout.addWidget(button1, 0, 0)  # 第0行，第0列
layout.addWidget(button2, 0, 1)  # 第0行，第1列
layout.addWidget(another_button, 1, 0)  # 第1行，第0列
window.setLayout(layout)

4. 表单布局（QFormLayout）

表单布局管理器用于创建表单，它将标签和字段两两对应地排列。这种布局特别适合创建表单界面。

from PyQt6.QtWidgets import QFormLayout, QLineEditlayout = QFormLayout()
layout.addRow('Label 1:', QLineEdit())
layout.addRow('Label 2:', QLineEdit())
window.setLayout(layout)

5. 堆叠布局（QStackedLayout）

堆叠布局管理器允许你在多个控件之间进行选择和切换，就像标签页一样。它通常与 QStackedWidget 一起使用。

from PyQt6.QtWidgets import QStackedWidget, QPushButtonstacked_widget = QStackedWidget()
page1 = QWidget()
page2 = QWidget()
button1 = QPushButton('Button 1', page1)
button2 = QPushButton('Button 2', page2)
stacked_widget.addWidget(page1)
stacked_widget.addWidget(page2)
layout = QVBoxLayout()
layout.addWidget(stacked_widget)
window.setLayout(layout)

布局的嵌套和组合

你可以将不同的布局嵌套和组合使用，以创建复杂的用户界面。例如，你可以在一个 QVBoxLayout 中放置一个 QHBoxLayout 和一个 QGridLayout。

from PyQt6.QtWidgets import QVBoxLayout, QHBoxLayout, QPushButtonmain_layout = QVBoxLayout()
horizontal_layout = QHBoxLayout()
horizontal_layout.addWidget(QPushButton('Button 1'))
horizontal_layout.addWidget(QPushButton('Button 2'))grid_layout = QGridLayout()
grid_layout.addWidget(QPushButton('Button 3'), 0, 0)
grid_layout.addWidget(QPushButton('Button 4'), 0, 1)main_layout.addLayout(horizontal_layout)
main_layout.addLayout(grid_layout)
window.setLayout(main_layout)

注意事项

• 每个 QWidget 只能设置一个布局。
• 使用 addLayout 方法可以将一个布局添加到另一个布局中。
• 使用 addWidget 方法可以将控件添加到布局中。
• 布局管理器会自动调整控件的大小，以适应窗口的大小变化。

代码示例：

下面是使用绝对定位、水平、垂直，网格等定位的代码实例

import sys
from PyQt6.QtWidgets import QApplication, QWidget, QToolTip, QPushButton, QMessageBox, QMainWindow, QMenu, QTextEdit, QLabel, QHBoxLayout, QVBoxLayout, QGridLayout, QLineEdit
from PyQt6.QtGui import QFont,QAction,QIcon
class Position(QWidget):def __init__(self):super().__init__()# 绝对的定位# self.absoluteLayout()# 水平垂直定位，不能跟 网格同时存在# self.HVLayout()# 网格定位# self.gridLayout()#self.formLayout()def absoluteLayout(self):label1 = QLabel(self)label1.setText('姓名：')label1.move(40,40)label2 = QLabel(self)label2.setText('年龄：')label2.move(80, 80)self.resize(400, 400)self.move(300, 300)self.show()def HVLayout(self):btnOK = QPushButton(self)btnCancel = QPushButton(self)btnOK.setText('确认')btnCancel.setText('取消')Hlayout = QHBoxLayout(self)Hlayout.addStretch(1)Hlayout.addWidget(btnOK)Hlayout.addWidget(btnCancel)Vlayout = QVBoxLayout()Vlayout.addStretch(1)Vlayout.addLayout(Hlayout)self.setGeometry(300,300, 350, 250)self.setLayout(Vlayout)def gridLayout(self):grid = QGridLayout()self.setLayout(grid)names = ['Cls', 'Bck', '', 'Close','7', '8', '9', '/','4', '5', '6', '*','1', '2', '3', '-','0', '.', '=', '+']positions = [(i, j) for i in range(5) for j in range(4)]for position, name in zip(positions, names):if name == '':continuebutton = QPushButton(name)grid.addWidget(button, *position)self.setGeometry(300,300, 350, 250)self.show()def formLayout(self):title = QLabel("标题")desc = QLabel('描述')content = QLabel('内容')titleEdit = QLineEdit("第一个篇文章")descEdit = QLineEdit('入坑指南')contentEdit = QTextEdit('内容:从入门到放弃')grid = QGridLayout()grid.setSpacing(10)grid.addWidget(title,1,0)grid.addWidget(titleEdit,1,1,1,8)grid.addWidget(desc, 2, 0)grid.addWidget(descEdit, 2, 1,1,8)grid.addWidget(content, 3, 0)grid.addWidget(contentEdit, 3, 1,2,8)grid.addWidget(QPushButton('提交'),6,5)grid.addWidget(QPushButton('重置'),6,7)self.setLayout(grid)self.setGeometry(300,300,450,350)self.show()
# 启动
def main():app = QApplication(sys.argv)w = MyWidget()d= Position()sys.exit(app.exec())if __name__ == '__main__':main()

PyQt6 事件绑定

在 PyQt6 中，通常是通过信号和槽机制来实现的。信号（Signals）是由对象发出的通知，表示发生了某个特定的事件，而槽（Slots）是响应这些信号的函数或方法。你可以将信号绑定到槽上，以便当信号被发出时，相应的槽函数被调用。

1. 定义槽函数

首先，你需要定义一个槽函数，这个函数将作为信号的响应。例如，为按钮点击事件定义一个槽函数：

from PyQt6.QtWidgets import QApplication, QPushButton, QMainWindowdef on_button_clicked():print("按钮被点击了")

2. 创建信号源对象

创建一个信号源对象，例如一个按钮，并将其 clicked 信号连接到槽函数：

app = QApplication([])
window = QMainWindow()button = QPushButton("点击我")
button.clicked.connect(on_button_clicked)  # 绑定信号到槽window.setCentralWidget(button)
window.show()
app.exec()

3. 使用 lambda 表达式

如果你想要将信号连接到一个带参数的槽函数，或者在连接时传递特定的参数，你可以使用 lambda 表达式：

def handle_button_click(value):print(f"按钮被点击了，值为：{value}")button.clicked.connect(lambda: handle_button_click(42))

4. 绑定键盘事件

你可以为窗口或其他控件绑定键盘事件：

def keyPressEvent(event):if event.key() == Qt.Key_Escape:print("Esc键被按下")window.close()window.keyPressEvent = keyPressEvent

5. 绑定鼠标事件

同样，你可以为窗口或其他控件绑定鼠标事件：

def mousePressEvent(event):print("鼠标点击了窗口")window.mousePressEvent = mousePressEvent

6. 自定义控件事件

如果你创建了自定义控件，你可以在其中定义新的信号，并在适当的时候发出这些信号：

from PyQt6.QtCore import pyqtSignal, QObjectclass MyObject(QObject):my_signal = pyqtSignal()# 使用
my_obj = MyObject()
my_obj.my_signal.connect(on_button_clicked)
my_obj.my_signal.emit()  # 发出信号

总结

通过本教程，你已经学会了如何使用 PyQt6 创建一个基本的 Python GUI 应用程序。PyQt6 提供了丰富的控件和灵活的布局管理，使得它成为快速开发 GUI 应用程序的理想选择。你可以继续探索 PyQt6 的更多高级特性，或者尝试创建更复杂的应用程序。

参考资源

• PyQt6 官方文档
• PyQt6 教程 - examples