Python编程及项目开发课件 第5章 GUI编程

5.PythonGUI编程：从基础到实践基于PyQt5的界面开发完全指南目录01.PyQt5基础入门介绍PyQt5的安装、配置及第一个GUI程序。02.信号与槽机制深入理解Qt的核心通信机制。03.常用界面控件学习按钮、文本框、列表等基础控件的使用。04.界面布局管理掌握如何使用布局管理器设计美观的界面。05.高级界面组件探索菜单、工具栏、对话框等高级组件。06.综合项目实战通过一个完整的项目，综合运用所学知识。01PyQt5基础入门万丈高楼平地起，从环境搭建开始我们的GUI之旅。什么是GUI编程？核心定义图形用户界面（GUI）是采用图形方式显示的计算机操作用户界面，替代了传统的命令行交互。界面组成典型的GUI应用通常包含窗口、菜单、按钮、文本框、图标等可视化交互元素。主要优势操作直观、易于上手，用户无需记忆复杂的命令，极大地降低了使用门槛。Python的GUI库选择TkinterPython标准库，无需额外安装轻量级，适合快速开发简单工具界面风格较旧，缺乏现代感wxPython原生感强，完美贴合操作系统风格功能丰富，控件数量庞大学习曲线较陡，API相对复杂PyQt5(推荐)功能最强大、最成熟的GUI库之一支持跨平台，界面现代美观支持QtDesigner可视化拖拽设计为什么选择PyQt5？强大的功能基于Qt框架，拥有数千个API接口，几乎能满足所有开发需求。跨平台兼容一次编写，到处运行。原生支持Windows,macOS,Linux系统。现代界面设计支持CSS样式表，轻松实现美观、现代化的UI界面美化。可视化开发集成QtDesigner工具，所见即所得，大幅提升界面开发效率。活跃的社区拥有丰富的官方文档和第三方资源，遇到问题能快速找到解决方案。综合性能优异结合了Python的简洁与C++的高性能，是桌面应用开发的理想选择。PyQt5的核心模块QtCore提供核心非GUI功能，如事件循环、线程管理、定时器等基础架构。QtGui负责图形相关类，包括窗口系统集成、事件处理、2D图形绘制等。QtWidgets(核心)包含丰富的UI元素集合，如按钮、文本框、布局管理器，是构建界面的基础。QtMultimedia提供多媒体功能支持，包括音频、视频的播放与录制，以及摄像头集成。QtNetwork封装了底层网络协议，提供TCP/IP、UDP等高级网络编程接口，简化通信开发。QtSql提供数据库操作的类，支持SQLite、MySQL、PostgreSQL等多种数据库系统。PyQt5安装：命令行方式#安装PyQt5核心库$pipinstallPyQt5#安装工具包(含QtDesigner)$pipinstallPyQt5-tools安装核心库使用pip命令安装PyQt5核心模块，这是构建PythonGUI应用的基础。安装开发工具安装PyQt5-tools，包含QtDesigner等可视化设计工具，提升开发效率。PyQt5安装：PyCharm方式打开设置面板通过顶部菜单栏File进入Settings选项。定位解释器设置在项目设置中找到Project->PythonInterpreter。搜索并安装PyQt5点击右侧+号，搜索PyQt5并执行安装。配置QtDesigner外部工具1.导航至外部工具设置路径：File->Settings->Tools->ExternalTools2.添加新工具并配置路径点击+号，设置Program为Python目录下的designer.exe路径3.设置工作目录Workingdirectory设置为$FileDir$，确保文件在当前目录读写配置PyUIC外部工具添加外部工具在PyCharm的Settings->Tools->ExternalTools中新建工具。设置Program路径将Program参数指向系统中Python解释器的路径(python.exe)。配置转换参数Parameters输入以下命令以实现.ui转.py代码：-mPyQt5.uic.pyuic$FileName$-o$FileNameWithoutExtension$.py第一个PyQt5程序：HelloWorldhello_world.py#-*-coding:utf-8-*-importsysfromPyQt5.QtWidgetsimportQApplication,QLabel,QMainWindowclassMainWindow(QMainWindow):def__init__(self):super().__init__()self.setWindowTitle("PyQt5第一个窗口")label=QLabel("Hello,World!",self)self.setCentralWidget(label)if__name__=="__main__":app=QApplication(sys.argv)window=MainWindow()window.show()sys.exit(app.exec_())代码解析QApplication(sys.argv)创建应用程序对象，管理应用的控制流和主要设置，是程序的入口核心。QMainWindow()创建一个主窗口，这是大多数应用的基础，提供了菜单栏、工具栏等标准UI框架。QLabel("Hello")创建一个标签控件，用于显示文本或图片，是最基础的界面显示元素。setCentralWidget()将标签设置为窗口的中心部件，定义了主窗口的核心内容区域布局。window.show()显示窗口。在调用此方法前，窗口对象虽然存在于内存中，但用户是不可见的。app.exec_()进入应用的事件循环，等待用户交互（如点击、关闭），保持程序运行状态。运行结果运行代码后，窗口中央将显示"Hello,World!"，标志着程序成功启动。使用QtDesigner设计界面可视化拖拽设计无需编写代码，通过拖拽控件的方式快速构建界面，所见即所得。核心功能模块控件箱：提供按钮、文本框等各类UI组件设计区：可视化布局编辑的主画布属性编辑器：实时修改控件的外观与参数对象查看器：管理界面中的所有对象层级实战：设计一个登录界面新建窗口启动QtDesigner，创建一个Widget类型的基础窗口作为容器。布局控件从左侧控件箱拖入Label(用户名/密码)、LineEdit(输入框)及PushButton(按钮)。属性配置在右侧属性编辑器中，修改控件的显示文本(text)和对象名称(objectName)。保存文件完成界面设计后，将文件保存为login.ui，这是一个记录界面信息的XML文件。将.ui文件转换为.py文件方法一：PyCharm图形化操作右键点击.ui文件选择ExternalTools->PyUIC自动生成同名.py文件方法二：命令行终端执行pyuic5-ologin.pylogin.ui直接在终端执行命令，适用于习惯命令行操作的开发者。运行登录界面运行转换后的login.py文件，界面已完美呈现。但目前按钮点击等交互功能尚未实现，需后续通过信号与槽机制完善。02信号与槽机制理解Qt的灵魂，掌握对象间通信的核心方式Qt的核心：信号与槽信号(Signal)对象状态改变时发出的通知。例如，按钮被点击时会发出clicked信号。槽(Slot)接收信号并执行相应操作的函数。这是一个普通的Python函数。连接(Connect)将信号与槽关联起来的动作。当信号发出时，对应的槽函数会被自动调用。信号与槽的强大特性一对多连接一个信号可以连接到多个槽函数，当信号发出时，所有连接的槽都会被依次执行。多对一响应多个不同的信号可以连接到同一个槽函数，实现不同操作触发同一逻辑响应。信号链式触发信号不仅可以连接槽，还可以连接另一个信号，形成信号链，实现复杂的事件流转。连接灵活可控支持随时动态断开信号与槽的连接，这种松耦合设计极大提升了代码的可维护性。响应按钮点击：信号与槽实践button_click.pyimportsysfromPyQt5.QtWidgetsimportQApplication,QWidget,QPushButton

