python

关注公众号 jb51net

关闭
首页 > 脚本专栏 > python > PyQt5入门到精通

PyQt5超详细入门级教程(推荐!)

作者：Trouvaille ~

PyQt5是Python编程语言的一个模块,它提供了一种在Python中使用Qt库的方式,下面这篇文章主要给大家介绍了关于PyQt5超详细入门级教程的相关资料,文中通过代码介绍的非常详细,需要的朋友可以参考下

前言

建议把代码复制到pycharm等IDE上面看实际效果，方便理解嗷❤️

序篇：1-3部分：PyQt5基础与常用控件

第1部分：初识 PyQt5 和安装

1.1 什么是 PyQt5？

PyQt5 是 Python 的图形用户界面 (GUI) 框架，它基于强大的 Qt 库。Qt 是一个跨平台的 C++ 框架，用于构建桌面应用程序。通过 PyQt5，我们可以用 Python 轻松构建跨平台的桌面应用程序，支持 Windows、macOS 和 Linux。

1.2 在 PyCharm 中安装 PyQt5

1.3 在 PyCharm 中编写第一个 PyQt5 应用程序

接下来，我们将在 PyCharm 中创建一个简单的 PyQt5 应用程序，显示一个包含 “Hello, World!” 的窗口。

import sys  # 导入 sys 模块，用于与 Python 解释器交互
from PyQt5.QtWidgets import QApplication, QLabel, QMainWindow  # 从 PyQt5 中导入所需的类

# 创建一个主窗口类，继承自 QMainWindow
class MainWindow(QMainWindow):
    def __init__(self):
        super().__init__()  # 调用父类 QMainWindow 的初始化方法
        self.setWindowTitle("PyQt5 第一个窗口")  # 设置窗口标题

        # 创建一个 QLabel 标签，并将其作为主窗口的中央控件
        label = QLabel("Hello, World!", self)
        self.setCentralWidget(label)  # 将标签作为窗口的中央控件

# 创建一个 PyQt5 应用程序对象
app = QApplication(sys.argv)

# 创建主窗口实例
window = MainWindow()
window.show()  # 显示窗口

# 进入应用程序的事件循环，保持应用程序运行，直到关闭窗口
sys.exit(app.exec_())

1.4 代码详细解释

1.5 在 PyCharm 中运行程序

运行代码后，你将看到一个包含 “Hello, World!” 的窗口弹出。

1.6 常见问题排查

1.7 总结

第2部分：创建 PyQt5 应用程序与布局管理

2.1 PyQt5 的基本窗口结构

在 PyQt5 中，窗口（window）是应用程序的核心部分。我们已经了解了如何创建一个简单的 QMainWindow，并在其中显示一些基本内容，比如文本标签 (QLabel)。现在，我们将进一步了解 PyQt5 中的 布局管理，并学习如何合理地组织多个控件，使界面更具交互性和美观性。

2.2 基本的 PyQt5 窗口与布局

QWidget 与 QMainWindow 的区别

2.3 布局管理器

在开发 GUI 应用程序时，如何排列和管理窗口中的控件至关重要。PyQt5 提供了几个常用的布局管理器，让控件自动调整位置和大小。常见的布局管理器有：

2.4 在窗口中使用布局管理器

我们来创建一个包含多个控件的窗口，使用 QVBoxLayout 和 QHBoxLayout 来组织这些控件。

完整代码：

import sys
from PyQt5.QtWidgets import QApplication, QMainWindow, QWidget, QVBoxLayout, QHBoxLayout, QPushButton, QLabel

