PyQt 入门:打造你的第一个 Python 桌面应用

1,081 阅读3分钟

PyQt 是什么?

PyQt 是一个跨平台的 Python GUI 库,它基于著名的 Qt 框架。简单来说,PyQt 可以让你用 Python 代码轻松创建美观、功能强大的桌面应用程序。无论是简单的工具软件,还是复杂的管理系统,PyQt 都能胜任。

为什么选择 PyQt?

  • 强大易用: PyQt 提供丰富的组件和功能,让你轻松构建各种界面元素,例如按钮、文本框、表格、菜单等等。
  • 跨平台: 使用 PyQt 编写的应用程序可以在 Windows、macOS、Linux 等多个平台上运行,无需修改代码。
  • 成熟稳定: PyQt 是一个经过多年发展和完善的库,拥有庞大的社区和丰富的文档,可以帮助你快速解决问题。

安装 PyQt

在开始开发之前,首先需要安装 PyQt。可以通过 pip 命令快速安装:

pip install PyQt5

如果你需要安装最新版本的 PyQt,也可以使用以下命令:

pip install PyQt6

创建第一个 PyQt 应用

接下来,我们将创建一个简单的窗口应用程序,展示如何使用 PyQt 构建一个基本的 GUI 窗口。

1. 导入必要的模块

在 PyQt 中,所有的 UI 元素都是通过对象的方式来管理的。首先,我们需要导入 PyQt5.QtWidgets 模块中的一些核心类:

import sys
from PyQt6.QtWidgets import QApplication, QWidget
  • QApplication 是 PyQt 应用程序的核心类,用于管理应用的生命周期。
  • QWidget 是所有用户界面元素的基类,几乎所有 UI 组件都继承自这个类。

2. 创建应用实例和窗口

接下来,我们创建一个简单的窗口类,并启动应用:


def main():
    app = QApplication(sys.argv)  # 创建一个应用实例
    window = QWidget()  # 创建一个窗口实例
    window.setWindowTitle("我的第一个 PyQt 应用")  # 设置窗口标题
    window.setGeometry(100, 100, 400, 300)  # 设置窗口位置和大小
    window.show()  # 显示窗口
    sys.exit(app.exec())  # 启动应用程序事件循环

if __name__ == '__main__':
    main()

3. 运行程序

运行上述代码后,你将看到一个简单的窗口弹出,窗口标题为 "我的第一个 PyQt 应用",并且窗口大小为 400x300。

扩展功能:添加按钮

接下来,我们将为这个窗口添加一个按钮。按钮点击后会改变窗口的标题。

1. 导入按钮组件

首先,我们需要导入 QPushButton 类,它是 PyQt 中最常用的按钮控件:

from PyQt6.QtWidgets import QPushButton

2. 创建按钮并设置事件

我们可以创建一个按钮,并为它设置点击事件:

def main():
    app = QApplication(sys.argv)  # 创建应用程序实例
    window = QWidget()  # 创建窗口实例
    window.setWindowTitle("PyQt Button 示例")  # 设置窗口标题
    window.setGeometry(100, 100, 400, 300)  # 设置窗口大小

    # 创建一个按钮
    button = QPushButton("点击我", window)  # 按钮文本为 "点击我"
    button.setGeometry(150, 120, 100, 50)  # 设置按钮的位置和大小

    # 定义按钮点击后的事件
    def on_button_click():
        window.setWindowTitle("按钮已点击!")

    # 连接按钮点击事件到处理函数
    button.clicked.connect(on_button_click)

    window.show()  # 显示窗口
    sys.exit(app.exec_())  # 启动事件循环

if __name__ == '__main__':
    main()

3. 运行并测试

现在,你的窗口上将显示一个按钮,按钮的文本为“点击我”。当用户点击按钮时,窗口的标题将变为“按钮已点击!”。