【Python篇】PyQt5 超详细教程——由入门到精通(序篇)

简介: 【Python篇】PyQt5 超详细教程——由入门到精通(序篇)

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. 打开 PyCharm: 打开你的 PyCharm 编辑器,确保你已经有一个项目或新建一个项目。
  2. 安装 PyQt5: 你可以在 PyCharm 中使用两种方式安装 PyQt5:
  • 方法 1:通过 PyCharm 的设置安装
  • 点击 File -> Settings
  • 在设置界面中,选择 Project -> Python Interpreter
  • 点击右侧的 + 按钮,搜索 PyQt5
  • 选择 PyQt5 并点击 Install Package 安装。
  • 方法 2:通过 PyCharm 终端安装
  • 打开 Terminal 窗口(在 PyCharm 底部菜单栏中找到“Terminal”选项)。
  • 输入以下命令安装 PyQt5:
pip install PyQt5
  • 安装完成后,PyCharm 会自动识别并添加 PyQt5 到项目中。

3.检查安装是否成功: 你可以通过在终端中运行 pip list 查看是否安装了 PyQt5。


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

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

  1. 创建 Python 文件
  • 在 PyCharm 项目中,右键点击项目文件夹,选择 New -> Python File,将文件命名为 main.py

2.编写代码: 在新建的 main.py 文件中,输入以下代码:

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. import sys
  1. 作用sys 是 Python 的内置模块,提供了一些与 Python 解释器进行交互的功能。在 PyQt5 中,sys.exit() 用来确保应用程序关闭时退出干净,不留任何后台进程。
  1. from PyQt5.QtWidgets import QApplication, QLabel, QMainWindow

QApplication:每个 PyQt5 程序必须有一个 QApplication 实例,它管理应用程序的控制流和设置。

QMainWindow:这是 PyQt5 中的主窗口类,它是所有复杂窗口的基础。可以包含菜单栏、工具栏、状态栏、中央控件等。

QLabel:这是一个简单的控件,用于显示文本。

  1. class MainWindow(QMainWindow):
  1. 作用:定义了一个名为 MainWindow 的类,继承自 QMainWindow。通过继承 QMainWindow,我们可以自定义窗口的行为和外观。
  1. self.setWindowTitle("PyQt5 第一个窗口")
  1. 作用:设置窗口的标题,标题显示在应用程序窗口的顶部。
  1. label = QLabel("Hello, World!", self)
  1. 作用:创建一个 QLabel 控件,显示文本 “Hello, World!”。
  2. self 参数:将标签关联到当前窗口(MainWindow),即将其设置为窗口的子控件。
  1. self.setCentralWidget(label)
  1. 作用:设置 label 为窗口的中央控件,中央控件是填充窗口中间区域的控件。
  1. app = QApplication(sys.argv)

作用QApplication 是 PyQt5 应用程序的基础,每个 PyQt5 应用程序都必须有一个 QApplication 实例,它管理整个应用程序的生命周期和事件处理。

  1. sys.argv:传递命令行参数,通常可以忽略。

8.window.show()

  1. 作用:将窗口设置为可见,并显示在屏幕上。

9.sys.exit(app.exec_())

  1. 作用app.exec_() 开始应用程序的事件循环,保持应用程序的持续运行,直到用户关闭窗口。sys.exit() 确保应用程序正常退出。
1.5 在 PyCharm 中运行程序
  1. 确保你的 PyQt5 安装正确,并且代码已经保存。
  2. 点击 PyCharm 界面顶部的绿色 Run 按钮,或者右键点击代码文件并选择 Run ‘main’

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


1.6 常见问题排查
  1. 没有安装 PyQt5:确保你已经在项目的解释器中正确安装了 PyQt5,可以通过 pip list 命令检查是否安装。
  2. 解释器配置错误:确保 PyCharm 中使用的 Python 解释器与安装了 PyQt5 的 Python 版本一致。
  3. 窗口不显示:检查代码中是否调用了 window.show(),没有调用该方法窗口将不会显示。
1.7 总结
  • PyQt5 是一个非常强大的 GUI 框架,适合用于创建桌面应用程序。
  • 我们通过简单的几行代码,创建了一个带有文本标签的基本窗口。
  • 你可以通过 PyCharm 轻松运行 PyQt5 程序,并使用其强大的功能来构建复杂的用户界面。

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


2.1 PyQt5 的基本窗口结构

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


