超全！Python图形界面框架PyQt5使用指南！("全面详解：Python图形界面开发利器PyQt5使用手册！")

原创

ithorizon 7个月前 (10-20) 阅读数 14 #后端开发

全面详解：Python图形界面开发利器PyQt5使用手册！

一、引言

在软件开发中，图形用户界面（GUI）是连接用户与程序的桥梁。Python作为一门强劲的编程语言，提供了多种图形界面库，其中PyQt5是最受欢迎的一个。本文将为您全面介绍PyQt5的使用方法，帮助您飞速掌握Python图形界面开发。

二、PyQt5简介

PyQt5是一个用于创建桌面级GUI应用程序的跨平台工具集，它是Python与Qt5框架的结合体。Qt5是一个跨平台的C++库，用于开发具有图形用户界面的应用程序。PyQt5具有以下特点：

跨平台：赞成Windows、Linux、Mac OS等操作系统；

充裕的控件：提供多种控件，如按钮、文本框、列表框等；

事件驱动：基于事件驱动编程模型，易于实现繁复逻辑；

高性能：基于C++底层实现，运行速度快；

易用性：与Python语言无缝集成，使用明了。

三、PyQt5安装与配置

首先，确保您的Python环境已经安装了pip。然后，在命令行中执行以下命令安装PyQt5：

pip install PyQt5

安装完成后，您可以使用以下代码测试PyQt5是否安装胜利：


import sys
from PyQt5.QtWidgets import QApplication, QMainWindow
app = QApplication(sys.argv)
window = QMainWindow()
window.show()
sys.exit(app.exec_())

如果程序能够正常运行并显示一个空白的窗口，那么PyQt5已经胜利安装。

四、PyQt5基本用法

下面，我们将通过一个明了的例子来了解PyQt5的基本用法。

1. 创建主窗口

在PyQt5中，所有GUI应用程序的入口都是通过创建一个主窗口（QMainWindow）来实现的。以下代码创建了一个主窗口：


import sys
from PyQt5.QtWidgets import QApplication, QMainWindow
app = QApplication(sys.argv)
window = QMainWindow()
window.show()
sys.exit(app.exec_())

2. 设置窗口标题和大小

我们可以使用以下方法设置窗口的标题和大小：


window.setWindowTitle('PyQt5示例')
window.resize(400, 300)

3. 添加控件

在PyQt5中，控件是GUI应用程序的核心。以下代码向主窗口添加了一个按钮控件：


from PyQt5.QtWidgets import QPushButton
button = QPushButton('点击我', window)
button.move(100, 100)
button.clicked.connect(lambda: print('按钮被点击了'))

4. 运行程序

最后，使用以下代码启动事件循环，运行程序：


sys.exit(app.exec_())

五、PyQt5控件介绍

PyQt5提供了充裕的控件，以下是一些常用的控件及其用法。

1. 按钮（QPushButton）

按钮控件用于响应用户的点击事件。以下代码创建了一个按钮并设置了点击事件：


button = QPushButton('点击我', window)
button.move(100, 100)
button.clicked.connect(lambda: print('按钮被点击了'))

2. 文本框（QLineEdit）

文本框控件用于输入和显示文本。以下代码创建了一个文本框并设置了默认文本：


textEdit = QLineEdit('请输入文本', window)
textEdit.move(100, 150)

3. 标签（QLabel）

标签控件用于显示文本或图片。以下代码创建了一个标签并设置了文本：


label = QLabel('这是一个标签', window)
label.move(100, 200)

4. 列表框（QListWidget）

列表框控件用于显示一系列选项。以下代码创建了一个列表框并添加了几个选项：


listWidget = QListWidget(window)
listWidget.addItems(['选项1', '选项2', '选项3'])
listWidget.move(100, 250)

5. 复选框（QCheckBox）

复选框控件用于选择多个选项。以下代码创建了一个复选框并设置了文本：


checkBox = QCheckBox('复选框', window)
checkBox.move(100, 300)

六、PyQt5事件处理

在PyQt5中，事件处理是GUI应用程序的核心。事件可以是用户操作，如点击按钮、移动鼠标等，也可以是系统事件，如窗口关闭、计时器触发等。

1. 事件处理函数

事件处理函数是响应用户操作或系统事件的函数。以下是一个事件处理函数的例子：


def on_button_clicked():
    print('按钮被点击了')
button = QPushButton('点击我', window)
button.move(100, 100)
button.clicked.connect(on_button_clicked)

2. 事件传递

在PyQt5中，事件可以在控件之间传递。以下是一个事件传递的例子：


def on_button_clicked():
    print('按钮被点击了')
    label.setText('按钮被点击了')
button = QPushButton('点击我', window)
button.move(100, 100)
button.clicked.connect(on_button_clicked)
label = QLabel('', window)
label.move(100, 150)

3. 事件过滤

事件过滤允许您在事件到达目标控件之前截获并处理它。以下是一个事件过滤的例子：


def eventFilter(event):
    if event.type() == QEvent.FocusIn:
        print('文本框获得了焦点')
    return super().eventFilter(event)
textEdit = QLineEdit(window)
textEdit.installEventFilter(eventFilter)
textEdit.move(100, 200)

七、PyQt5布局管理

布局管理是PyQt5中一个非常重要的功能，它可以帮助您自动排列控件，适应不同大小的窗口。

1. 明了布局

以下代码演示了怎样使用QVBoxLayout和QHBoxLayout来创建一个明了的布局：


from PyQt5.QtWidgets import QVBoxLayout, QHBoxLayout
layout = QVBoxLayout()
layout.addWidget(button)
layout.addWidget(textEdit)
subLayout = QHBoxLayout()
subLayout.addWidget(label)
subLayout.addWidget(checkBox)
layout.addLayout(subLayout)
window.setLayout(layout)

2. 网格布局

网格布局（QGridLayout）允许您将控件放置在一个二维表格中。以下代码演示了怎样使用QGridLayout：


from PyQt5.QtWidgets import QGridLayout
layout = QGridLayout()
layout.addWidget(button, 0, 0)
layout.addWidget(textEdit, 0, 1)
layout.addWidget(label, 1, 0)
layout.addWidget(checkBox, 1, 1)
window.setLayout(layout)

八、PyQt5高级特性

PyQt5不仅提供了基本的控件和布局管理，还有一些高级特性，如信号与槽机制、多线程等。

1. 信号与槽

信号与槽是PyQt5中实现事件驱动编程的核心机制。以下代码演示了怎样使用信号与槽：


button.clicked.connect(lambda: print('按钮被点击了'))

2. 多线程

在PyQt5中，可以使用QThread类来实现多线程。以下代码演示了怎样创建一个线程并执行一个函数：


from PyQt5.QtCore import QThread, pyqtSignal
class Worker(QThread):
    finished_signal = pyqtSignal()
    def run(self):
        # 执行耗时操作
        print('线程开端工作')
        # ...
        self.finished_signal.emit()
worker = Worker()
worker.finished_signal.connect(lambda: print('线程工作完成'))
worker.start()