PyQt5的QtWidgets模块介绍

PyQt5.QtWidgets模块详解：主要类与用法

最新推荐文章于 2025-09-15 08:26:27 发布

原创

最新推荐文章于 2025-09-15 08:26:27 发布 · 8.6k 阅读

71 ·

CC 4.0 BY-SA版权

文章标签：

#python #开发语言 #qt

本文介绍了PyQt5的QtWidgets模块，包括QApplication、QMainWindow、QWidget等主要类的用法，展示了如何创建GUI应用的基本控件，如标签、按钮、文本框、下拉框等，帮助开发者了解如何在Python中构建图形用户界面。

前言

PyQt5是一款Python语言的GUI编程工具包，基于Qt库开发。Qt是一个跨平台的C++应用程序开发框架，可以用于开发桌面应用程序、移动应用程序、嵌入式应用程序等。PyQt5可以帮助开发者快速构建出美观、现代化的用户界面，并且支持多种操作系统平台，如Windows、Linux、MacOS等。PyQt5还提供了许多丰富的功能和工具，下面本文就介绍下其中最常用的模块PyQt5.QtWidgets, 它包含了GUI界面的所有窗口的控件。

一、PyQt5的QtWidgets介绍

PyQt5的QtWidgets模块包含了很多类，用于创建GUI应用程序的各种控件和窗口部件。其中一些主要的类包括：

QApplication：应用程序类，负责管理应用程序的控制流程和事件循环。
QMainWindow：主窗口类，提供了一个应用程序的主界面。
QWidget：窗口部件类，是所有用户界面元素的基类。
QLabel：标签类，用于显示文本或图像。
QPushButton：按钮类，用于触发事件。
QLineEdit：单行文本框类，用于输入单行文本。
QTextEdit：多行文本框类，用于输入和显示多行文本。
QComboBox：下拉框类，用于选择列表中的一个选项。
QSpinBox：微调框类，用于输入和显示数字。
QCheckBox：复选框类，用于选择一个或多个选项。
QRadioButton：单选框类，用于选择一个选项。
QProgressBar：进度条类，用于显示任务的进度。
QSlider：滑块类，用于调整数值。
QTableWidget：表格类，用于显示和编辑表格数据。
QTreeView：树形视图类，用于显示树形结构。
QDockWidget：停靠窗口类，用于显示可停靠的窗口。

二、主要类的用法

下面我会对上面提到的所有模块都进行一个简单的举例说明。

1.QApplication

import sys
from PyQt5.QtWidgets import QApplication, QWidget

app = QApplication(sys.argv)
window = QWidget()
window.show()
sys.exit(app.exec_())

这段代码创建了一个空白的窗口并显示出来，实现了一个最简单的GUI应用程序。其结果如下图所示：

2.QMainWindow

import sys
from PyQt5.QtWidgets import QApplication, QMainWindow

app = QApplication(sys.argv)
window = QMainWindow()
window.show()
sys.exit(app.exec_())

这段代码创建了一个带有菜单栏、工具栏和状态栏的主窗口，并显示出来。结果如下图所示：