【从零开始的Qt开发指南】（十四）Qt 窗口之“三剑客”：工具栏、状态栏、浮动窗口进阶实战指南
前言
在 Qt 桌面应用开发中，除了核心的菜单栏，工具栏、状态栏和浮动窗口也是构建专业级界面的关键组件。它们各司其职又相互配合：工具栏提供快捷操作入口，状态栏展示实时状态信息，浮动窗口则实现灵活的功能扩展。基于 QMainWindow 的模块化设计，这三个组件可以轻松集成，让应用界面既美观又实用。本文将从基础原理到实战开发，带你全面掌握这三大组件的使用技巧，打造出媲美专业软件的 Qt 窗口界面。下面就让我们正式开始吧！
一、核心组件概述：QMainWindow 的 “左膀右臂”
QMainWindow 作为 Qt 主窗口的核心类，不仅提供了菜单栏支持，还内置了对工具栏（QToolBar）、状态栏（QStatusBar）和浮动窗口（QDockWidget）的完善支持。这三个组件与菜单栏、中央部件共同构成了 Qt 主窗口的 “五件套”，其布局位置如下：
- 工具栏：默认位于菜单栏下方或窗口边缘，支持多实例、可移动、可浮动。
- 状态栏：固定在窗口底部，最多一个实例，用于显示状态信息。
- 浮动窗口：围绕中央部件分布，支持多实例、可停靠、可浮动，常用于放置辅助功能模块。
这三个组件的设计遵循 “灵活复用、低耦合” 的原则，既可以独立使用，也能与其他组件联动（如工具栏与菜单栏共享 QAction 对象），极大提升了开发效率和用户体验。接下来，我们将逐一拆解每个组件的使用方法。
二、工具栏（QToolBar）：快捷操作的 “加速器”
工具栏是应用程序中高频功能的快捷入口，通常以图标按钮的形式呈现，支持拖拽移动、浮动显示等特性。Qt 中的 QToolBar 类提供了丰富的 API，让开发者可以轻松定制工具栏的位置、样式和功能。
2.1 工具栏核心特性与创建方式
2.1.1 核心特性
- 支持多实例：一个主窗口可以创建多个工具栏。
- 灵活的停靠位置：可停靠在窗口上、下、左、右四个方向，也可设置为仅允许特定方向停靠。
- 浮动属性：支持从窗口分离，以独立窗口形式存在。
- 内容多样化：可添加 QAction、QPushButton、QComboBox 等多种控件。
- 与菜单栏联动：QAction 对象可同时用于菜单栏和工具栏，实现功能复用。
2.1.2 两种创建方式
创建工具栏的核心是通过 QMainWindow 的 addToolBar () 函数将工具栏添加到主窗口，支持两种常见创建方式：
方式一：直接创建并添加（推荐）
MainWindow::MainWindow(QWidget *parent)
: QMainWindow(parent)
, ui(new Ui::MainWindow)
{
ui->setupUi(this);
// 1. 创建工具栏对象，指定父对象为主窗口
QToolBar *toolBar = new QToolBar(this);
// 2. 设置工具栏名称（用于区分多个工具栏，可选）
toolBar->setWindowTitle("主工具栏");
// 3. 将工具栏添加到主窗口（默认停靠在顶部）
this->addToolBar(toolBar);
// 验证创建成功（调试用）
qDebug() << "工具栏创建成功：" << toolBar->windowTitle();
}方式二：创建时指定默认停靠位置
MainWindow::MainWindow(QWidget *parent)
: QMainWindow(parent)
, ui(new Ui::MainWindow)
{
ui->setupUi(this);
// 1. 创建两个工具栏
QToolBar *toolBarLeft = new QToolBar("左侧工具栏", this);
QToolBar *toolBarRight = new QToolBar("右侧工具栏", this);
// 2. 添加时指定默认停靠位置（左侧和右侧）
this->addToolBar(Qt::LeftToolBarArea, toolBarLeft);
this->addToolBar(Qt::RightToolBarArea, toolBarRight);
// 3. 设置窗口大小，便于观察效果
this->resize(800, 600);
}两种方式对比：
- 方式一简洁高效，适用于不需要指定默认停靠位置的场景。
- 方式二灵活性更高，可直接设置工具栏初始位置，适合多工具栏分工明确的场景。
2.2 工具栏停靠位置设置：灵活定制布局
工具栏的停靠位置是其核心特性之一，Qt 提供了两种设置方式：指定默认停靠位置和限制允许停靠的位置，满足不同场景需求。
2.2.1 核心位置枚举值
Qt 定义了四个基础停靠位置枚举，可通过组合使用实现灵活配置：
- Qt::TopToolBarArea：停靠在顶部（默认）
- Qt::BottomToolBarArea：停靠在底部
- Qt::LeftToolBarArea：停靠在左侧
- Qt::RightToolBarArea：停靠在右侧
- Qt::AllToolBarAreas：允许停靠在所有位置（默认值）
2.2.2 方式一：创建时指定默认位置
如 2.1.2 中的方式二所示，通过 addToolBar () 的重载函数，在添加工具栏时直接指定初始停靠位置：
// 创建工具栏并指定默认停靠在底部
QToolBar *toolBarBottom = new QToolBar("底部工具栏", this);
this->addToolBar(Qt::BottomToolBarArea, toolBarBottom);2.2.3 方式二：限制允许停靠的位置
通过 setAllowedAreas () 函数，可以限制工具栏只能在指定位置停靠，防止用户误操作改变布局：
MainWindow::MainWindow(QWidget *parent)
: QMainWindow(parent)
, ui(new Ui::MainWindow)
{
ui->setupUi(this);
// 创建工具栏
QToolBar *toolBar = new QToolBar("受限工具栏", this);
this->addToolBar(toolBar);
// 仅允许停靠在左右两侧（禁止上下停靠）
toolBar->setAllowedAreas(Qt::LeftToolBarArea | Qt::RightToolBarArea);
// 设置窗口大小
this->resize(800, 600);
}关键说明：
- 默认情况下，工具栏允许停靠在所有位置（Qt::AllToolBarAreas）。
- 若同时设置了默认停靠位置和允许停靠位置，默认位置必须是允许位置之一，否则设置无效。
下面给大家提供一段完整的示例代码：
#include "mainwindow.h"
#include "ui_mainwindow.h"
#include <QToolBar>
MainWindow::MainWindow(QWidget *parent)
: QMainWindow(parent)
, ui(new Ui::MainWindow)
{
ui->setupUi(this);
QToolBar* toolBar1 = new QToolBar();
QToolBar* toolBar2 = new QToolBar();
this->addToolBar(toolBar1);
this->addToolBar(Qt::LeftToolBarArea, toolBar2); //靠在左侧
//仅允许停靠在左侧和右侧
toolBar2->setAllowedAreas(Qt::LeftToolBarArea | Qt::RightToolBarArea);
//设置不允许浮动
toolBar2->setFloatable(false);
//设置不允许移动
toolBar2->setMovable(false);
QAction* action1 = new QAction("动作1");
QAction* action2 = new QAction("动作2");
QAction* action3 = new QAction("动作3");
QAction* action4 = new QAction("动作4");
toolBar1->addAction(action1);
toolBar1->addAction(action2);
toolBar2->addAction(action3);
toolBar2->addAction(action4);
}
MainWindow::~MainWindow()
{
delete ui;
}2.3 浮动属性与移动属性：控制工具栏灵活性
工具栏的浮动和移动属性直接影响用户体验，Qt 提供了专门的 API 进行控制，平衡灵活性和布局稳定性。
2.3.1 浮动属性（setFloatable）
通过 setFloatable () 函数设置工具栏是否允许浮动（即从窗口分离为独立窗口）：
- 参数 true：允许浮动（默认值）
- 参数 false：禁止浮动，工具栏只能停靠在指定位置
示例代码：
MainWindow::MainWindow(QWidget *parent)
: QMainWindow(parent)
, ui(new Ui::MainWindow)
{
ui->setupUi(this);
// 创建两个工具栏
QToolBar *toolBarFloat = new QToolBar("允许浮动", this);
QToolBar *toolBarNoFloat = new QToolBar("禁止浮动", this);
// 添加到主窗口（默认顶部）
this->addToolBar(toolBarFloat);
this->addToolBar(toolBarNoFloat);
// 设置浮动属性
toolBarFloat->setFloatable(true); // 允许浮动（默认）
toolBarNoFloat->setFloatable(false); // 禁止浮动
// 设置窗口大小
this->resize(800, 600);
}2.3.2 移动属性（setMovable）
通过 setMovable () 函数设置工具栏是否允许用户拖拽移动：
- 参数 true：允许移动（默认值）
- 参数 false：禁止移动，工具栏固定在初始位置
示例代码：
MainWindow::MainWindow(QWidget *parent)
: QMainWindow(parent)
, ui(new Ui::MainWindow)
{
ui->setupUi(this);
QToolBar *toolBar = new QToolBar("固定工具栏", this);
this->addToolBar(Qt::TopToolBarArea, toolBar);
// 禁止移动（总开关）
toolBar->setMovable(false);
// 注意：禁止移动后，停靠位置设置将失效
toolBar->setAllowedAreas(Qt::TopToolBarArea | Qt::BottomToolBarArea); // 无效
this->resize(800, 600);
}关键注意事项：
- 移动属性是 “总开关”，若设置为 false，即使配置了允许停靠位置，用户也无法拖拽工具栏改变位置。
- 建议根据功能需求合理配置：核心功能工具栏可禁止移动，辅助功能工具栏可允许移动和浮动。
2.4 工具栏内容添加：QAction 与自定义控件
工具栏的核心是提供快捷操作，支持两种常见内容类型：QAction 对象（与菜单栏共享）和自定义控件（如 QPushButton、QComboBox 等）。
2.4.1 添加 QAction 对象（推荐）
QAction 是 Qt 中动作的抽象表示，可同时用于菜单栏、工具栏和快捷键，实现功能复用。添加 QAction 到工具栏时，会自动显示为图标按钮（若设置了图标）或文本按钮。
示例代码：
MainWindow::MainWindow(QWidget *parent)
: QMainWindow(parent)
, ui(new Ui::MainWindow)
{
ui->setupUi(this);
// 1. 创建工具栏
QToolBar *toolBar = new QToolBar("文件工具栏", this);
this->addToolBar(toolBar);
// 2. 创建QAction对象（可同时用于菜单栏）
QAction *actNew = new QAction(QIcon(":/icons/new.png"), "新建", this);
QAction *actOpen = new QAction(QIcon(":/icons/open.png"), "打开", this);
QAction *actSave = new QAction(QIcon(":/icons/save.png"), "保存", this);
// 设置快捷键（与菜单栏保持一致）
actNew->setShortcut(QKeySequence::New);
actOpen->setShortcut(QKeySequence::Open);
actSave->setShortcut(QKeySequence::Save);
// 设置提示信息（鼠标悬停时显示）
actNew->setToolTip("新建文件（Ctrl+N）");
actOpen->setToolTip("打开文件（Ctrl+O）");
actSave->setToolTip("保存文件（Ctrl+S）");
// 3. 添加QAction到工具栏
toolBar->addAction(actNew);
toolBar->addAction(actOpen);
// 添加分割线（分组功能，提升可读性）
toolBar->addSeparator();
toolBar->addAction(actSave);
// 4. 关联信号槽（触发动作）
connect(actNew, &QAction::triggered, this, [](){
qDebug() << "工具栏：新建文件";
});
connect(actOpen, &QAction::triggered, this, [](){
qDebug() << "工具栏：打开文件";
});
connect(actSave, &QAction::triggered, this, [](){
qDebug() << "工具栏：保存文件";
});
this->resize(800, 600);
}2.4.2 添加自定义控件
除了 QAction，工具栏还支持添加任意 QWidget 子类控件，满足复杂交互需求（如下拉选择、输入框等）。
示例代码：
MainWindow::MainWindow(QWidget *parent)
: QMainWindow(parent)
, ui(new Ui::MainWindow)
{
ui->setupUi(this);
// 1. 创建工具栏
QToolBar *toolBar = new QToolBar("自定义工具栏", this);
this->addToolBar(toolBar);
// 2. 添加QPushButton
QPushButton *btnSettings = new QPushButton("设置", this);
toolBar->addWidget(btnSettings);
// 添加分割线
toolBar->addSeparator();
// 3. 添加QComboBox（字体选择）
QComboBox *cmbFont = new QComboBox(this);
cmbFont->addItems({"微软雅黑", "宋体", "黑体", "华文行楷"});
cmbFont->setCurrentText("微软雅黑");
toolBar->addWidget(cmbFont);
// 4. 添加QSpinBox（字号调整）
QSpinBox *spinFontSize = new QSpinBox(this);
spinFontSize->setRange(8, 72);
spinFontSize->setValue(12);
spinFontSize->setToolTip("调整字体大小");
toolBar->addWidget(spinFontSize);
// 5. 关联控件信号
connect(btnSettings, &QPushButton::clicked, this, [](){
qDebug() << "工具栏：打开设置对话框";
});
connect(cmbFont, &QComboBox::currentTextChanged, this, [](const QString &fontName){
qDebug() << "工具栏：选择字体" << fontName;
});
connect(spinFontSize, QOverload<int>::of(&QSpinBox::valueChanged), this, [](int size){
qDebug() << "工具栏：设置字号" << size;
});
this->resize(800, 600);
}效果说明：
- 自定义控件会按照添加顺序排列在工具栏中。
- 可通过 setMinimumSize ()、setMaximumSize () 等函数调整控件大小，确保工具栏布局美观。
2.5 工具栏样式定制（QSS）：打造个性化外观
Qt Style Sheets（QSS）是 Qt 的样式表技术，类似于 CSS，可快速定制工具栏的外观。通过 QSS 可以修改工具栏的背景色、按钮样式、分割线样式等。
示例代码：
MainWindow::MainWindow(QWidget *parent)
: QMainWindow(parent)
, ui(new Ui::MainWindow)
{
ui->setupUi(this);
// 创建工具栏
QToolBar *toolBar = new QToolBar("样式化工具栏", this);
this->addToolBar(toolBar);
// 添加QAction
QAction *actNew = new QAction(QIcon(":/icons/new.png"), "新建", this);
QAction *actOpen = new QAction(QIcon(":/icons/open.png"), "打开", this);
QAction *actSave = new QAction(QIcon(":/icons/save.png"), "保存", this);
toolBar->addAction(actNew);
toolBar->addAction(actOpen);
toolBar->addSeparator();
toolBar->addAction(actSave);
// 设置QSS样式
toolBar->setStyleSheet(R"(
QToolBar {
background-color: #f5f5f5;
border: none;
border-bottom: 1px solid #dddddd;
padding: 4px;
}
QToolBar::handle {
background-color: #cccccc;
width: 8px;
}
QToolBar QAction {
margin: 0 4px;
padding: 6px 12px;
border-radius: 4px;
}
QToolBar QAction:hover {
background-color: #e0e0e0;
}
QToolBar QAction:pressed {
background-color: #d0d0d0;
}
QToolBar QSeparator {
background-color: #dddddd;
width: 1px;
margin: 4px 8px;
}
)");
this->resize(800, 600);
}样式说明：
- 自定义了工具栏背景色、边框和内边距。
- 修改了 QAction 按钮的 hover（悬停）和 pressed（按下）状态样式。
- 调整了分割线的颜色和间距，提升视觉效果。
三、状态栏（QStatusBar）：应用状态的 “显示器”
状态栏位于主窗口底部，是展示应用程序状态信息的专用区域。一个主窗口最多只能有一个状态栏，支持显示实时消息、永久消息和进度提示等，是提升用户体验的重要组件。
3.1 状态栏核心特性与创建方式
3.1.1 核心特性
- 单实例限制：一个 QMainWindow 只能有一个状态栏，通过 statusBar () 函数获取或创建。
- 消息类型多样：支持实时消息（自动消失）、永久消息（一直显示）、进度消息（进度条）。
- 布局灵活：支持左侧添加临时消息，右侧添加永久消息，自动排版。
- 轻量高效：默认隐藏，添加消息后自动显示，不占用额外空间。
3.1.2 创建方式（唯一方式）
状态栏的创建通过 QMainWindow 的 statusBar () 函数实现，该函数会自动创建状态栏（若尚未创建）并返回其指针，无需手动 new 实例。
示例代码：
MainWindow::MainWindow(QWidget *parent)
: QMainWindow(parent)
, ui(new Ui::MainWindow)
{
ui->setupUi(this);
// 1. 获取或创建状态栏（唯一方式）
QStatusBar *statusBar = this->statusBar();
// 2. 验证创建成功
if (statusBar) {
qDebug() << "状态栏创建成功";
}
this->resize(800, 600);
}关键说明：
- 无需调用 setter 函数（如 setMenuBar ()），statusBar () 函数会自动将状态栏添加到主窗口。
- 若手动创建 QStatusBar 实例（不推荐），需通过 setStatusBar () 函数设置到主窗口，否则会覆盖默认状态栏。
3.2 显示实时消息：短期提示的 “弹窗替代”
实时消息是状态栏最常用的功能，用于显示短期有效信息（如 “文件保存成功”“复制完成”），支持自动消失。通过 showMessage () 函数实现：
3.2.1 函数原型
void QStatusBar::showMessage(const QString &text, int timeout = 0);- text：要显示的消息文本。
- timeout：自动消失时间（毫秒），默认 0 表示永久显示（直到调用 clearMessage ()）。
3.2.2 示例代码
MainWindow::MainWindow(QWidget *parent)
: QMainWindow(parent)
, ui(new Ui::MainWindow)
{
ui->setupUi(this);
// 获取状态栏
QStatusBar *statusBar = this->statusBar();
// 1. 显示2秒后自动消失的消息
statusBar->showMessage("欢迎使用Qt状态栏演示", 2000);
// 2. 创建菜单栏和菜单项，触发实时消息
QMenuBar *menuBar = this->menuBar();
QMenu *menuFile = new QMenu("文件", menuBar);
QAction *actSave = new QAction("保存", menuFile);
menuFile->addAction(actSave);
menuBar->addMenu(menuFile);
// 点击“保存”时显示实时消息
connect(actSave, &QAction::triggered, this, [=](){
// 模拟保存操作
qDebug() << "文件保存成功";
// 显示3秒后自动消失的消息
statusBar->showMessage("文件保存成功", 3000);
});
this->resize(800, 600);
}3.2.3 清除实时消息
若需要手动清除实时消息（如显示新消息前），可调用 clearMessage () 函数：
// 清除当前显示的实时消息
statusBar->clearMessage();3.3 显示永久消息：长期信息的 “固定展示”
永久消息用于显示长期有效信息（如程序版本号、版权信息、当前状态提示），不会自动消失。通过添加 QLabel 控件到状态栏实现，支持左右布局。
3.3.1 左侧添加永久消息
通过 addWidget () 函数添加控件到状态栏左侧，会按照添加顺序排列：
MainWindow::MainWindow(QWidget *parent)
: QMainWindow(parent)
, ui(new Ui::MainWindow)
{
ui->setupUi(this);
QStatusBar *statusBar = this->statusBar();
// 1. 创建左侧永久消息标签
QLabel *labelLeft = new QLabel("当前状态：就绪", this);
// 设置标签样式（可选）
labelLeft->setStyleSheet("color: #666666;");
// 添加到状态栏左侧
statusBar->addWidget(labelLeft);
// 2. 模拟状态变化（5秒后更新消息）
QTimer::singleShot(5000, this, [=](){
labelLeft->setText("当前状态：处理中");
labelLeft->setStyleSheet("color: #ff6600;");
});
this->resize(800, 600);
}3.3.2 右侧添加永久消息
通过 addPermanentWidget () 函数添加控件到状态栏右侧，始终靠右显示，不随左侧消息变化而移动：
MainWindow::MainWindow(QWidget *parent)
: QMainWindow(parent)
, ui(new Ui::MainWindow)
{
ui->setupUi(this);
QStatusBar *statusBar = this->statusBar();
// 左侧消息
QLabel *labelLeft = new QLabel("当前状态：就绪", this);
statusBar->addWidget(labelLeft);
// 右侧永久消息（版本信息）
QLabel *labelRight = new QLabel("版本：v1.0.0 | 作者：Qt学习爱好者", this);
labelRight->setStyleSheet("color: #999999;");
statusBar->addPermanentWidget(labelRight);
this->resize(800, 600);
}3.3.3 混合显示示例
结合实时消息和永久消息，实现更丰富的状态展示：
MainWindow::MainWindow(QWidget *parent)
: QMainWindow(parent)
, ui(new Ui::MainWindow)
{
ui->setupUi(this);
QStatusBar *statusBar = this->statusBar();
// 左侧永久消息：状态提示
QLabel *labelStatus = new QLabel("就绪", this);
statusBar->addWidget(labelStatus, 1); // 第二个参数为拉伸因子，1表示占满剩余空间
// 右侧永久消息：版本信息
QLabel *labelVersion = new QLabel("v1.0.0", this);
statusBar->addPermanentWidget(labelVersion);
// 菜单栏触发实时消息
QMenuBar *menuBar = this->menuBar();
QMenu *menuEdit = new QMenu("编辑", menuBar);
QAction *actCopy = new QAction("复制", menuEdit);
menuEdit->addAction(actCopy);
menuBar->addMenu(menuEdit);
connect(actCopy, &QAction::triggered, this, [=](){
// 显示实时消息（覆盖左侧永久消息的临时区域）
statusBar->showMessage("已复制到剪贴板", 2000);
});
this->resize(800, 600);
}关键说明：
- addWidget () 的第二个参数为拉伸因子，默认 0 表示控件大小固定，1 表示占满剩余空间。
- 实时消息会显示在左侧永久消息的临时区域，自动消失后恢复显示永久消息。
3.4 显示进度消息：任务进度的 “可视化展示”
状态栏支持添加进度条，用于显示耗时任务的进度（如文件下载、数据处理），提升用户等待体验。通过添加 QProgressBar 控件实现：
示例代码：
#include "mainwindow.h"
#include "ui_mainwindow.h"
#include <QLabel>
#include <QProgressBar>
#include <QPushButton>
MainWindow::MainWindow(QWidget *parent)
: QMainWindow(parent)
, ui(new Ui::MainWindow)
{
ui->setupUi(this);
//存在就获取，不存在就创建
QStatusBar* statusBar = this->statusBar();
//如果状态栏没有被创建，这样的设置是必要的
//如果状态栏已经在窗口中存在，这样的设置其实意义不大，但是也没有副作用，仍然保留
this->setStatusBar(statusBar);
//显示一个临时的信息
//statusBar->showMessage("这是一个状态消息", 3000); //三秒后消息自动消失
//给状态栏中添加一个子控件
QLabel* label = new QLabel("这是一个Qlabel");
statusBar->addWidget(label);
// QLabel* label2 = new QLabel("这是另一个Qlabel");
// statusBar->addWidget(label2, 2);
QProgressBar* progressBar = new QProgressBar();
progressBar->setRange(0, 100);
progressBar->setValue(50);
statusBar->addWidget(progressBar);
QPushButton* button = new QPushButton("按钮");
statusBar->addPermanentWidget(button);
}
MainWindow::~MainWindow()
{
delete ui;
}效果说明：
- 点击 “开始任务” 后，进度条显示实时进度，状态栏显示任务状态。
- 任务完成后，进度条隐藏，显示完成提示消息。
3.5 状态栏常见问题与解决方案
3.5.1 状态栏不显示
- 原因：未添加任何消息或控件，状态栏默认隐藏。
- 解决方案：添加至少一个永久消息控件或调用 showMessage () 显示实时消息。
3.5.2 实时消息覆盖永久消息
- 原因：实时消息默认显示在左侧永久消息区域。
- 解决方案：合理分配左侧空间，或通过拉伸因子控制永久消息的显示范围。
3.5.3 进度条占满状态栏
- 原因：未限制进度条宽度，拉伸因子设置为 1。
- 解决方案：使用 setMaximumWidth () 限制进度条宽度，或设置拉伸因子为 0。
四、浮动窗口（QDockWidget）：灵活扩展的 “功能面板”
浮动窗口（又称铆接部件）是 Qt 中实现灵活布局的核心组件，围绕中央部件分布，支持停靠、浮动、隐藏等特性。常用于放置辅助功能模块（如文件浏览器、属性设置面板），用户可根据需求调整其位置或隐藏，提升界面利用率。
4.1 浮动窗口核心特性与创建方式
4.1.1 核心特性
- 多实例支持：一个主窗口可以创建多个浮动窗口。
- 灵活停靠：可停靠在中央部件的上、下、左、右四个方向，支持组合停靠。
- 浮动功能：可从主窗口分离，以独立窗口形式存在，支持拖拽移动。
- 嵌套支持：多个浮动窗口可停靠在同一区域，形成标签页式布局。
- 与中央部件联动：浮动窗口的显示 / 隐藏不影响中央部件的功能。
4.1.2 创建方式
浮动窗口通过 QDockWidget 类动态创建，需指定窗口标题和父对象，然后通过 addDockWidget () 函数添加到主窗口。
示例代码：
MainWindow::MainWindow(QWidget *parent)
: QMainWindow(parent)
, ui(new Ui::MainWindow)
{
ui->setupUi(this);
// 1. 创建中央部件（必须，否则浮动窗口无停靠基准）
QTextEdit *centralWidget = new QTextEdit("中央编辑区域", this);
this->setCentralWidget(centralWidget);
// 2. 创建浮动窗口（指定标题和父对象）
QDockWidget *dockWidget = new QDockWidget("浮动窗口1", this);
// 3. 为浮动窗口添加内容（必须，否则窗口为空）
QListWidget *listWidget = new QListWidget(dockWidget);
listWidget->addItems({"文件1.txt", "文件2.txt", "文件3.txt"});
dockWidget->setWidget(listWidget);
// 4. 添加到主窗口，指定默认停靠位置（左侧）
this->addDockWidget(Qt::LeftDockWidgetArea, dockWidget);
this->resize(800, 600);
}关键注意事项：
- 浮动窗口必须添加内容（通过 setWidget () 函数），否则显示为空窗口。
- 主窗口必须设置中央部件（setCentralWidget ()），否则浮动窗口无法正常停靠。
- 浮动窗口的父对象必须设置为主窗口，确保内存正确管理。
4.2 浮动窗口停靠位置设置
与工具栏类似，浮动窗口的停靠位置通过枚举值控制，支持指定默认停靠位置和限制允许停靠的位置。
4.2.1 核心位置枚举值
- Qt::LeftDockWidgetArea：停靠在左侧（默认）
- Qt::RightDockWidgetArea：停靠在右侧
- Qt::TopDockWidgetArea：停靠在顶部
- Qt::BottomDockWidgetArea：停靠在底部
- Qt::AllDockWidgetAreas：允许停靠在所有位置（默认值）
4.2.2 方式一：创建时指定默认位置
通过 addDockWidget () 函数的第一个参数，指定浮动窗口的初始停靠位置：
MainWindow::MainWindow(QWidget *parent)
: QMainWindow(parent)
, ui(new Ui::MainWindow)
{
ui->setupUi(this);
// 中央部件
QTextEdit *centralWidget = new QTextEdit("中央编辑区域", this);
this->setCentralWidget(centralWidget);
// 创建三个浮动窗口，分别停靠在不同位置
QDockWidget *dockLeft = new QDockWidget("左侧面板", this);
QDockWidget *dockRight = new QDockWidget("右侧面板", this);
QDockWidget *dockBottom = new QDockWidget("底部面板", this);
// 为每个浮动窗口添加内容
dockLeft->setWidget(new QListWidget(this));
dockRight->setWidget(new QTreeWidget(this));
dockBottom->setWidget(new QTableWidget(this));
// 添加到主窗口，指定默认位置
this->addDockWidget(Qt::LeftDockWidgetArea, dockLeft);
this->addDockWidget(Qt::RightDockWidgetArea, dockRight);
this->addDockWidget(Qt::BottomDockWidgetArea, dockBottom);
this->resize(800, 600);
}4.2.2 方式二：限制允许停靠的位置
通过 setAllowedAreas () 函数，限制浮动窗口只能在指定位置停靠，避免用户误操作改变布局：
MainWindow::MainWindow(QWidget *parent)
: QMainWindow(parent)
, ui(new Ui::MainWindow)
{
ui->setupUi(this);
// 中央部件
QTextEdit *centralWidget = new QTextEdit("中央编辑区域", this);
this->setCentralWidget(centralWidget);
// 创建浮动窗口
QDockWidget *dockWidget = new QDockWidget("受限浮动窗口", this);
dockWidget->setWidget(new QListWidget(this));
// 添加到主窗口，默认停靠在顶部
this->addDockWidget(Qt::TopDockWidgetArea, dockWidget);
// 限制只能停靠在上下两个位置
dockWidget->setAllowedAreas(Qt::TopDockWidgetArea | Qt::BottomDockWidgetArea);
this->resize(800, 600);
}关键说明：
- 若设置了不允许浮动（setFloating (false)），则浮动窗口只能停靠在允许位置，无法分离。
- 多个浮动窗口停靠在同一区域时，默认按添加顺序排列，可通过 tabifyDockWidget () 函数设置为标签页式布局。
以下是浮动窗口创建的演示：
#include "mainwindow.h"
#include "ui_mainwindow.h"
#include <QDockWidget>
#include <QLabel>
#include <QPushButton>
#include <QVBoxLayout>
MainWindow::MainWindow(QWidget *parent)
: QMainWindow(parent)
, ui(new Ui::MainWindow)
{
ui->setupUi(this);
//给主窗口添加一个子窗口
QDockWidget* dockWidget = new QDockWidget();
//使用addDockWidget方法，把浮动窗口加入到子窗口中
this->addDockWidget(Qt::LeftDockWidgetArea, dockWidget);
//浮动窗口也是可以设置标题的
dockWidget->setWindowTitle("这是浮动窗口");
//给浮动窗口内部添加一些其他控件
//不能直接给这个浮动窗口添加子控件，而是需要创建出一个单独的QWidget，把要添加的控件加入到QWidget中
//然后再把这个QWidet设置到dockWidget中
QWidget* container = new QWidget();
dockWidget->setWidget(container);
//创建布局管理器，把布局管理器设置到QWidget中
QVBoxLayout* layout = new QVBoxLayout;
container->setLayout(layout);
//创建其他控件，添加到layout中
QLabel* label = new QLabel("这是一个QLabel");
QPushButton* button = new QPushButton("这是按钮");
layout->addWidget(label);
layout->addWidget(button);
//设置浮动窗口允许停靠的位置
dockWidget->setAllowedAreas(Qt::LeftDockWidgetArea | Qt::TopDockWidgetArea);
}
MainWindow::~MainWindow()
{
delete ui;
}4.3 浮动窗口高级特性：标签页、隐藏与激活
4.3.1 标签页式布局（多个浮动窗口合并）
当多个浮动窗口停靠在同一区域时，可通过 tabifyDockWidget () 函数将其合并为标签页式布局，节省空间。
示例代码：
MainWindow::MainWindow(QWidget *parent)
: QMainWindow(parent)
, ui(new Ui::MainWindow)
{
ui->setupUi(this);
// 中央部件
QTextEdit *centralWidget = new QTextEdit("中央编辑区域", this);
this->setCentralWidget(centralWidget);
// 创建三个浮动窗口
QDockWidget *dock1 = new QDockWidget("文件面板", this);
QDockWidget *dock2 = new QDockWidget("属性面板", this);
QDockWidget *dock3 = new QDockWidget("日志面板", this);
// 添加内容
dock1->setWidget(new QListWidget(this));
dock2->setWidget(new QTreeWidget(this));
dock3->setWidget(new QTextEdit("日志内容...", this));
// 全部停靠在右侧
this->addDockWidget(Qt::RightDockWidgetArea, dock1);
this->addDockWidget(Qt::RightDockWidgetArea, dock2);
this->addDockWidget(Qt::RightDockWidgetArea, dock3);
// 合并为标签页式布局（dock1作为主标签页）
this->tabifyDockWidget(dock1, dock2);
this->tabifyDockWidget(dock1, dock3);
// 设置默认激活的标签页
dock1->raise();
this->resize(800, 600);
}效果说明：
- 三个浮动窗口合并为右侧的标签页，用户可点击标签切换不同面板。
- 通过 raise () 函数设置默认激活的标签页，确保初始显示正确的内容。
4.3.2 隐藏与显示浮动窗口
浮动窗口支持通过 setVisible () 函数或 toggleViewAction () 函数隐藏 / 显示，也可通过菜单栏或工具栏控制其状态。
示例代码：
MainWindow::MainWindow(QWidget *parent)
: QMainWindow(parent)
, ui(new Ui::MainWindow)
{
ui->setupUi(this);
// 中央部件
QTextEdit *centralWidget = new QTextEdit("中央编辑区域", this);
this->setCentralWidget(centralWidget);
// 创建浮动窗口
QDockWidget *dockWidget = new QDockWidget("可隐藏面板", this);
dockWidget->setWidget(new QListWidget(this));
this->addDockWidget(Qt::LeftDockWidgetArea, dockWidget);
// 菜单栏控制显示/隐藏
QMenuBar *menuBar = this->menuBar();
QMenu *menuView = new QMenu("视图", menuBar);
menuBar->addMenu(menuView);
// 获取浮动窗口的切换动作（自动创建，绑定显示/隐藏功能）
QAction *actToggleDock = dockWidget->toggleViewAction();
actToggleDock->setText("显示/隐藏面板");
actToggleDock->setShortcut(Qt::Key_F9);
menuView->addAction(actToggleDock);
// 工具栏控制显示/隐藏
QToolBar *toolBar = new QToolBar(this);
this->addToolBar(toolBar);
toolBar->addAction(actToggleDock);
this->resize(800, 600);
}效果说明：
- 点击菜单栏 “视图”->“显示 / 隐藏面板” 或按 F9 键，可切换浮动窗口的显示状态。
- 工具栏中的对应按钮也可实现同样功能，实现多入口控制。
4.3.3 禁止浮动窗口关闭
默认情况下，浮动窗口标题栏有关闭按钮，用户可关闭窗口。若需要禁止关闭，可通过设置窗口标志实现：
// 禁止浮动窗口关闭（保留最小化、最大化按钮）
dockWidget->setFeatures(QDockWidget::DockWidgetMovable | QDockWidget::DockWidgetFloatable);
// 或只允许停靠和移动，禁止浮动和关闭
dockWidget->setFeatures(QDockWidget::DockWidgetMovable);QDockWidget 常用功能标志：
- DockWidgetClosable：允许关闭（默认启用）
- DockWidgetMovable：允许移动（默认启用）
- DockWidgetFloatable：允许浮动（默认启用）
- DockWidgetVerticalTitleBar：垂直标题栏（适用于左侧 / 右侧停靠）
- AllDockWidgetFeatures：所有功能（默认值）
- NoDockWidgetFeatures：无特殊功能（仅显示）
4.4 浮动窗口与中央部件联动
浮动窗口的核心价值是辅助中央部件实现功能，通过信号槽机制可实现两者的联动（如选择浮动窗口中的文件，中央部件显示文件内容）。
示例代码：
MainWindow::MainWindow(QWidget *parent)
: QMainWindow(parent)
, ui(new Ui::MainWindow)
{
ui->setupUi(this);
// 1. 创建中央部件（文本编辑区域）
QTextEdit *centralEdit = new QTextEdit(this);
centralEdit->setPlaceholderText("选择左侧文件查看内容...");
this->setCentralWidget(centralEdit);
// 2. 创建浮动窗口（文件列表）
QDockWidget *dockFile = new QDockWidget("文件列表", this);
QListWidget *fileList = new QListWidget(dockFile);
fileList->addItems({"文件1.txt", "文件2.txt", "文件3.txt"});
dockFile->setWidget(fileList);
this->addDockWidget(Qt::LeftDockWidgetArea, dockFile);
// 3. 创建第二个浮动窗口（文件属性）
QDockWidget *dockProp = new QDockWidget("文件属性", this);
QTableWidget *propTable = new QTableWidget(3, 2, dockProp);
propTable->setHorizontalHeaderLabels({"属性", "值"});
propTable->setItem(0, 0, new QTableWidgetItem("文件名"));
propTable->setItem(1, 0, new QTableWidgetItem("大小"));
propTable->setItem(2, 0, new QTableWidgetItem("修改时间"));
dockProp->setWidget(propTable);
this->addDockWidget(Qt::RightDockWidgetArea, dockProp);
// 4. 联动：选择文件列表项，更新中央部件和属性面板
connect(fileList, &QListWidget::currentItemChanged, this, [=](QListWidgetItem *current){
if (!current) return;
// 中央部件显示文件内容
QString fileName = current->text();
centralEdit->setText(QString("当前打开文件：%1\n文件内容示例...").arg(fileName));
// 属性面板更新信息
propTable->setItem(0, 1, new QTableWidgetItem(fileName));
propTable->setItem(1, 1, new QTableWidgetItem("1024 KB"));
propTable->setItem(2, 1, new QTableWidgetItem(QDateTime::currentDateTime().toString()));
});
this->resize(800, 600);
}效果说明：
- 点击左侧文件列表中的项，中央部件显示对应的文件内容，右侧属性面板显示文件信息。
- 实现了多组件联动，提升了用户操作的连贯性和便捷性。
五、三大组件高级技巧与最佳实践
5.1 性能优化建议
- 减少不必要的刷新：状态栏的实时消息和光标位置更新频率较高，避免在频繁触发的信号中执行复杂逻辑。
- 合理使用父对象机制：所有组件都应指定父对象，确保 Qt 自动管理内存，避免内存泄漏。
- 隐藏未使用的组件：浮动窗口和工具栏在未使用时可隐藏，减少界面绘制开销。
5.2 界面设计最佳实践
- 工具栏：优先放置高频功能，使用图标 + 文本的形式提升辨识度；避免添加过多按钮，可将次要功能放在下拉菜单中。
- 状态栏：左侧显示核心状态信息，右侧显示辅助信息；进度条仅在耗时操作时显示，避免占用空间。
- 浮动窗口：按功能分组，同一类功能的面板可合并为标签页；提供显示 / 隐藏切换，满足不同用户的布局需求。
5.3 常见问题与解决方案汇总
5.3.1 浮动窗口无法停靠
- 原因：未设置中央部件，或停靠位置不在允许范围内。
- 解决方案：确保调用 setCentralWidget () 设置中央部件，检查 setAllowedAreas () 的参数是否正确。
5.3.2 工具栏按钮无图标
- 原因：图标路径错误，或未使用 Qt 资源文件管理图标。
- 解决方案：使用 Qt 资源文件（.qrc）管理图标，确保图标路径正确（如 ":/icons/new.png"）。
5.3.3 状态栏消息不显示
- 原因：未添加消息或控件，或实时消息超时时间设置为 0 且未调用 clearMessage ()。
- 解决方案：添加永久消息控件，或确保 showMessage () 的超时时间大于 0。
5.3.4 组件联动失效
- 原因：信号槽连接错误，或对象指针为空。
- 解决方案：检查信号槽连接代码，确保所有对象都已正确初始化，使用 qDebug () 打印指针验证。
总结
Qt 的组件化设计理念让开发者可以快速构建功能完善的桌面应用，建议在实际开发中多尝试不同的组件组合，根据应用场景合理配置布局和功能，打造出既美观又实用的 Qt 应用程序。 如果你在开发过程中遇到问题，欢迎在评论区留言交流。也可以参考 Qt 官方文档（https://doc.qt.io/qt-5/）获取更详细的 API 说明和示例代码。
举报
腾讯云开发者
Copyright © 2013 - 2026 Tencent Cloud. All Rights Reserved. 腾讯云 版权所有
深圳市腾讯计算机系统有限公司 ICP备案/许可证号：粤B2-20090059 
粤公网安备44030502008569号
腾讯云计算（北京）有限责任公司 京ICP证150476号 | 京ICP备11018762号