# 创建一个主窗口类，继承自 QMainWindow
class MainWindow(QMainWindow):
    def __init__(self):
        super().__init__()

        self.setWindowTitle("PyQt5 布局示例")  # 设置窗口标题

        # 创建主窗口中的中央控件，QMainWindow 需要设置中央控件
        central_widget = QWidget(self)
        self.setCentralWidget(central_widget)

        # 创建垂直布局管理器
        vbox_layout = QVBoxLayout()

        # 创建标签控件并添加到布局中
        label = QLabel("这是一个标签")
        vbox_layout.addWidget(label)

        # 创建水平布局管理器
        hbox_layout = QHBoxLayout()

        # 创建两个按钮，并添加到水平布局中
        button1 = QPushButton("按钮 1")
        button2 = QPushButton("按钮 2")
        hbox_layout.addWidget(button1)
        hbox_layout.addWidget(button2)

        # 将水平布局添加到垂直布局中
        vbox_layout.addLayout(hbox_layout)

        # 将布局设置为中央控件的布局
        central_widget.setLayout(vbox_layout)

# 创建应用程序对象
app = QApplication(sys.argv)

# 创建主窗口
window = MainWindow()
window.show()

# 进入应用程序的事件循环
sys.exit(app.exec_())

2.5 代码详解

2.6 更多布局管理器介绍

QGridLayout (网格布局管理器)

QGridLayout 允许你以网格的形式排列控件，每个控件可以放置在指定的行和列中。它适合用来创建表单或矩阵式的控件布局。

QGridLayout 示例：

from PyQt5.QtWidgets import QApplication, QWidget, QGridLayout, QLabel, QPushButton
import sys

class MainWindow(QWidget):
    def __init__(self):
        super().__init__()

        self.setWindowTitle("QGridLayout 示例")
        
        # 创建一个网格布局
        layout = QGridLayout()

        # 添加控件到网格布局的特定行和列
        layout.addWidget(QLabel("标签 1"), 0, 0)  # 在第 0 行，第 0 列添加标签
        layout.addWidget(QPushButton("按钮 1"), 0, 1)  # 在第 0 行，第 1 列添加按钮
        layout.addWidget(QLabel("标签 2"), 1, 0)  # 在第 1 行，第 0 列添加标签
        layout.addWidget(QPushButton("按钮 2"), 1, 1)  # 在第 1 行，第 1 列添加按钮

        # 将布局设置为窗口的布局
        self.setLayout(layout)

app = QApplication(sys.argv)
window = MainWindow()
window.show()
sys.exit(app.exec_())

代码详解：

2.7 总结

在这一部分中，我们学习了如何在 PyQt5 中使用布局管理器来组织窗口内的控件。我们主要介绍了几种常见的布局方式：

通过使用这些布局管理器，我们可以让窗口中的控件自动调整位置和大小，而不需要手动计算控件的坐标。

这部分在之后还会有更加详细的介绍

第3部分：常用控件详解

在 PyQt5 中，常用的控件（也称为小部件）有很多，它们可以用来实现用户界面中的各种元素，比如按钮、文本框、复选框等。接下来，我们将逐一介绍，并展示如何使用这些控件。

3.1 QLabel（标签）

QLabel 是一个用于显示文本或图片的控件。它是最简单的控件之一，常用于显示静态文本。

代码示例：

from PyQt5.QtWidgets import QApplication, QLabel, QMainWindow
from PyQt5.QtCore import Qt  # 导入 Qt 模块
import sys

class MainWindow(QMainWindow):
    def __init__(self):
        super().__init__()

        self.setWindowTitle("QLabel 示例")

        # 创建标签并设置文本
        label = QLabel("这是一个标签", self)

        # 设置标签的对齐方式
        label.setAlignment(Qt.AlignCenter)

        # 设置标签为中央控件
        self.setCentralWidget(label)

app = QApplication(sys.argv)
window = MainWindow()
window.show()
sys.exit(app.exec_())

代码详解：

3.2 QPushButton（按钮）

QPushButton 是一个按钮控件，用户可以点击按钮来触发事件。它是最常见的控件之一。

代码示例：

from PyQt5.QtWidgets import QApplication, QMainWindow, QPushButton
import sys

class MainWindow(QMainWindow):
    def __init__(self):
        super().__init__()

        self.setWindowTitle("QPushButton 示例")

        # 创建按钮
        button = QPushButton("点击我", self)

        # 设置按钮点击事件
        button.clicked.connect(self.button_clicked)

        # 将按钮设置为窗口的中央控件
        self.setCentralWidget(button)

    # 定义按钮点击时触发的事件
    def button_clicked(self):
        print("按钮被点击！")

