当前位置：首页 > news >正文

Qt 窗口：菜单、工具与状态栏的应用

news 文章来源：https://blog.csdn.net/weixin_65931202/article/details/141109130 2025/5/4 11:48:07

引言：

1. 菜单栏

1.1 创建菜单栏

1.2 在菜单栏中添加菜单

1.3 创建菜单项

1.4 在菜单项之间添加分割线

1.5 综合示例

2.工具栏

2.1 创建工具栏

2.2 设置停靠位置

2.3 设置浮动属性

2.4 设置移动属性

3. 状态栏

3.1 状态栏的创建

3.2 在状态栏中显示实时消息

3.3 在状态栏中显示永久消息

4. 浮动窗口

4.1 浮动窗口的创建

4.2 设置停靠的位置

引言：

Qt 窗口是通过 QMainWindow类来实现的。

QMainWindow 是⼀个为用户提供主窗口程序的类，继承自 QWidget 类，并且提供了一个预定义的布局。QMainWindow 包含 一个菜单栏（menu bar）、多个工具栏(tool bars)【工具栏本质上就是把菜单栏中的一些比较常用的选项，直接放到工具栏里了，直接点击工具栏中的按钮就能快速生效】、多个浮动窗口（铆接部件）(dock widgets)、一个状态栏(status bar) 和一个 中心部件(central widget)，它是许多应用程序的基础，如文本编辑器，图片编辑器等。如下图为 QMainwindow 中各组件所处的位置：

1. 菜单栏

Qt 中的菜单栏是通过 QMenuBar 这个类来实现的。一个主窗口最多只有一个菜单栏。位于主窗口顶部、主窗口标题栏下面。

菜单栏中包含菜单. 菜单中包含菜单项.

1.1 创建菜单栏

方式一：菜单栏的创建可以借助于 QMainWindow类 提供的 menuBar() 函数来实现。

menubar()函数原型如下：

QMenuBar * menuBar() const

// 创建菜单栏
QMenuBar* menubar = menuBar();// 将菜单栏放入窗口中
this->setMenuBar(menubar);

方式二：在堆上动态创建；

使用 setMenuBar 把菜单栏放到窗口中.

// 创建菜单栏
QMenuBar* menubar = new QMenuBar(this);// 将菜单栏放入窗口中
this->setMenuBar(menubar);

1.2 在菜单栏中添加菜单

创建菜单，并通过 QMenu 提供的 addMenu() 函数来添加菜单。

示例：

// 创建菜单栏
QMenuBar* menubar = new QMenuBar();// 将菜单栏放入窗口中
this->setMenuBar(menubar);// 创建菜单
QMenu* menu1 = new QMenu("文件");
QMenu* menu2 = new QMenu("编辑");
QMenu* menu3 = new QMenu("视图");// 添加菜单到菜单栏中
menubar->addMenu(menu1);
menubar->addMenu(menu2);
menubar->addMenu(menu3);

1.3 创建菜单项

在 Qt 中，并没有专门的菜单项类，可以通过 QAction 类，抽象出公共的动作。如在菜单中添加菜单项.

🌴QAction 可以给菜单栏使用, 也可以给工具栏使用.

示例：

// 创建菜单项
QAction* action1 = new QAction("新建");
QAction* action2 = new QAction("打开");
QAction* action3 = new QAction("保存");
QAction* action4 = new QAction("另存为");
QAction* action5 = new QAction("退出");// 将菜单添加到菜单上
menu1->addAction(action1);
menu1->addAction(action2);
menu1->addAction(action3);
menu1->addAction(action4);
menu1->addAction(action5);

1.4 在菜单项之间添加分割线

在菜单项之间可以添加分割线。分割线如下图所示，添加分割线是通过 QMenu 类提供的 addSeparator() 函数来实现；

示例：

// 创建菜单项
QAction* action1 = new QAction("新建");
QAction* action2 = new QAction("打开");
QAction* action3 = new QAction("保存");
QAction* action4 = new QAction("另存为");
QAction* action5 = new QAction("退出");// 将菜单添加到菜单上
menu1->addAction(action1);
menu1->addSeparator();// 在 “新建” 和 “打开” 中间添加分割线
menu1->addAction(action2);
menu1->addAction(action3);
menu1->addAction(action4);
menu1->addAction(action5);