classMyWindow(QWidget):definitUI(self):self.button=QPushButton("点击我")#核心：连接信号与槽self.button.clicked.connect(self.on_button_clicked)

defon_button_clicked(self):print("按钮被点击了！")核心连接机制关键代码：.clicked.connect(func)这行代码将按钮的点击信号（Signal）与自定义的槽函数（Slot）进行绑定，实现交互响应。点击执行流程1.用户点击界面上的按钮。2.触发clicked信号。3.自动调用on_button_clicked函数。4.控制台打印：按钮被点击了！代码解析：信号与槽机制信号(Signal)self.button.clicked这是按钮对象发出的原生信号，代表“被点击”这一事件的发生。连接(Connect).connect(...)这是信号的核心方法，用于建立信号与槽函数之间的绑定关系。槽函数(Slot)self.on_btn_clicked自定义的成员函数。当信号触发时，该函数会被系统自动调用执行。运行结果交互响应验证运行程序后，界面将显示一个包含按钮的窗口。

每当点击窗口中的按钮，控制台（终端）将实时输出：

“按钮被点击了！”带参数的信号与槽实现方案：Lambda表达式桥接#1.定义带参数的槽函数defsay_hello(self,name):print(f"你好,{name}!")

#2.使用Lambda传递参数self.button.clicked.connect(lambda:self.say_hello("PyQt5"))核心原理与技巧信号参数不匹配问题如clicked信号无参数，但槽函数需要接收参数，直接连接会报错。Lambda作为中间桥梁利用匿名函数lambda包裹带参函数调用，实现参数的传递与适配。执行流程信号触发→执行Lambda→调用带参槽函数。自定义信号(CustomSignals)fromPyQt5.QtCoreimportpyqtSignalclassMyWindow(QWidget):#定义一个自定义信号，可传递字符串参数my_signal=pyqtSignal(str)def__init__(self):super().__init__()self.my_signal.connect(self.handle_signal)self.my_signal.emit("HelloCustomSignal")1.信号定义作为类属性定义，指定参数类型（如str,int），用于组件间的灵活通信。2.信号连接使用connect()方法将自定义信号绑定到槽函数，建立触发逻辑。3.信号发射调用emit()方法并传入参数，触发绑定的槽函数执行。03常用界面控件掌握构建界面的基本砖块，从按钮到文本框按钮控件QPushButton常用属性(Properties)text/icon：设置按钮显示的文本内容与图标资源enabled：控制按钮是否可用，False时呈灰色不可点击状态常用信号(Signals)clicked/pressed/released：分别在点击、按下、释放时触发标签控件QLabel常用功能概览显示普通文本与富文本(HTML格式)加载并显示图片资源支持超链接跳转与交互核心API方法setText():设置显示文本内容setPixmap():加载QPixmap对象显示图片setOpenExternalLinks():启用超链接外部跳转单行文本框QLineEdit常用方法(Methods)setText()/text():设置与获取文本内容setPlaceholderText():设置占位提示文字常用信号(Signals)textChanged:文本内容发生改变时触发returnPressed:按下回车键时触发多行文本框QTextEdit核心用途用于输入和显示多行文本，支持换行、滚动条等基本编辑功能，是构建日志或聊天窗口的理想组件。常用方法setPlainText()-设置文本框的初始内容toPlainText()-获取用户输入的所有文本append()-在文本末尾追加新内容复选框QCheckBox常用方法(Methods)isChecked():判断复选框是否被选中setChecked(bool):设置复选框的选中状态常用信号(Signals)stateChanged:状态改变时触发(0=未选,2=选中)单选按钮QRadioButton常用方法isChecked()：获取按钮选中状态setChecked()：设置按钮选中状态互斥机制说明需配合QButtonGroup使用以实现组内互斥同一组内同时只能有一个按钮被选中列表控件QListWidget常用方法(Methods)addItem():向列表中添加字符串项currentItem().text():获取当前选中项文本selectedItems():获取所有选中项的列表常用信号(Signals)itemClicked:列表项被点击时触发currentItemChanged:当前选中项改变时触发图示：QListWidget控件界面示例组合框QComboBox核心方法MethodsaddItem():添加下拉列表项currentText():获取当前选中的文本内容currentIndex():获取当前选中项的索引(从0开始)关键信号SignalscurrentTextChanged:选项改变时触发，传递新文本滑块控件QSlider常用属性(Properties)minimum/maximum:设置数值范围的边界value:获取或设置滑块的当前数值常用信号(Signals)valueChanged:滑块值改变时触发，传递当前数值滑块控件交互逻辑示意图进度条QProgressBar核心方法(CoreMethods)setRange(min,max):设置进度范围（如0-100）setValue(value):更新当前进度值setFormat():自定义显示格式（如百分比）应用场景(Usage)用于直观展示耗时任务的完成进度，如文件下载、数据处理、批量转换等，提升用户体验。图示：界面组件交互效果示意04界面布局管理告别固定位置，让界面自适应各种窗口大小为什么需要布局管理器？固定布局的痛点控件位置绝对固定，缺乏灵活性。当窗口缩放或在不同分辨率屏幕上显示时，极易出现控件重叠、遮挡甚至溢出的问题，导致界面错乱。布局管理器的优势自动计算并调整控件的大小与位置。无论窗口如何缩放，都能保持控件间的合理间距和布局完整性，完美适配各种屏幕尺寸。布局管理器分类QHBoxLayout水平布局管理器，将控件从左到右依次排列，适合构建横向工具栏或导航栏。QVBoxLayout垂直布局管理器，将控件从上到下依次排列，适合构建纵向的表单或列表页面。QGridLayout网格布局管理器，控件按行和列排列，如同表格，适用于规则的复杂界面布局。QFormLayout表单布局管理器，专门用于标签和输入框的配对，简化了表单界面的创建。QStackedLayout栈式布局管理器，如同堆叠的卡片，一次只显示一个控件，常用于实现选项卡。水平布局QHBoxLayout基础使用方法创建QHBoxLayout对象，调用addWidget()方法将控件依次添加，即可实现控件的水平排列。拉伸因子(StretchFactor)通过addWidget(widget,stretch)设置权重，控制控件在布局中所占的空间比例，实现灵活的自适应布局。垂直布局QVBoxLayout基本使用方法与QHBoxLayout类似，创建对象后通过addWidget()方法将控件从上到下垂直添加到布局中。垂直空间分配(Stretch)支持设置拉伸因子(StretchFactor)，精确控制控件在垂直方向上的高度比例分配。网格布局QGridLayout核心使用方法通过addWidget(widget,row,col,rowSpan,colSpan)方法，将控件精确添加到指定行列，并支持设置跨行(rowSpan)和跨列(colSpan)。场景优势非常适合构建规则的表单界面（如登录页、设置页），能将标签和输入框等元素进行矩阵式排列，结构清晰，扩展性强。表单布局QFormLayout核心使用方法调用addRow(label,field)方法，直接将标签控件和输入框控件配对添加，自动完成布局。设计优势比QGridLayout更简洁专注，专为表单场景优化，自动处理标签与字段的对齐逻辑。布局的嵌套核心概念将一个布局管理器作为一个“控件”整体，添加到另一个布局管理器中，实现层级组合。实现方式通过addLayout()方法将子布局添加到父布局中，像搭积木一样组合界面结构。主要优势将复杂界面分解为简单子模块，极大提升代码的可维护性，支持构建任意复杂度的UI。在QtDesigner中使用布局1.选中目标控件在设计区按住Ctrl键，选中需要进行统一布局的多个控件。2.应用布局方式点击工具栏中的布局按钮（水平、垂直或网格），系统将自动生成布局管理。3.窗口自适应设置对顶层窗口应用布局，确保窗口大小改变时，内部控件能自动调整位置和大小。QtDesigner工具栏布局按钮示意05高级界面组件探索菜单、工具栏、对话框等更丰富的界面元素，构建专业级桌面应用。主窗口QMainWindow菜单栏(MenuBar)位于窗口顶部，包含文件、编辑等各种操作命令。工具栏(ToolBar)通常在菜单栏下方，提供常用命令的快捷按钮。中心部件(CentralWidget)窗口的主要工作区域，承载应用的核心功能界面。状态栏(StatusBar)位于窗口底部，显示当前状态、提示信息或进度。停靠窗口(DockWidget)可停靠在主窗口四周的辅助窗口，提供额外功能。创建菜单栏#创建菜单栏menu_bar=self.menuBar()#创建菜单file_menu=menu_bar.addMenu("文件(&F)")#创建菜单项（动作）new_action=QAction(QIcon("new.png"),"新建",self)new_action.triggered.connect(self.new_file)

