Qt Widgets 模块是 Qt 框架中用于创建传统桌面用户界面（GUI）的核心库。它提供了一套完整的、基于 C++ 对象的控件集合，用于构建功能强大、外观类似原生系统的应用程序。
🌟 Qt Widgets 模块核心类及其函数详解
1. 窗口和对话框 (Top-Level Containers)
| 核心类 (Class) | 功能描述 | 常用函数 (Function) 及作用 |
|---|---|---|
QWidget |
所有用户界面对象的基类。 它是构成窗口的基本单元，可以作为独立窗口或嵌入到其他容器中。 | QWidget::show() / hide() : 显示或隐藏控件。 QWidget::setWindowTitle() : 设置窗口标题。 QWidget::setGeometry() / resize() : 设置控件的位置和大小。 QWidget::close() : 关闭窗口，发射 closeEvent()。 QWidget::update() : 强制重绘控件，触发 paintEvent()。 |
QMainWindow |
主窗口类。 专门为提供标准的应用程序界面而设计，包含预设的布局区域。 | QMainWindow::setMenuBar() : 设置主菜单栏。 QMainWindow::addToolBar() : 添加工具栏。 QMainWindow::setCentralWidget() : 设置主窗口的中心区域控件。 QMainWindow::statusBar(): 访问或创建状态栏。 |
QDialog |
对话框窗口的基类。 用于短暂的用户交互，通常以模态（Modal）方式运行。 | QDialog::exec() : 以模态 方式运行对话框（阻塞父窗口）。 QDialog::open() : 以非模态方式运行对话框。 信号 accepted() / rejected(): 当用户点击 OK/Cancel 按钮时发射。 |
2. 基本交互控件 (Input and Display Widgets)
| 核心类 (Class) | 功能描述 | 常用函数 (Function) 及作用 |
|---|---|---|
QPushButton |
按钮控件。 用于触发应用程序中的动作。 | QPushButton::setText() : 设置按钮显示的文本。 QPushButton::setIcon() : 设置按钮图标。 QPushButton::setCheckable() : 设置按钮为可选中/不可选中状态。 信号 clicked(): 按钮被点击时发射（最常用）。 |
QLabel |
文本或图片显示。 用于显示不可编辑的文本、图片或 GIF 动画。 | QLabel::setText() : 设置显示的文本。 QLabel::setPixmap() : 设置显示的图片 (QPixmap)。 QLabel::setWordWrap(): 启用文本自动换行。 |
QLineEdit |
单行文本输入框。 | QLineEdit::text() : 获取当前输入文本 (QString)。 QLineEdit::setText() : 设置文本。 QLineEdit::setPlaceholderText() : 设置占位符文本。 QLineEdit::setEchoMode() : 设置文本显示模式（如密码模式）。 信号 textChanged(const QString &): 文本改变时发射。 |
QTextEdit |
多行富文本编辑器。 支持段落、格式、图片等。 | QTextEdit::toPlainText() : 获取纯文本内容。 QTextEdit::setText() : 设置文本内容。 QTextEdit::setFontFamily() : 设置字体。 QTextEdit::append(): 在文档末尾追加文本。 |
QCheckBox |
复选框。 提供开/关或多选选项。 | QCheckBox::isChecked() : 检查是否被选中。 QCheckBox::setChecked() : 设置选中状态。 信号 toggled(bool): 选中状态改变时发射。 |
3. 布局管理器 (Layout Managers)
布局管理器用于自动管理子控件的位置和大小，确保界面在窗口调整时能够正确伸缩。
| 核心类 (Class) | 功能描述 | 常用函数 (Function) 及作用 |
|---|---|---|
QLayout |
布局基类。 | N/A |
QHBoxLayout |
水平布局。 控件从左到右依次排列。 | QLayout::addWidget(QWidget *widget) : 添加一个控件。 QLayout::addStretch(int stretch = 0): 添加一个可伸缩的空白区域。 |
QVBoxLayout |
垂直布局。 控件从上到下依次排列。 | QLayout::addWidget(QWidget *widget): 添加一个控件。 |
QGridLayout |
网格布局。 控件按行和列排列。 | QGridLayout::addWidget(QWidget *widget, int row, int column, int rowSpan, int columnSpan): 添加控件并指定其起始位置和跨越的行/列数。 |
4. 模型/视图控件 (Model/View Widgets)
用于高效地展示大量复杂数据（如表格、树或列表）。
| 核心类 (Class) | 功能描述 | 常用函数 (Function) 及作用 |
|---|---|---|
QAbstractItemView |
视图基类。 | N/A |
QTableView |
表格视图。 以二维表格形式显示数据。 | QTableView::setModel(QAbstractItemModel *model) : 绑定数据模型（如 QStandardItemModel 或 QSqlTableModel）。 QTableView::setSortingEnabled(): 启用点击表头排序。 |
QTreeView |
树形视图。 以层次结构（树）形式显示数据。 | QTreeView::expandAll() / collapseAll(): 展开或折叠所有节点。 |
QListView |
列表视图。 以简单的列表形式显示数据。 | QListView::setSelectionMode(): 设置用户的选择模式（单选/多选）。 |
5. 其他重要类
| 核心类 (Class) | 功能描述 | 常用函数 (Function) 及作用 |
|---|---|---|
QMessageBox |
标准消息对话框。 用于向用户显示信息、警告或错误。 | QMessageBox::information() / warning() / critical() : 静态函数 ，一键弹出模态对话框。 QMessageBox::addButton(): 添加自定义按钮。 |
QApplication |
桌面应用程序的基类。 继承自 QCoreApplication 并添加了 GUI 特性。 |
QApplication::exec() : 启动 GUI 事件循环（阻塞直到应用程序退出）。 QApplication::setApplicationName(): 设置应用程序名称。 |
QMenuBar |
菜单栏。 用于添加菜单项到 QMainWindow。 |
QMenuBar::addMenu(): 添加一个顶级菜单（如 "File", "Edit"）。 |
QAction |
动作对象。 封装了用户界面中的一个逻辑动作，可同时用于菜单项、工具栏按钮或上下文菜单。 | QAction::setText() / setIcon() : 设置显示文本和图标。 信号 triggered(): 动作被激活时发射。 |
💡 Qt Widgets 的核心编程模式
掌握 Qt Widgets 的关键在于理解其核心机制：
- 对象树 (Parent/Child): 所有控件都应该有父控件 (
QWidget *parent)。父控件被删除时，子控件也会被自动删除（自动内存管理）。 - 信号与槽 (Signals & Slots): 这是控件交互的方式。例如，您将
QPushButton的clicked()信号 连接到您自定义类中的一个onButtonClicked()槽。 - 布局 (Layouts): 避免使用绝对坐标 (
setGeometry)，而应该使用QHBoxLayout,QVBoxLayout, 或QGridLayout来让界面自适应窗口大小的变化。