1.5 综合示例

在窗口上创建一个菜单栏，在菜单栏中添加一些菜单，在某一个菜单中添加一些菜单项。

1、新建 Qt 项目

注意：此时新建项目时选择的基类 QMainwindow ，如下图示：

2、在 "mainwindow.cpp" 文件中创建菜单和中央控件

创建一个菜单栏, 一个菜单.
两个菜单项: 保存, 加载
创建一个 QTextEdit 作为窗口的中央控件.

MainWindow::MainWindow(QWidget *parent): QMainWindow(parent), ui(new Ui::MainWindow)
{ui->setupUi(this);// 设置标题this->setWindowTitle("我的记事本");// 创建菜单栏QMenuBar* menubar = this->menuBar();this->setMenuBar(menubar);// 创建菜单QMenu* menu = new QMenu("文件");menubar->addMenu(menu);// 创建菜单项QAction* action1 = new QAction("保存");QAction* action2 = new QAction("加载");menu->addAction(action1);menu->addAction(action2);// 创建中央控件QTextEdit* edit = new QTextEdit(this);this->setCentralWidget(edit);edit->setPlaceholderText("此处编写文本内容...");
}

3、给 action 添加一些动作

// 连接信号槽，点击 action 时触发一定的效果connect(action1, &QAction::triggered, this, &MainWindow::save);connect(action2, &QAction::triggered, this, &MainWindow::load);

实现这两个槽函数

a. 使用 QFileDialog 来实现选择文件的效果.

getSaveFileName 用于保存文件的场景. 此时的对话框可以输入文件名.
getOpenFileName 用于打开文件的场景. 此时的对话框可以获取到鼠标选择的文件名.

b. 搭配 C++ 标准库的文件操作实现文件读写.

void MainWindow::save()
{// 弹出对话框, 选择写⼊⽂件的路径QFileDialog* dialog = new QFileDialog(this);QString fileName = dialog->getSaveFileName(this, "保存⽂件", "D:/");qDebug() << "fileName: " << fileName;// 写⼊⽂件std::ofstream file(fileName.toStdString().c_str());if (!file.is_open()) {qDebug() << "⽂件保存失败!";return;}const QString& text = edit->toPlainText();file << text.toStdString();file.close();
}void MainWindow::load()
{// 弹出对话框, 选择打开的⽂件QFileDialog* dialog = new QFileDialog(this);QString fileName = dialog->getOpenFileName(this, "加载⽂件", "D:/");qDebug() << "fileName: " << fileName;// 读取⽂件std::ifstream file(fileName.toStdString().c_str());if (!file.is_open()) {qDebug() << "⽂件加载失败!";return;}std::string content;std::string line;while (std::getline(file, line)) {content += line;content += "\n";}file.close();// 显⽰到界⾯上QString text = QString::fromStdString(content);edit->setPlainText(text);
}

4、执行程序, 此时就可以通过程序来保存/加载文件了. 并且对文件进行编辑.

2.工具栏

工具栏是应用程序中集成各种功能实现快捷键使用的一个区域。可以有多个，也可以没有，它并不是应用程序中必须存在的组件。它是一个可移动的组件，它的元素可以是各种窗口组件，它的元素通常以图标按钮的方式存在。如下图为工具栏的示意图：

2.1 创建工具栏

调用 QMainWindow类的 addToolBar() 函数来创建工具栏，每增加一个工具栏都需要调用一次该函数。

代码示例：

1.编写 mainwindow.cpp，在构造函数中编写初始化代码

MainWindow::MainWindow(QWidget *parent): QMainWindow(parent), ui(new Ui::MainWindow)
{ui->setupUi(this);// 工具栏需要手动创建出来，自身不会创建QToolBar* toolbar = new QToolBar();this->addToolBar(toolbar);QAction* action1 = new QAction("保存");QAction* action2 = new QAction("退出");toolbar->addAction(action1);toolbar->addAction(action2);connect(action1, &QAction::triggered, this, &MainWindow::save);connect(action2, &QAction::triggered, this, &MainWindow::exit);
}

注意：