#将动作添加到菜单file_menu.addAction(new_action)file_menu.addSeparator()核心对象构建使用QMenuBar获取主窗口菜单，通过addMenu方法创建具体的菜单对象。动作与信号连接QAction封装了菜单项的文本、图标及triggered信号，连接至对应槽函数。布局与分组使用addAction添加菜单项，通过addSeparator添加分隔线进行视觉分组。创建工具栏#创建工具栏tool_bar=self.addToolBar("MainToolbar")

#将已有的QAction添加到工具栏tool_bar.addAction(new_action)tool_bar.addAction(open_action)

#工具栏也可以添加按钮tool_bar.addWidget(QPushButton("点击"))复用QAction功能直接将为菜单创建的QAction对象添加到工具栏，共享同一个信号与槽连接，实现功能复用。灵活添加任意控件通过addWidget()方法，工具栏可以像普通布局一样，添加任何其他独立控件，如按钮或输入框。使用状态栏(QStatusBar)main.py#1.显示临时信息(2秒后消失)self.statusBar().showMessage("就绪",2000)#2.添加永久显示控件self.status_label=QLabel("欢迎使用")self.statusBar().addPermanentWidget(self.status_label)#3.清除当前消息#self.statusBar().clearMessage()临时状态提示使用showMessage()方法显示操作反馈或进度，设置超时时间（毫秒）后自动消失，不阻塞界面。永久信息展示通过addPermanentWidget()方法，可将QLabel等控件固定在状态栏右侧，常用于显示版本号、用户名等常驻信息。获取状态栏对象在QMainWindow中，使用self.statusBar()方法获取状态栏实例。首次调用会自动创建状态栏。消息对话框QMessageBox信息提示框(Information)QMessageBrmation(self,"标题","信息内容")询问确认框(Question)QMessageBox.question(self,"标题","确认吗？",Yes|No)警告提示框(Warning)QMessageBox.warning(self,"标题","警告内容")错误提示框(Critical)QMessageBox.critical(self,"标题","错误内容")文件对话框QFileDialoggetOpenFileName()打开文件对话框，支持单选或多选文件getSaveFileName()保存文件对话框，自动提示文件覆盖确认getExistingDirectory()选择文件夹路径，获取用户指定的目录返回值：用户选择的文件路径字符串及过滤器颜色对话框QColorDialog核心代码实现#1.弹出颜色选择对话框color=QColorDialog.getColor()#2.判断用户是否点击了OK按钮ifcolor.isValid():#3.应用颜色，例如设置背景色self.widget.setStyleSheet(f"background-color:{()};")字体对话框QFontDialog核心代码逻辑#弹出字体选择对话框并获取结果font,ok=QFontDialog.getFont()ifok:self.label.setFont(font)#应用选择的字体关键说明getFont()返回QFont对象和布尔值okok为True时，表示用户确认了字体选择界面效果演示06综合项目实战将所学知识融会贯通，开发一个完整的记事本应用项目需求分析核心功能模块文件操作支持新建、打开、保存及另存为文件功能文本编辑基于QTextEdit实现复制、粘贴、撤销/重做格式设置支持更改选中文本的字体样式与颜色帮助支持显示关于对话框，提供软件版本及作者信息界面结构要求标准菜单栏包含文件、编辑、格式、帮助等标准菜单项快捷工具栏提供常用操作的图标按钮，提升操作效率主编辑区域全屏显示的文本编辑区，支持多行输入与滚动底部状态栏实时显示光标位置、文档状态等辅助信息项目界面设计标准菜单栏文件/编辑/格式/帮助快捷工具栏新建/打开/保存/撤销核心编辑区QTextEdit占据主要工作区代码实现：主窗口#导入必要的库和UI类importsysfromPyQt5.QtWidgetsimport(QApplication,QMainWindow,QTextEdit)fromui_notepadimportUi_MainWindowclassNotepad(QMainWindow,Ui_MainWindow):def__init__(self):super().__init__()self.setupUi(self)#初始化UI界面self.current_file=Noneself.init_menu_actions()核心逻辑：继承QMainWindow与Ui_MainWindow，在__init__中完成界面构建与信号连接代码实现：功能函数基础文件操作(New&Save)defnew_file(self):self.textEdit.clear()self.current_file=Noneself.setWindowTitle("未命名")defsave_file(self):ifnotself.current_file:self.save_as_file()withopen(self.current_file,'w')asf:f.write(self.textEdit.toPlainText())文件读取操作(OpenFile)defopen_file(self):path,_=QFileDialog.getOpenFileName()ifpath:withopen(path,'r')asf:content=f.read()self.textEdit.setPlain