2.2 基本的 PyQt5 窗口与布局
QWidget 与 QMainWindow 的区别
  • QWidget:是 PyQt5 中的所有控件(如按钮、标签、文本框等)的基类。任何可视化控件基本上都可以继承自 QWidget。它也是最基础的窗口控件,可以用来创建简单的窗口。
  • QMainWindow:是一个高级窗口控件,继承自 QWidget,但是它具有更多的功能,比如菜单栏、工具栏、状态栏等。你可以把 QMainWindow 理解为一个“带更多功能的高级窗口”。
2.3 布局管理器

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

  1. QVBoxLayout:垂直布局管理器,控件从上到下排列。
  2. QHBoxLayout:水平布局管理器,控件从左到右排列。
  3. QGridLayout:网格布局管理器,控件按网格排列。
  4. QFormLayout:表单布局管理器,适合排列标签和输入框。
2.4 在窗口中使用布局管理器

我们来创建一个包含多个控件的窗口,使用 QVBoxLayoutQHBoxLayout 来组织这些控件。

完整代码:

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 代码详解
  1. QWidgetQMainWindow
  • 我们使用了 QMainWindow 作为主窗口,主窗口需要设置一个中央控件,所以我们创建了一个 QWidget 实例 central_widget
  • setCentralWidget() 方法用于将 QWidget 设置为 QMainWindow 的中央控件,这个中央控件是放置所有其他控件的容器。
  1. 布局管理器:QVBoxLayout 与 QHBoxLayout
  • QVBoxLayout 是一个垂直布局管理器,控件会从上到下排列。
  • QHBoxLayout 是一个水平布局管理器,控件会从左到右排列。
  • 我们先在窗口中添加了一个标签,然后再添加了两个水平排列的按钮。按钮排列在水平布局中,水平布局本身又嵌入到了垂直布局中,形成了一种灵活的组合布局。
  1. 添加控件到布局
  • vbox_layout.addWidget(label) 将标签控件添加到垂直布局中。
  • hbox_layout.addWidget(button1)hbox_layout.addWidget(button2) 将按钮控件添加到水平布局中。
  1. 布局嵌套
  • 通过 vbox_layout.addLayout(hbox_layout),我们将水平布局嵌入到垂直布局中,实现更复杂的布局结构。

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_())
代码详解:
  1. QGridLayout():创建了一个网格布局对象。
  2. addWidget(widget, row, column):将控件添加到指定的行和列中,比如 (0, 0) 表示控件放置在第一行第一列。
2.7 总结

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

  • QVBoxLayout:垂直排列控件。
  • QHBoxLayout:水平排列控件。
  • QGridLayout:网格方式排列控件。

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

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


第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_())
代码详解:
  1. QLabel:用于显示文本的控件。你可以设置标签的内容、字体、对齐方式等。
  2. setAlignment(Qt.AlignCenter):将标签的文本设置为居中对齐。
  1. self.setCentralWidget(label):将标签设置为窗口的中央控件。

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_())
代码详解:
  1. QPushButton:创建了一个按钮控件,显示文本为“点击我”。
  2. button.clicked.connect(self.button_clicked):连接按钮的点击信号到自定义的 button_clicked 方法。当按钮被点击时,这个方法会被触发。

3.self.button_clicked:定义了一个槽函数,用于响应按钮点击事件。在槽函数中,程序会打印 “按钮被点击!”。


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_())
代码详解:
  1. QLineEdit:创建了一个单行文本框控件,允许用户输入文本。
  2. setPlaceholderText():设置占位符文本,当用户没有输入时显示提示文本。

3,self.line_edit.returnPressed.connect(self.return_pressed):连接用户按下“回车键”时的信号到 return_pressed 槽函数,获取输入文本并打印出来。


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_())
代码详解:
  1. QCheckBox:创建一个复选框,显示文本为“同意条款”。
  2. self.checkbox.stateChanged.connect(self.checkbox_changed):连接复选框状态改变的信号到槽函数 checkbox_changed,当用户勾选或取消勾选时会触发相应的事件。
  3. checkbox_changed(self, state):根据复选框的状态(勾选或未勾选)打印相应的消息。


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_())
代码详解:
  1. QComboBox:创建一个下拉列表控件,用户可以从中选择选项。
  2. self.combobox.addItems():向下拉列表中添加选项。

3.currentIndexChanged.connect():连接下拉列表选项改变的信号到 combobox_changed 槽函数,当用户选择不同的选项时会打印选中的文本。


3.6 总结

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

  • QLabel:显示静态文本或图片。
  • QPushButton:创建按钮,用户点击触发事件。
  • QLineEdit:单行文本框,用户可以输入文本。
  • QCheckBox:复选框,用户可以选择或取消选择。
  • QComboBox:下拉列表,用户可以选择一个选项。

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


