【从零开始的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 ()**函数将工具栏添加到主窗口，支持两种常见创建方式：

方式一：直接创建并添加（推荐）

cpp 复制代码

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();
}

方式二：创建时指定默认停靠位置

cpp 复制代码

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 ()**的重载函数，在添加工具栏时直接指定初始停靠位置：

cpp 复制代码

// 创建工具栏并指定默认停靠在底部
QToolBar *toolBarBottom = new QToolBar("底部工具栏", this);
this->addToolBar(Qt::BottomToolBarArea, toolBarBottom);

2.2.3 方式二：限制允许停靠的位置

通过 setAllowedAreas () 函数，可以限制工具栏只能在指定位置停靠，防止用户误操作改变布局：

cpp 复制代码

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）。

若同时设置了默认停靠位置和允许停靠位置，默认位置必须是允许位置之一，否则设置无效。

下面给大家提供一段完整的示例代码：

cpp 复制代码

#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：禁止浮动，工具栏只能停靠在指定位置

示例代码：

cpp 复制代码

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：禁止移动，工具栏固定在初始位置

示例代码：

cpp 复制代码

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 到工具栏时，会自动显示为图标按钮（若设置了图标）或文本按钮。

示例代码：

cpp 复制代码

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 子类控件，满足复杂交互需求（如下拉选择、输入框等）。

示例代码：

cpp 复制代码

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 可以修改工具栏的背景色、按钮样式、分割线样式等。

示例代码：

cpp 复制代码

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 实例。

示例代码：

cpp 复制代码

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 函数原型

cpp 复制代码

void QStatusBar::showMessage(const QString &text, int timeout = 0);

text：要显示的消息文本。

timeout：自动消失时间（毫秒），默认 0 表示永久显示（直到调用 clearMessage ()）。

3.2.2 示例代码

cpp 复制代码

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 () 函数：

cpp 复制代码

// 清除当前显示的实时消息
statusBar->clearMessage();

3.3 显示永久消息：长期信息的 "固定展示"

永久消息用于显示长期有效信息（如程序版本号、版权信息、当前状态提示），不会自动消失。通过添加 QLabel 控件到状态栏实现，支持左右布局。

3.3.1 左侧添加永久消息

通过**addWidget ()**函数添加控件到状态栏左侧，会按照添加顺序排列：

cpp 复制代码

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 ()**函数添加控件到状态栏右侧，始终靠右显示，不随左侧消息变化而移动：

cpp 复制代码

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 混合显示示例

结合实时消息和永久消息，实现更丰富的状态展示：

cpp 复制代码

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 控件实现：

示例代码：

cpp 复制代码

#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 () 函数添加到主窗口。

示例代码：

cpp 复制代码

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 () 函数的第一个参数，指定浮动窗口的初始停靠位置：

cpp 复制代码

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 () 函数，限制浮动窗口只能在指定位置停靠，避免用户误操作改变布局：

cpp 复制代码

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 () 函数设置为标签页式布局。

以下是浮动窗口创建的演示：

cpp 复制代码

#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 () 函数将其合并为标签页式布局，节省空间。

示例代码：

cpp 复制代码

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 () 函数隐藏 / 显示，也可通过菜单栏或工具栏控制其状态。

示例代码：

cpp 复制代码

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 禁止浮动窗口关闭

默认情况下，浮动窗口标题栏有关闭按钮，用户可关闭窗口。若需要禁止关闭，可通过设置窗口标志实现：

cpp 复制代码

// 禁止浮动窗口关闭（保留最小化、最大化按钮）
dockWidget->setFeatures(QDockWidget::DockWidgetMovable | QDockWidget::DockWidgetFloatable);

// 或只允许停靠和移动，禁止浮动和关闭
dockWidget->setFeatures(QDockWidget::DockWidgetMovable);

QDockWidget 常用功能标志：

DockWidgetClosable：允许关闭（默认启用）

DockWidgetMovable：允许移动（默认启用）

DockWidgetFloatable：允许浮动（默认启用）

DockWidgetVerticalTitleBar：垂直标题栏（适用于左侧 / 右侧停靠）

AllDockWidgetFeatures：所有功能（默认值）

NoDockWidgetFeatures：无特殊功能（仅显示）

4.4 浮动窗口与中央部件联动

浮动窗口的核心价值是辅助中央部件实现功能，通过信号槽机制可实现两者的联动（如选择浮动窗口中的文件，中央部件显示文件内容）。

示例代码：

cpp 复制代码

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 说明和示例代码。

【从零开始的Qt开发指南】（十四）Qt 窗口之“三剑客”：工具栏、状态栏、浮动窗口进阶实战指南

目录

前言

一、核心组件概述：QMainWindow 的 "左膀右臂"

二、工具栏（QToolBar）：快捷操作的 "加速器"

2.1 工具栏核心特性与创建方式

2.1.1 核心特性

2.1.2 两种创建方式

2.2 工具栏停靠位置设置：灵活定制布局

2.2.1 核心位置枚举值

2.2.2 方式一：创建时指定默认位置

2.2.3 方式二：限制允许停靠的位置

2.3 浮动属性与移动属性：控制工具栏灵活性

2.3.1 浮动属性（setFloatable）

2.3.2 移动属性（setMovable）

2.4 工具栏内容添加：QAction 与自定义控件

2.4.1 添加 QAction 对象（推荐）

2.4.2 添加自定义控件

2.5 工具栏样式定制（QSS）：打造个性化外观

三、状态栏（QStatusBar）：应用状态的 "显示器"

3.1 状态栏核心特性与创建方式

3.1.1 核心特性

3.1.2 创建方式（唯一方式）

3.2 显示实时消息：短期提示的 "弹窗替代"

3.2.1 函数原型

3.2.2 示例代码

3.2.3 清除实时消息

3.3 显示永久消息：长期信息的 "固定展示"

3.3.1 左侧添加永久消息

3.3.2 右侧添加永久消息

3.3.3 混合显示示例

3.4 显示进度消息：任务进度的 "可视化展示"

3.5 状态栏常见问题与解决方案

3.5.1 状态栏不显示

3.5.2 实时消息覆盖永久消息

3.5.3 进度条占满状态栏

四、浮动窗口（QDockWidget）：灵活扩展的 "功能面板"

4.1 浮动窗口核心特性与创建方式

4.1.1 核心特性

4.1.2 创建方式

4.2 浮动窗口停靠位置设置

4.2.1 核心位置枚举值

4.2.2 方式一：创建时指定默认位置

4.2.2 方式二：限制允许停靠的位置

4.3 浮动窗口高级特性：标签页、隐藏与激活

4.3.1 标签页式布局（多个浮动窗口合并）

4.3.2 隐藏与显示浮动窗口

4.3.3 禁止浮动窗口关闭

4.4 浮动窗口与中央部件联动

五、三大组件高级技巧与最佳实践

5.1 性能优化建议

5.2 界面设计最佳实践

5.3 常见问题与解决方案汇总

5.3.1 浮动窗口无法停靠

5.3.2 工具栏按钮无图标

5.3.3 状态栏消息不显示

5.3.4 组件联动失效

总结