添加菜单栏，使用的是 setMenuBar，这是因为菜单栏只能有一个，重复设置，就会新的替换旧的（set 就包含了 “替换”）。
添加工具栏，使用的是 addToolBar，这是因为工具栏可以有多个，重复设置，就会出现多个工具栏，不包含 “替换”。

2.给工具栏的快捷项设置 slot 函数

void MainWindow::save()
{qDebug() << "save";
}void MainWindow::exit()
{qDebug() << "exit";
}

3.执行程序，观察效果

4.工具栏展示的一般是图标，而不是文本，所以我们给它设置成图标（使用 qrc 机制）

QAction* action1 = new QAction("保存");
QAction* action2 = new QAction("退出");
action1->setIcon(QIcon(":/save.png"));
action2->setIcon(QIcon(":/exit.png"));
toolbar->addAction(action1);
toolbar->addAction(action2);

注意：

QAction 如果出现在工具栏上，也会产生图标覆盖文本这样的情况，但是，当我们将文本替换成图标后，之前设置的文本会以 toolTip 的方式来存在，当鼠标悬停上去的时候，就会显示出一段提示信息，另外，我们也可以手动设置这里的 toolTip~

action1->setToolTip("点击这里保存文件");

5.工具栏往往也是和菜单栏搭配使用的，即工具栏中的 QAction 也可以出现在菜单中

MainWindow::MainWindow(QWidget *parent): QMainWindow(parent), ui(new Ui::MainWindow)
{ui->setupUi(this);// 创建菜单栏QMenuBar* menubar = this->menuBar();this->setMenuBar(menubar);// 创建菜单QMenu* menu = new QMenu("文件");menubar->addMenu((menu));// 工具栏需要手动创建出来，自身不会创建QToolBar* toolbar = new QToolBar();this->addToolBar(toolbar);// 创建两个菜单项QAction* action1 = new QAction("保存");QAction* action2 = new QAction("退出");
//    action1->setToolTip("点击这里保存文件");action1->setIcon(QIcon(":/save.png"));action2->setIcon(QIcon(":/exit.png"));// 菜单项放到工具栏中toolbar->addAction(action1);toolbar->addAction(action2);// 菜单项放在菜单中menu->addAction(action1);menu->addAction(action2);
}

2.2 设置停靠位置

工具栏停靠位置的设置有两种方式。一种是在创建工具栏的同时指定停靠的位置，另一种是通过QToolBar类提供的 setAllowedAreas()函数来设置。

🍒方式一：创建工具栏的同时指定其停靠的位置。

在创建工具栏的同时，也可以设置工具栏的位置，其默认位置是在窗口的最上面；如上述代码，默认在最上面显示。工具栏允许停靠的区域由 QToolBar类提供的 allowAreas()函数决定，其中可以设置的位置包括：

Qt::LeftToolBarArea 停靠在左侧
Qt::RightToolBarArea 停靠在右侧
Qt::TopToolBarArea 停靠在顶部
Qt::BottomToolBarArea 停靠在底部
Qt::AllToolBarAreas 以上四个位置都可停靠

代码示例：

MainWindow::MainWindow(QWidget *parent): QMainWindow(parent), ui(new Ui::MainWindow)
{ui->setupUi(this);// 创建工具栏QToolBar* toolBar1 = new QToolBar();QToolBar* toolBar2 = new QToolBar();// 创建工具栏的同时，指定工具栏在左侧显示this->addToolBar(Qt::LeftToolBarArea, toolBar1);// 创建工具栏的同时，指定工具栏在右侧显示this->addToolBar(Qt::RightToolBarArea, toolBar2);QAction* action1 = new QAction("新建");QAction* action2 = new QAction("打开");QAction* action3 = new QAction("关闭");QAction* action4 = new QAction("保存");toolBar1->addAction(action1);toolBar1->addAction(action2);toolBar2->addAction(action3);toolBar2->addAction(action4);
}

🍒方式二：使用 QToolBar类提供的 setAllowedAreas()函数设置停靠位置。

