Python教程（二十） : 十分钟入门【PyQt6】

文章目录

- 专栏列表
- 环境准备
- - 1 安装 Python
  - 2 安装 PyQt6
- PyQt6 中的模块
- - 使用模块创建一个窗体：
- PyQt6 常用的控件
- - 1. QPushButton（按钮）
  - 2. QLabel（标签）
  - 3. QLineEdit（文本输入框）
  - 4. QTextEdit（文本编辑框）
  - 5. QComboBox（下拉框）
  - 6. QListWidget（列表框）
  - 7. QTableWidget（表格）
  - 8. QSlider（滑块）
  - 9. QProgressBar（进度条）
  - 10. QCheckBox（复选框）
  - 11. QRadioButton（单选按钮）
  - 12. QSpinBox（数字选择框）
  - 13. QGroupBox（组框）
  - 14. QStackedWidget（堆叠窗体）
  - 15. QMenuBar（菜单栏）
  - 16. QToolBar（工具栏）
  - 17. QStatusBar（状态栏）
  - 18. QFileDialog（文件对话框）
  - 19. QMessageBox（消息框）
  - 20. QInputDialog（输入对话框）
- PyQt6 布局管理器
- - 1. 水平布局（QHBoxLayout）
  - 2. 垂直布局（QVBoxLayout）
  - 3. 网格布局（QGridLayout）
  - 4. 表单布局（QFormLayout）
  - 5. 堆叠布局（QStackedLayout）
  - 布局的嵌套和组合
  - 注意事项
  - 代码示例：
- PyQt6 事件绑定
- - 1. 定义槽函数
  - 2. 创建信号源对象
  - 3. 使用 lambda 表达式
  - 4. 绑定键盘事件
  - 5. 绑定鼠标事件
  - 6. 自定义控件事件
- 创建 PyQt6 项目
- - 1 创建项目目录
  - 2 创建主 Python 文件
- 代码书写测试流程
- - 1 导入 PyQt6 模块
  - 2 创建主窗口类
  - 3 创建应用程序实例并运行
- 总结
- 参考资源

专栏列表

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 中的模块

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

QtCore
QtGui
QtWidgets
QtDBus
QtNetwork
QtHelp
QtXml
QtSvg
QtSql
QtTest

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

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

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

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

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

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

QtSvg: 用于处理 SVG 文件和渲染 SVG 图像的模块。
QtNetwork: 提供网络通信功能的模块，包括 TCP/IP、UDP 和本地套接字。
QtSerialPort: 用于访问串行端口的模块。
QtSql: 提供对 SQL 数据库的访问，支持 SQLite、MySQL、PostgreSQL 等。
QtXml: 用于处理 XML 文档的模块。
QtWebSockets: 用于处理 WebSocket 通信的模块。
QtMultimedia: 用于处理音频、视频和相机的模块。
QtBluetooth: 用于处理蓝牙功能的模块。
QtPrintSupport: 用于打印功能的模块。
QtCharts: 用于创建图表的模块。
QtDataVisualization: 用于数据可视化的模块。
QtQuick: 用于创建 Qt Quick 应用程序的模块，支持 QML。
QtWebEngine: 提供 Web 浏览器功能的模块。
QtTest: 用于编写和执行单元测试的模块。
QtScxml: 用于状态机和基于状态的应用程序的模块。
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,QIcon

class MenuBar(QMainWindow):

    def __init__(self):
        super().__init__()

        self.initUI()


    def initUI(self):
        # 设置左下角状态栏
        self.statusBar()
        self.statusBar().showMessage('Ready')
        # 这里创建了一个文本编辑器组件，并把它设置到 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, QHBoxLayout

app = 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 QVBoxLayout

layout = QVBoxLayout()
layout.addWidget(button1)
layout.addWidget(button2)
window.setLayout(layout)

3. 网格布局（QGridLayout）

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

from PyQt6.QtWidgets import QGridLayout

layout = 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, QLineEdit

layout = QFormLayout()
layout.addRow('Label 1:', QLineEdit())
layout.addRow('Label 2:', QLineEdit())
window.setLayout(layout)

5. 堆叠布局（QStackedLayout）

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

from PyQt6.QtWidgets import QStackedWidget, QPushButton

stacked_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, QPushButton

main_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 == '':
                continue

            button = 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, QMainWindow

def 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, QObject

class MyObject(QObject):
    my_signal = pyqtSignal()

# 使用
my_obj = MyObject()
my_obj.my_signal.connect(on_button_clicked)
my_obj.my_signal.emit()  # 发出信号

创建 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 创建一个基本的 Python GUI 应用程序。PyQt6 提供了丰富的控件和灵活的布局管理，使得它成为快速开发 GUI 应用程序的理想选择。你可以继续探索 PyQt6 的更多高级特性，或者尝试创建更复杂的应用程序。

参考资源

PyQt6 官方文档
PyQt6 教程 - examples