桌面应用 / 系统课时

用 QMainWindow 组织主窗口

用 QMainWindow 组织主窗口

本篇解决 Qt 桌面应用主窗口结构设计问题,帮助你理解 QMainWindow 如何管理中心内容、菜单栏、工具栏、状态栏和停靠区域,并完成一个可扩展的应用窗口布局。

学习目标

  • 理解 QMainWindow 与普通 QWidget 窗口的结构差异
  • 掌握 centralWidget、QDockWidget 等核心区域的职责
  • 能够设计适合桌面应用的主窗口布局

理解 QMainWindow 的区域划分

QMainWindow 是 Qt 为桌面应用提供的主窗口类,它不是简单的容器,而是预定义了一套标准窗口布局。常见 IDE、编辑器和管理工具中的菜单、工具栏、侧边栏和状态提示,都可以通过这些区域实现。

QMainWindow 主要包含以下区域:

区域 对应组件 作用
中央区域 centralWidget 放置应用主要内容
顶部区域 QMenuBar、QToolBar 放置命令入口和常用操作
底部区域 QStatusBar 显示状态信息
四周停靠区域 QDockWidget 放置可移动辅助面板

这些区域由 QMainWindow 统一管理,开发者通常只需要向对应位置添加组件,而不需要手动计算布局。

QMainWindow 主窗口区域结构示意图

使用 centralWidget 放置主要内容

QMainWindow 自身不应该直接作为业务内容容器使用。应用页面通常需要设置一个中心组件,例如文本编辑器、表格、绘图区域或复杂表单。

下面创建一个简单主窗口,将文本编辑区域作为中心内容:

cpp
#include <QApplication>
#include <QMainWindow>
#include <QTextEdit>

int main(int argc, char *argv[])
{
    QApplication app(argc, argv);

    QMainWindow window;

    // centralWidget 负责承载应用主要工作区域
    QTextEdit *editor = new QTextEdit;
    editor->setPlaceholderText("请输入内容");
    window.setCentralWidget(editor);

    window.resize(800, 600);
    window.show();

    return app.exec();
}

预期输出

text
窗口启动后显示一个 800x600 的 Qt 主窗口,中央区域出现可编辑文本框。

centralWidget 只能设置一个,如果需要多个页面,通常会在 centralWidget 内部放置 QStackedWidget 或其他布局容器。

添加工具栏和状态栏

菜单栏适合组织完整命令体系,工具栏适合放置高频操作按钮,状态栏适合反馈当前状态。

例如编辑器类应用通常会把“新建”“保存”等操作放入工具栏,同时在状态栏显示当前文件信息。

cpp
QToolBar *toolbar = window.addToolBar("文件操作");
toolbar->addAction("保存");

window.statusBar()->showMessage("就绪");

预期结果

text
窗口顶部出现文件操作工具栏,底部状态栏显示“就绪”。

使用 Dock 区域扩展辅助功能

QDockWidget 用于实现可拖动的辅助面板,例如文件浏览器、属性编辑器、日志窗口等。

它适合放置不会占据主要工作区域,但用户可能需要频繁查看的信息。

设计主窗口时,应避免把所有内容都放入 Dock,否则核心操作区域会被压缩。

什么时候选择 QMainWindow

如果应用包含菜单、工具栏、状态提示或类似 IDE 的复杂窗口结构,优先选择 QMainWindow。

如果只是一个简单对话框、设置窗口或单一功能页面,使用 QWidget 或 QDialog 会更直接。QMainWindow 的价值在于提供稳定的桌面应用骨架,而不是替代所有窗口类型。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

用 QMainWindow 组织主窗口

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通