1-3部分总结

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

以上就是关于【Python篇】PyQt5 超详细教程——由入门到精通(序篇)的内容啦,各位大佬有什么问题欢迎在评论区指正,您的支持是我创作的最大动力!❤️


目录
相关文章
|
2天前
|
数据采集 机器学习/深度学习 人工智能
Python编程入门:从基础到实战
【10月更文挑战第24天】本文将带你进入Python的世界,从最基础的语法开始,逐步深入到实际的项目应用。我们将一起探索Python的强大功能和灵活性,无论你是编程新手还是有经验的开发者,都能在这篇文章中找到有价值的内容。让我们一起开启Python的奇妙之旅吧!
|
4天前
|
数据采集 存储 数据库
Python中实现简单爬虫的入门指南
【10月更文挑战第22天】本文将带你进入Python爬虫的世界,从基础概念到实战操作,一步步指导你如何使用Python编写一个简单的网络爬虫。我们将不展示代码示例,而是通过详细的步骤描述和逻辑讲解,帮助你理解爬虫的工作原理和开发过程。无论你是编程新手还是有一定经验的开发者,这篇文章都将为你打开一扇通往数据收集新世界的大门。
|
2天前
|
测试技术 开发者 Python
探索Python中的装饰器:从入门到实践
【10月更文挑战第24天】 在Python的世界里,装饰器是一个既神秘又强大的工具。它们就像是程序的“隐形斗篷”,能在不改变原有代码结构的情况下,增加新的功能。本篇文章将带你走进装饰器的世界,从基础概念出发,通过实际例子,逐步深入到装饰器的高级应用,让你的代码更加优雅和高效。无论你是初学者还是有一定经验的开发者,这篇文章都将为你打开一扇通往高效编程的大门。
|
4天前
|
存储 人工智能 数据挖掘
Python编程入门:构建你的第一个程序
【10月更文挑战第22天】编程,这个听起来高深莫测的词汇,实际上就像搭积木一样简单有趣。本文将带你走进Python的世界,用最浅显的语言和实例,让你轻松掌握编写第一个Python程序的方法。无论你是编程新手还是希望了解Python的爱好者,这篇文章都将是你的理想起点。让我们一起开始这段奇妙的编程之旅吧!
12 3
|
3天前
|
机器学习/深度学习 人工智能 算法
机器学习基础:使用Python和Scikit-learn入门
机器学习基础:使用Python和Scikit-learn入门
9 1
|
3天前
|
Python
SciPy 教程 之 SciPy 模块列表 13
SciPy教程之SciPy模块列表13:单位类型。常量模块包含多种单位,如公制、二进制(字节)、质量、角度、时间、长度、压强、体积、速度、温度、能量、功率和力学单位。示例代码展示了如何使用`constants`模块获取零摄氏度对应的开尔文值(273.15)和华氏度与摄氏度的转换系数(0.5556)。
8 1
|
4天前
|
Python
SciPy 教程 之 SciPy 模块列表 9
SciPy教程之常量模块介绍,涵盖多种单位类型,如公制、质量、角度、时间、长度、压强等。示例展示了如何使用`scipy.constants`模块查询不同压强单位对应的帕斯卡值,包括atm、bar、torr、mmHg和psi。
8 1
|
4天前
|
Python
SciPy 教程 之 SciPy 模块列表 8
SciPy教程之常量模块单位类型介绍。该模块包含多种单位,如公制、质量、角度、时间、长度、压强、体积、速度、温度、能量、功率和力学单位。示例展示了部分长度单位的转换值,例如英寸、英尺、海里等。
9 1
|
1天前
|
Python
SciPy 教程 之 SciPy 模块列表 16
SciPy教程之SciPy模块列表16 - 单位类型。常量模块包含多种单位,如公制、质量、角度、时间、长度、压强、体积、速度、温度、能量、功率和力学单位。示例代码展示了力学单位的使用,如牛顿、磅力和千克力等。
4 0
|
1天前
|
JavaScript Python
SciPy 教程 之 SciPy 模块列表 15
SciPy 教程之 SciPy 模块列表 15 - 功率单位。常量模块包含多种单位,如公制、质量、时间等。功率单位中,1 瓦特定义为 1 焦耳/秒,表示每秒转换或耗散的能量速率。示例代码展示了如何使用 `constants` 模块获取马力值(745.6998715822701)。
6 0