PyQt入门教程：从零开始学习PyQt – wiki基地

作者： /

PyQt入门教程：从零开始学习PyQt

PyQt是一个用于创建图形用户界面（GUI）的Python绑定库，它结合了Python的简洁性和Qt框架的强大功能。Qt是一个跨平台的C++应用程序开发框架，广泛应用于桌面、移动和嵌入式设备。通过PyQt，Python开发者可以利用Qt丰富的组件和工具，快速构建出功能强大、界面美观的应用程序。

本教程将引导你从零开始，逐步掌握PyQt的基础知识和常用组件。

1. 准备工作：安装PyQt

在开始之前，你需要安装Python和PyQt库。建议使用Python 3.x版本。

安装步骤：

  1. 安装Python： 如果你还没有安装Python，可以从Python官网下载并安装最新版本。

  2. 安装PyQt6（推荐）或PyQt5：

    • PyQt6: pip install PyQt6
    • PyQt5: pip install PyQt5

    本教程将主要以PyQt6为例进行讲解，但大部分概念和代码也适用于PyQt5，只需将PyQt6替换为PyQt5即可。

2. 第一个PyQt程序：Hello World!

让我们从一个经典的”Hello World!”程序开始，了解PyQt应用程序的基本结构。

“`python
import sys
from PyQt6.QtWidgets import QApplication, QWidget, QLabel, QVBoxLayout

def main():
# 1. 创建一个QApplication实例。QApplication管理GUI应用程序的控制流和主要设置。
app = QApplication(sys.argv)

# 2. 创建一个顶层窗口（QWidget）。QWidget是所有UI对象的基类。
window = QWidget()
window.setWindowTitle("PyQt Hello World")
window.setGeometry(100, 100, 400, 200) # x, y, width, height

# 3. 创建一个QLabel控件。QLabel用于显示文本或图片。
label = QLabel("Hello, PyQt!", window)

# 4. 创建一个垂直布局管理器。布局管理器用于自动安排控件的位置和大小。
layout = QVBoxLayout()
layout.addWidget(label) # 将label添加到布局中

# 5. 将布局设置给窗口。
window.setLayout(layout)

# 6. 显示窗口。
window.show()

# 7. 启动应用程序的事件循环。
# app.exec()会阻塞直到应用程序退出，处理所有用户事件。
sys.exit(app.exec())

if name == “main“:
main()
“`

代码解析：

  • QApplication(sys.argv): 这是每个PyQt应用程序都必须有的一个实例。它处理事件循环、应用程序的初始化和终结。sys.argv用于传递命令行参数。
  • QWidget(): 创建一个空白的窗口。
  • setWindowTitle(): 设置窗口的标题。
  • setGeometry(x, y, width, height): 设置窗口的位置和大小。
  • QLabel(): 创建一个标签控件，用于显示文本。
  • QVBoxLayout(): 创建一个垂直布局管理器，控件会垂直排列。PyQt提供了多种布局管理器，如QHBoxLayout（水平布局）、QGridLayout（网格布局）等。
  • layout.addWidget(label): 将标签添加到布局中。
  • window.setLayout(layout): 将布局设置给窗口，这样布局管理器就会负责管理窗口内的控件。
  • window.show(): 显示窗口。
  • sys.exit(app.exec()): 启动应用程序的事件循环。当用户关闭窗口时，app.exec()返回一个退出代码，然后sys.exit()退出程序。

运行这段代码，你将看到一个简单的窗口，上面显示着”Hello, PyQt!”。

3. 常用控件简介

PyQt提供了大量现成的控件（Widgets）供开发者使用，以下是一些最常用的：

  • QLabel: 显示文本或图像。
  • QPushButton: 一个可点击的按钮。
  • QLineEdit: 单行文本输入框。
  • QTextEdit: 多行文本输入框。
  • QCheckBox: 复选框。
  • QRadioButton: 单选按钮。
  • QComboBox: 下拉选择框。
  • QListWidget: 列表框。
  • QTableWidget: 表格控件。
  • QSlider: 滑动条。
  • QProgressBar: 进度条。

4. 信号与槽（Signals and Slots）

PyQt的核心机制之一是”信号与槽”（Signals and Slots）。当一个事件（如按钮点击、文本改变）发生时，控件会发出一个”信号”（Signal），你可以将这个信号连接到一个”槽”（Slot，可以是一个函数或方法），当信号发出时，对应的槽就会被执行。

示例：一个带按钮的计数器

“`python
import sys
from PyQt6.QtWidgets import QApplication, QWidget, QVBoxLayout, QPushButton, QLabel
from PyQt6.QtCore import Qt # 导入Qt枚举

class CounterApp(QWidget):
def init(self):
super().init()
self.setWindowTitle(“计数器”)
self.setGeometry(200, 200, 300, 150)

    self.count = 0
    self.init_ui()

def init_ui(self):
    layout = QVBoxLayout()

    self.label = QLabel(f"当前计数: {self.count}")
    self.label.setAlignment(Qt.AlignmentFlag.AlignCenter) # 文本居中
    layout.addWidget(self.label)

    button = QPushButton("增加计数")
    # 将按钮的clicked信号连接到increase_count方法（槽）
    button.clicked.connect(self.increase_count)
    layout.addWidget(button)

    self.setLayout(layout)

def increase_count(self):
    self.count += 1
    self.label.setText(f"当前计数: {self.count}")

def main():
app = QApplication(sys.argv)
ex = CounterApp()
ex.show()
sys.exit(app.exec())

if name == “main“:
main()
“`