代码示例：

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(toolBar2);// 只允许在顶部停靠toolBar1->setAllowedAreas(Qt::TopToolBarArea);// 只允许在底部停靠toolBar2->setAllowedAreas(Qt::BottomToolBarArea);QAction* action1 = new QAction("新建");QAction* action2 = new QAction("打开");QAction* action3 = new QAction("关闭");QAction* action4 = new QAction("保存");toolBar1->addAction(action1);toolBar1->addAction(action2);toolBar2->addAction(action3);toolBar2->addAction(action4);
}

说明：

在创建工具栏的同时指定其停靠的位置，指的是程序运行时工具栏默认所在的位置；而使用setAllowedAreas()函数设置停靠位置，指的是工具栏允许其所能停靠的位置。

2.3 设置浮动属性

工具栏的浮动属性可以通过 QToolBar类提供的 setFloatable()函数来设置。

setFloatable()函数原型为：

void setFloatable (bool floatable)

参数：

true：浮动
false：不浮动

代码示例：

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(toolBar2);// 只允许在顶部停靠toolBar1->setAllowedAreas(Qt::TopToolBarArea);// 只允许在底部停靠toolBar2->setAllowedAreas(Qt::BottomToolBarArea);toolBar1->setFloatable(true);// 允许工具栏浮动toolBar2->setFloatable(false);// 不允许工具栏浮动QAction* action1 = new QAction("新建");QAction* action2 = new QAction("打开");QAction* action3 = new QAction("关闭");QAction* action4 = new QAction("保存");toolBar1->addAction(action1);toolBar1->addAction(action2);toolBar2->addAction(action3);toolBar2->addAction(action4);
}

2.4 设置移动属性

设置工具栏的移动属性可以通过 QToolBar类提供的 setMovable()函数来设置。

setMovable()函数原型为

void setMovable(bool movable)

参数：

true：移动
false：不移动

说明：

若设置工具栏为不移动状态，则设置其停靠位置的操作就不会生效，所以设置工具栏的移动属性类似于总开关的效果。

代码示例：

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(toolBar2);// 只允许在顶部停靠toolBar1->setAllowedAreas(Qt::TopToolBarArea);// 只允许在底部停靠toolBar2->setAllowedAreas(Qt::BottomToolBarArea);toolBar1->setFloatable(true);// 允许工具栏浮动toolBar2->setFloatable(false);// 不允许工具栏浮动toolBar1->setMovable(true);// 允许移动toolBar2->setMovable(false);// 不允许移动QAction* action1 = new QAction("新建");QAction* action2 = new QAction("打开");QAction* action3 = new QAction("关闭");QAction* action4 = new QAction("保存");toolBar1->addAction(action1);toolBar1->addAction(action2);toolBar2->addAction(action3);toolBar2->addAction(action4);
}

3. 状态栏

状态栏是应用程序中输出简要信息的区域。一般位于主窗口的最底部，一个窗口中最多只能有一个状态栏。在 Qt 中，状态栏是通过 QStatusBar类来实现的。在状态栏中可以显示的消息类型有：

实时消息：如当前程序状态
永久消息：如程序版本号，机构名称
进度消息：如进度条提示，百分百提示

3.1 状态栏的创建

状态栏的创建是通过 QMainWindow 类提供的 statusBar() 函数来创建；

代码示例：

MainWindow::MainWindow(QWidget *parent): QMainWindow(parent), ui(new Ui::MainWindow)
{ui->setupUi(this);// 存在就获取，不存在就创建QStatusBar* statusBar = this->statusBar();// 如果状态栏没有被创建，这样的设置是必要的// 如果状态栏已经在窗口中存在，这样的设置其实意义不大，但也没副作用，仍然保留this->setStatusBar(statusBar);
}

3.2 在状态栏中显示实时消息

在状态栏中显示实时消息是通过 showMessage() 函数来实现。

通过 showMessage 可以在状态栏中显示一个文本，此时这个文本存在的时间可以自定义。timeOut 参数是一个单位为 ms 的时间，如果 timeOut 为 0（不填），消息就会持久存在。

代码示例：

