程序员文章、书籍推荐和程序员创业信息与资源分享平台

网站首页 > 技术文章 正文

Python图形化应用开发框架:PyQt开发简介

hfteth 2025-07-21 14:11:32 技术文章 3 ℃

PyQt概述

定义:PyQt是Python绑定Qt框架的工具集,用于开发跨平台GUI应用程序
原理:通过Qt的C++库提供底层功能,PyQt使用SIP工具生成Python绑定
特点

  • 支持Windows/macOS/Linux
  • 超过620个类
  • 同时支持Qt4/Qt5
  • MIT/GPL双协议

环境搭建

安装方法

pip install PyQt5 PyQt5-tools

组件说明

组件

功能

PyQt5

核心库

PyQt5-tools

设计工具

Qt Designer

可视化设计器

pyuic5

.ui转.py工具

验证安装

import sys
from PyQt5.QtWidgets import QApplication, QLabel

app = QApplication(sys.argv)
label = QLabel("Hello PyQt!")
label.show()
sys.exit(app.exec_())

核心组件

1 QWidget

原型

class QWidget(QObject, QPaintDevice):
    def __init__(self, parent: QWidget = None, flags: Qt.WindowFlags = Qt.WindowFlags())

功能:所有GUI组件的基类
参数

  • parent:父组件
  • flags:窗口特性标志

注意事项

  • 顶级窗口parent=None
  • 内存管理采用父子对象机制

2 QMainWindow

核心区域

关键方法

setCentralWidget(widget)  # 设置中央部件
statusBar().showMessage("Ready")  # 状态栏消息
addToolBar("File")  # 添加工具栏

布局管理

布局类型

  1. QHBoxLayout:水平布局
  2. QVBoxLayout:垂直布局
  3. QGridLayout:网格布局
  4. QFormLayout:表单布局

使用规范

layout = QVBoxLayout()
layout.addWidget(button1)
layout.addWidget(button2)
container = QWidget()
container.setLayout(layout)

布局嵌套示例

信号与槽机制

原理:事件驱动编程模型
定义

  • 信号(Signal):事件发生时发出的通知
  • 槽(Slot):响应信号的函数

连接方式

button.clicked.connect(self.handle_click)

def handle_click(self):
    print("Button clicked!")

自定义信号

class Worker(QObject):
    finished = pyqtSignal()
    
    def run(self):
        # 执行任务
        self.finished.emit()

常用控件

控件对比表: 表1:常用控件功能对照

控件

类名

主要功能

按钮

QPushButton

触发操作

标签

QLabel

显示文本/图片

输入框

QLineEdit

单行文本输入

列表框

QListWidget

列表数据展示

表格

QTableWidget

表格数据展示

QTableWidget使用示例

table = QTableWidget(5, 3)  # 5行3列
table.setHorizontalHeaderLabels(["ID", "Name", "Score"])
table.setItem(0, 0, QTableWidgetItem("001"))
table.setItem(0, 1, QTableWidgetItem("Alice"))

事件处理

事件类型

  • 鼠标事件:QMouseEvent
  • 键盘事件:QKeyEvent
  • 窗口事件:QResizeEvent

事件处理方式

def mousePressEvent(self, event):
    if event.button() == Qt.LeftButton:
        print("Left click at", event.pos())

事件过滤器

app.installEventFilter(self)

def eventFilter(self, obj, event):
    if event.type() == QEvent.KeyPress:
        print("Key pressed:", event.key())
    return super().eventFilter(obj, event)

样式与主题

QSS语法

QPushButton {
    background-color: #4CAF50;
    border-radius: 5px;
    color: white;
    padding: 8px;
}
QPushButton:hover {
    background-color: #45a049;
}

应用样式

app.setStyleSheet(open("style.qss").read())

常用样式属性

属性

说明

示例

background

背景

#FFFFFF

border

边框

1px solid gray

font

字体

bold 14px Arial

qproperty

控件属性

qproperty-alignment: AlignCenter

多线程编程

QThread使用模式

Worker线程示例

class Worker(QThread):
    progress = pyqtSignal(int)
    
    def run(self):
        for i in range(101):
            time.sleep(0.1)
            self.progress.emit(i)

注意事项

  • 禁止在工作线程操作GUI
  • 使用信号进行线程间通信
  • 使用QMutex进行资源锁定

数据库集成

数据库操作流程

QSqlTableModel示例

model = QSqlTableModel()
model.setTable("employees")
model.setEditStrategy(QSqlTableModel.OnFieldChange)
model.select()

table = QTableView()
table.setModel(model)

示例:文本编辑器

功能设计

  • 文件操作(新建/打开/保存)
  • 文本编辑(复制/粘贴)
  • 格式设置(字体/颜色)
  • 查找替换

核心代码结构

class TextEditor(QMainWindow):
    def __init__(self):
        super().__init__()
        # 创建菜单
        file_menu = self.menuBar().addMenu("文件")
        file_menu.addAction("新建", self.new_file)
        
        # 创建工具栏
        toolbar = self.addToolBar("编辑")
        toolbar.addAction("复制", self.text_edit.copy)
        
        # 中央文本编辑区
        self.text_edit = QTextEdit()
        self.setCentralWidget(self.text_edit)
        
        # 状态栏
        self.statusBar().showMessage("就绪")

文件保存实现

def save_file(self):
    filename, _ = QFileDialog.getSaveFileName(self, "保存文件", "", "文本文件 (*.txt)")
    if filename:
        with open(filename, 'w') as f:
            f.write(self.text_edit.toPlainText())
        self.statusBar().showMessage(f"文件已保存: {filename}")

打包与发布

PyInstaller使用

pyinstaller --windowed --icon=app.ico main.py

打包参数

参数

说明

--onefile

单文件打包

--windowed

无控制台窗口

--add-data

添加资源文件

--icon

设置图标

跨平台注意事项

  1. Windows:处理病毒误报
  2. macOS:处理签名问题
  3. Linux:处理依赖库版本

学习路线图

学习资源

  1. 官方文档:https://www.riverbankcomputing.com/static/Docs/PyQt5/
  2. 《PyQt5快速开发与实战》
  3. GitHub示例库:PyQt5-Examples

总结

通过本教材的系统学习,我们可以掌握PyQt开发的核心技能,能够独立开发跨平台的桌面应用程序。继续深入实践,您将成为GUI开发领域的专家!

学习建议

  1. 从简单项目开始逐步迭代
  2. 善用Qt Designer提高效率
  3. 阅读官方示例代码
  4. 参与开源项目贡献
  5. 定期关注Qt版本更新

#编程# #学习# #python# #在头条记录我的2025#


Tags:

最近发表
标签列表