代码解析：

  • 我们创建了一个名为CounterApp的类，它继承自QWidget，这样我们就可以自定义窗口的行为。
  • 在__init__方法中，初始化了计数器self.count并调用init_ui来构建界面。
  • QPushButton("增加计数")创建了一个按钮。
  • button.clicked.connect(self.increase_count)是信号与槽连接的关键。当button被点击时，它会发出clicked信号，这个信号会自动调用self.increase_count方法。
  • increase_count方法是一个槽，它负责更新self.count并更新QLabel显示的文本。

5. 布局管理器深入

良好的界面布局是用户体验的关键。PyQt提供了强大的布局管理器，让你无需手动计算每个控件的像素位置。

  • QHBoxLayout: 水平排列控件。
  • QVBoxLayout: 垂直排列控件。
  • QGridLayout: 在网格中排列控件。
  • QFormLayout: 用于创建表单，通常包含标签和对应的输入控件。

示例：使用QGridLayout

“`python
import sys
from PyQt6.QtWidgets import QApplication, QWidget, QGridLayout, QPushButton

class GridLayoutExample(QWidget):
def init(self):
super().init()
self.setWindowTitle(“网格布局示例”)
self.setGeometry(300, 300, 300, 200)
self.init_ui()

def init_ui(self):
    grid = QGridLayout()
    self.setLayout(grid)

    names = ['按钮1', '按钮2', '按钮3',
             '按钮4', '按钮5', '按钮6']

    positions = [(i, j) for i in range(2) for j in range(3)] # 0,0 0,1 0,2 1,0 1,1 1,2

    for position, name in zip(positions, names):
        button = QPushButton(name)
        grid.addWidget(button, *position) # 将按钮添加到指定行和列

def main():
app = QApplication(sys.argv)
ex = GridLayoutExample()
ex.show()
sys.exit(app.exec())

if name == “main“:
main()
“`

在这个例子中，我们创建了6个按钮，并使用QGridLayout将它们排列成2行3列的网格。grid.addWidget(widget, row, column)方法用于将控件放置到网格的特定位置。

6. 使用Qt Designer创建UI

对于复杂的界面，手动编写布局代码可能会变得繁琐。Qt Designer是一个可视化工具，允许你通过拖放的方式设计UI，然后生成.ui文件。你可以使用pyuic6（或pyuic5）工具将.ui文件转换为Python代码。

步骤：

  1. 安装Qt Designer： PyQt的安装通常不包含Qt Designer。你需要单独安装Qt开发工具。对于Windows用户，可以尝试安装Qt Creator，它包含了Qt Designer。
  2. 设计UI： 打开Qt Designer，创建一个新的主窗口或对话框，然后拖放控件，调整属性和布局。
  3. 保存.ui文件： 将设计好的界面保存为例如my_form.ui。
  4. 转换.ui文件： 在命令行中运行：
    bash
    pyuic6 -o my_form_ui.py my_form.ui
    # 或者对于PyQt5
    # pyuic5 -o my_form_ui.py my_form.ui
    这会生成一个my_form_ui.py文件，其中包含了UI界面的Python代码。

  5. 在你的应用中使用：
    “`python
    import sys
    from PyQt6.QtWidgets import QApplication, QMainWindow
    from my_form_ui import Ui_MainWindow # 假设生成的类名为Ui_MainWindow

    class MyMainWindow(QMainWindow, Ui_MainWindow):
    def init(self):
    super().init()
    self.setupUi(self) # 调用setupUi方法初始化UI

        # 现在你可以访问UI文件中的控件了，例如：
    # self.myButton.clicked.connect(self.some_method)

    def main():
    app = QApplication(sys.argv)
    window = MyMainWindow()
    window.show()
    sys.exit(app.exec())

    if name == “main“:
    main()
    ``
    通过继承    QMainWindow和Ui_MainWindow`，你可以方便地在自己的Python类中使用Qt Designer设计的界面。

7. 深入学习资源

  • PyQt官方文档： 查阅PyQt的官方文档是深入学习的最佳途径，它提供了所有类和方法的详细说明。
  • Qt官方文档： 虽然是C++文档，但由于PyQt是Qt的绑定，很多概念和示例在PyQt中同样适用。
  • 在线教程和书籍： 许多网站和书籍提供了PyQt的教程和项目案例。

总结

本教程为你提供了PyQt入门的基础知识，包括：

  • PyQt的安装
  • 第一个”Hello World”程序
  • 常用控件的介绍
  • 信号与槽机制
  • 布局管理器的使用
  • 以及如何利用Qt Designer辅助UI设计

掌握这些基础后，你就可以开始构建自己的PyQt应用程序了。PyQt的功能远不止于此，它还支持数据库集成、网络编程、多线程、图形视图框架等高级特性，等待你去探索。祝你学习愉快！

滚动至顶部