桌面应用 / 系统课时

添加菜单项与快捷键

添加菜单项与快捷键

本篇解决 Qt 桌面应用命令管理问题,通过 QAction 将菜单、工具栏和快捷键统一绑定到同一个操作逻辑,让应用具备一致的用户交互方式。

学习目标

  • 理解 QAction 在 Qt 命令系统中的作用
  • 掌握菜单项、图标和快捷键的创建方式
  • 能够连接 QAction 触发事件完成业务处理

理解 QAction 的职责

在 Qt 中,菜单项和工具栏按钮本质上都是命令入口。如果分别为菜单和按钮编写事件处理,会导致代码重复和行为不一致。

QAction 用来表示一个用户操作,例如“打开文件”“保存文档”“退出程序”。它可以同时被菜单、工具栏和快捷键使用。

一个 QAction 通常包含:

  • 显示文本
  • 图标
  • 快捷键
  • 触发信号
  • 是否启用状态

这样设计后,用户通过不同入口执行同一个操作时,会进入相同逻辑。

创建菜单命令

下面示例创建一个“退出”操作,并同时添加到菜单和快捷键中。

cpp
#include <QApplication>
#include <QMainWindow>
#include <QAction>
#include <QMenuBar>

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

    QMainWindow window;

    QAction *quitAction = new QAction("退出", &window);
    // Ctrl+Q 是该命令的快捷方式
    quitAction->setShortcut(QKeySequence("Ctrl+Q"));

    QObject::connect(quitAction, &QAction::triggered, &app, &QApplication::quit);

    QMenu *fileMenu = window.menuBar()->addMenu("文件");
    fileMenu->addAction(quitAction);

    window.show();
    return app.exec();
}

预期输出

text
启动窗口后,菜单栏出现“文件”菜单。
点击“退出”或按 Ctrl+Q 后,应用程序关闭。

设置图标和启用状态

桌面应用通常需要让用户快速识别常用操作,可以为 QAction 设置图标。

cpp
QAction *saveAction = new QAction("保存", &window);
saveAction->setIcon(QIcon(":/icons/save.png"));
saveAction->setEnabled(true);

预期结果

text
创建后的 QAction 可以显示保存图标,并根据 enabled 状态决定是否允许触发。

资源路径 :/icons/save.png 依赖 Qt 资源系统配置,实际项目中需要提前将图片加入 .qrc 文件。

在菜单和工具栏中复用 QAction

同一个 QAction 可以重复添加到多个界面位置。

例如保存操作既可以出现在菜单,也可以出现在工具栏:

cpp
QAction *saveAction = new QAction("保存", &window);

window.menuBar()->addMenu("文件")->addAction(saveAction);
window.addToolBar("工具")->addAction(saveAction);

预期结果

text
“保存”命令同时出现在文件菜单和工具栏中,两个入口共享同一个触发逻辑。

设计 QAction 时的常见边界

QAction 适合表达用户操作,不适合直接承载复杂业务逻辑。大型应用中通常让 QAction 触发槽函数,再由业务对象完成实际处理。

例如文件保存流程可能包含校验、写入、错误提示等步骤,这些逻辑应该放在独立类中,而不是全部写入 triggered 信号连接位置。

合理使用 QAction 可以让菜单、工具栏和快捷键保持一致,同时降低后续维护成本。

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

目录与阅读设置

阅读设置

17

记录一个想法

添加菜单项与快捷键

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

登录哪都通