桌面应用 / 系统课时
用工具栏承载高频操作
用工具栏承载高频操作
本篇介绍如何在 Qt 6 桌面应用中使用 QToolBar 组织高频操作。你将学会把 QAction 放入工具栏,配置图标、提示文字,并控制工具栏在主窗口中的显示位置。
学习目标
- 理解 QToolBar 与 QAction 的关系,以及为什么工具栏不直接绑定业务逻辑
- 掌握创建工具栏、添加动作和设置提示信息的方法
- 能根据应用布局需求调整工具栏停靠位置
使用 QAction 作为工具栏操作单元
Qt 中的工具栏并不是按钮集合,而是 QAction 的展示容器。一个 QAction 可以同时出现在菜单、工具栏或快捷键系统中,这样可以保证同一个业务操作拥有统一的状态管理。
例如“新建文件”操作,可以创建一个 QAction,然后同时加入菜单和工具栏,而不需要分别维护两个按钮的点击逻辑。
创建工具栏并添加操作
在 QMainWindow 中,可以通过 addToolBar() 创建工具栏,再使用 addAction() 放入已有动作。
cpp
#include <QApplication>
#include <QMainWindow>
#include <QToolBar>
#include <QAction>
class MainWindow : public QMainWindow {
public:
MainWindow() {
auto *newAction = new QAction("新建", this);
newAction->setToolTip("创建一个新的文档");
auto *toolbar = addToolBar("主工具栏");
toolbar->addAction(newAction);
connect(newAction, &QAction::triggered, this, []() {
// 这里连接实际业务操作,例如创建文档
});
}
};
int main(int argc, char *argv[]) {
QApplication app(argc, argv);
MainWindow window;
window.show();
return app.exec();
}预期输出
text
程序启动后显示主窗口。
窗口顶部出现“主工具栏”,其中包含“新建”操作。
鼠标悬停工具栏按钮时显示“创建一个新的文档”提示。配置图标和工具栏位置
桌面应用通常使用图标表达高频动作,文字用于辅助理解。QAction 可以设置图标,工具栏可以通过 QMainWindow 的停靠策略调整位置。
常见设置方式如下:
cpp
newAction->setIcon(QIcon(":/icons/new.png"));
addToolBar(Qt::LeftToolBarArea, toolbar);预期结果
text
工具栏显示指定图标。
工具栏停靠到主窗口左侧区域。资源路径中的图标通常来自 Qt Resource System,需要提前在项目资源文件中注册。不要直接依赖运行目录下的相对文件路径,否则发布后的程序可能无法加载资源。
工具栏设计中的常见边界
工具栏适合放置高频、低复杂度操作,例如保存、撤销、刷新等。低频功能或复杂配置页面不适合放入工具栏,否则会增加界面认知负担。
当多个界面共享同一操作时,应优先复用 QAction,而不是为每个界面重新创建按钮。这样可以统一处理启用状态、快捷键和权限控制。
按自己的节奏,确认真正理解。