app = QApplication(sys.argv)
window = MainWindow()
window.show()
sys.exit(app.exec_())

代码详解：

3.3 QLineEdit（单行文本框）

QLineEdit 是一个单行文本框，用于让用户输入文本。你可以获取用户输入的文本并对其进行处理。

代码示例：

from PyQt5.QtWidgets import QApplication, QMainWindow, QLineEdit
import sys

class MainWindow(QMainWindow):
    def __init__(self):
        super().__init__()

        self.setWindowTitle("QLineEdit 示例")

        # 创建文本框
        self.line_edit = QLineEdit(self)

        # 设置默认提示文本
        self.line_edit.setPlaceholderText("请输入文本")

        # 将文本框设置为中央控件
        self.setCentralWidget(self.line_edit)

        # 连接文本输入结束的信号到槽函数
        self.line_edit.returnPressed.connect(self.return_pressed)

    def return_pressed(self):
        # 获取用户输入的文本
        text = self.line_edit.text()
        print(f"用户输入: {text}")

app = QApplication(sys.argv)
window = MainWindow()
window.show()
sys.exit(app.exec_())

代码详解：

3.4 QCheckBox（复选框）

QCheckBox 是一个复选框，用户可以选择或取消选择该选项。它通常用于让用户勾选某些偏好或选项。

代码示例：

from PyQt5.QtWidgets import QApplication, QMainWindow, QCheckBox
import sys

class MainWindow(QMainWindow):
    def __init__(self):
        super().__init__()

        self.setWindowTitle("QCheckBox 示例")

        # 创建复选框
        self.checkbox = QCheckBox("同意条款", self)

        # 设置复选框状态改变事件
        self.checkbox.stateChanged.connect(self.checkbox_changed)

        # 将复选框设置为中央控件
        self.setCentralWidget(self.checkbox)

    def checkbox_changed(self, state):
        if state == Qt.Checked:
            print("复选框被勾选")
        else:
            print("复选框未被勾选")

app = QApplication(sys.argv)
window = MainWindow()
window.show()
sys.exit(app.exec_())

代码详解：

在这里插入图片描述

3.5 QComboBox（下拉列表）

QComboBox 是一个下拉列表控件，用户可以从中选择一个选项。

代码示例：

from PyQt5.QtWidgets import QApplication, QMainWindow, QComboBox
import sys

class MainWindow(QMainWindow):
    def __init__(self):
        super().__init__()

        self.setWindowTitle("QComboBox 示例")

        # 创建下拉列表
        self.combobox = QComboBox(self)

        # 添加选项
        self.combobox.addItems(["选项 1", "选项 2", "选项 3"])

        # 连接下拉列表选项改变事件
        self.combobox.currentIndexChanged.connect(self.combobox_changed)

        # 将下拉列表设置为中央控件
        self.setCentralWidget(self.combobox)

    def combobox_changed(self, index):
        # 获取当前选中的文本
        text = self.combobox.currentText()
        print(f"当前选中: {text}")

app = QApplication(sys.argv)
window = MainWindow()
window.show()
sys.exit(app.exec_())

代码详解：

3.6 总结

在这一部分中，我们介绍了 PyQt5 中一些常见的控件，分别是：

这些控件是 GUI 应用程序的基础组成部分，它们让应用程序更加互动和可操作。

1-3部分总结

第1至第3部分中，我们介绍了 PyQt5 的基础知识和一些常用的控件。首先，我们讲解了如何安装 PyQt5，并创建了一个简单的 PyQt5 应用程序。接着，介绍了布局管理器（如 QVBoxLayout 和 QHBoxLayout），并通过它们组织界面中的控件。最后，我们深入探讨了 PyQt5 中的常用控件，如 QLabel、QPushButton、QLineEdit 和 QCheckBox，展示了如何使用这些控件处理基本的用户交互。

到此这篇关于PyQt5超详细入门级教程的文章就介绍到这了,更多相关PyQt5入门到精通内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家！

您可能感兴趣的文章:
阅读全文