MainWindow::MainWindow(QWidget *parent): QMainWindow(parent), ui(new Ui::MainWindow)
{ui->setupUi(this);// 存在就获取，不存在就创建QStatusBar* statusBar = this->statusBar();// 如果状态栏没有被创建，这样的设置是必要的// 如果状态栏已经在窗口中存在，这样的设置其实意义不大，但也没副作用，仍然保留this->setStatusBar(statusBar);// 状态栏中显示大约 3秒 的“Hello Qt”statusBar->showMessage("Hello Qt", 3000);
}

3.3 在状态栏中显示永久消息

在状态栏中可以显示永久消息，此处的永久消息是通过标签来显示的，也可以添加其它控件。

代码示例：

MainWindow::MainWindow(QWidget *parent): QMainWindow(parent), ui(new Ui::MainWindow)
{ui->setupUi(this);// 存在就获取，不存在就创建QStatusBar* statusBar = this->statusBar();// 如果状态栏没有被创建，这样的设置是必要的// 如果状态栏已经在窗口中存在，这样的设置其实意义不大，但也没副作用，仍然保留this->setStatusBar(statusBar);// 创建标签QLabel* label = new QLabel("提示信息");// 将标签放入状态栏中statusBar->addWidget(label);// 创建进度条并将进度条放入状态栏中QProgressBar* progressBar = new QProgressBar();progressBar->setRange(0, 100);progressBar->setValue(50);statusBar->addWidget(progressBar);
}

显示效果如下：

调整显示消息的位置：

QPushButton* button = new QPushButton("按钮");
statusBar->addPermanentWidget(button);

显示效果如下：

4. 浮动窗口

在 Qt 中，浮动窗口也称之为铆接部件。浮动窗口是通过 QDockWidget类来实现浮动的功能。浮动窗口一般是位于核心部件的周围，可以有多个。

4.1 浮动窗口的创建

浮动窗口的创建是通过 QDockWidget类提供的构造方法 QDockWidget()函数动态创建的；

代码示例：

MainWindow::MainWindow(QWidget *parent): QMainWindow(parent), ui(new Ui::MainWindow)
{ui->setupUi(this);// 浮动窗口QDockWidget* dockWidget = new QDockWidget();// 将浮动窗口置于当前窗口中this->addDockWidget(Qt::LeftDockWidgetArea, dockWidget);// 给浮动窗口设置标题dockWidget->setWindowTitle("浮动窗口");// 给浮动窗口内部添加一些其它的控件// 不能直接给这个浮动窗口添加子控件，而是需要创建出一个单独的 QWidget，把要添加的控件加入到 QWidget 中// 然后再把这个 QWidget 设置到 dockWidget 中QWidget* container = new QWidget();dockWidget->setWidget(container);// 创建布局管理器，把布局管理器设置到 QWidget 中QVBoxLayout* vlayout = new QVBoxLayout();container->setLayout(vlayout);// 创建其它控件添加到 layout 中QLabel* label = new QLabel("标签");QPushButton* button = new QPushButton("按钮");vlayout->addWidget(label);vlayout->addWidget(button);
}

4.2 设置停靠的位置

浮动窗口是位于中心部件的周围。可以通过 QDockWidget类中提供 setAllowedAreas() 函数设置其允许停靠的位置。其中可以设置允许停靠的位置有：

Qt::LeftDockWidgetArea 停靠在左侧
Qt::RightDockWidgetArea 停靠在右侧
Qt::TopDockWidgetArea 停靠在顶部
Qt::BottomDockWidgetArea 停靠在底部
Qt::AllDockWidgetAreas 以上四个位置都可停靠

示例如下：设置浮动窗口只允许上下停靠

// 设置浮动窗口的区域，只允许上下停靠
dockWidget->setAllowedAreas(Qt::TopDockWidgetArea | Qt::BottomDockWidgetArea);

引言：

1. 菜单栏

1.1 创建菜单栏

1.2 在菜单栏中添加菜单

1.3 创建菜单项

1.4 在菜单项之间添加分割线

1.5 综合示例

2.工具栏

2.1 创建工具栏

2.2 设置停靠位置

2.3 设置浮动属性

2.4 设置移动属性

3. 状态栏

3.1 状态栏的创建

3.2 在状态栏中显示实时消息

3.3 在状态栏中显示永久消息

4. 浮动窗口

4.1 浮动窗口的创建

4.2 设置停靠的位置

相关文章：