桌面应用 / 系统课时

用工具栏承载高频操作

用工具栏承载高频操作

本篇介绍如何在 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,而不是为每个界面重新创建按钮。这样可以统一处理启用状态、快捷键和权限控制。

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

目录与阅读设置

阅读设置

17

记录一个想法

用工具栏承载高频操作

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

登录哪都通