devbox
花生_TL007
这个屌丝很懒，什么也没留下！
关注作者
热门标签
热门文章
当前位置:   article > 正文

QtCreator插件开发（二）——QtCreator菜单和菜单项_qtcreator menu

作者：花生_TL007 | 2024-02-27 15:35:52

赞

踩

qtcreator menu

一、QtCreator菜单栏简介

1、QtCreator菜单简介

QtCreator菜单栏如下：

 QtCreator默认菜单包括“文件”、“编辑”、“工具”、“窗体”、“帮助”。“构建”、“调试”、“分析”由插件提供，不是QtCreator的默认菜单。在“帮助”菜单中的“关于插件”对话框中将所有可以取消的插件取消后重启QtCreator，得到QtCreator默认菜单如下：

2、Core::ActionManager简介

 QtCreator主程序仅仅是一个插件加载器。QtCreator所提供的所有功能都是通过插件实现的。QtCreator最主要的一个插件叫做Core插件。如果没有Core插件，QtCreator将没有插件加载功能。Core插件的关键组件是ActionManager。ActionManager的作用是注册菜单、菜单项以及键盘快捷键。如果想要添加新的菜单或菜单项，就需要使用ActionManager。

 为了访问ActionManager，可以使用下面的代码：

  1. #include <coreplugin/actionmanager/actionmanager.h>
  2. #include <coreplugin/icore.h>
  3.  
  4. Core::ActionManager* am = Core::ICore::instance()->actionManager();

3、Core::ActionContainer简介

ActionContianer表示QtCreator中的菜单或者菜单栏。通常不会直接创建ActionContainer的实例，而通过ActionManager::createMenu()、ActionManager::createMenuBar()函数进行访问。

QtCreator每一个默认菜单都关联一个ActionContainer对象。给定一个菜单，获取其关联的ActionContainer对象，可以使用下面的代码：

  1. #include <coreplugin/coreconstants.h>
  2. #include <coreplugin/actionmanager/actionmanager.h>
  3. #include <coreplugin/actionmanager/actioncontainer.h>
  4. #include <coreplugin/icore.h>
  5.  
  6. Core::ActionManager* am = Core::ICore::instance()->actionManager();
  7. Core::ActionContainer* ac = am->actionContainer(ID);

QtCreator每个菜单的ID如下：

 每个ID都是Core命名空间中的静态const char *常量，$$QT_CREATOR_ROOT/src/plugins/coreplugin/coreconstants.h文件中定义了这些常量。

如果想要访问“Help”菜单，可以使用如下的代码：

  1. #include <coreplugin/coreconstants.h>
  2. #include <coreplugin/actionmanager/actionmanager.h>
  3. #include <coreplugin/actionmanager/actioncontainer.h>
  4. #include <coreplugin/icore.h>
  5.  
  6. Core::ActionManager* am = Core::ICore::instance()->actionManager();
  7. Core::ActionContainer* ac =  am->actionContainer( Core::Constants::M_HELP );

二、添加菜单项

如果将DoNothing插件添加到“Help”菜单，增加为“About DoNothing”菜单项。

DoNothingPlugin.cpp文件修改如下：

  1. #include <coreplugin/coreconstants.h>
  2. #include <coreplugin/actionmanager/actionmanager.h>
  3. #include <coreplugin/actionmanager/actioncontainer.h>
  4. #include <coreplugin/icore.h>
  5. #include <QMenu>
  6.  
  7. bool DoNothingPlugin::initialize(const QStringList& args, QString *errMsg)
  8. {
  9.     Q_UNUSED(args);
  10.     Q_UNUSED(errMsg);
  11.  
  12.     Core::ActionManager* am = Core::ICore::instance()->actionManager();
  13.     Core::ActionContainer* ac = am->actionContainer(Core::Constants::M_HELP);
  14.     QAction* aboutDoNothing = ac->menu()->addAction(QString::fromUtf8("About DoNothing"));
  15.  
  16.     return true;
  17. }

编译后启动QtCreator，菜单如下：

 

虽然可以使用上述方法添加菜单项，但并不是推荐的方式。QtCreator中的菜单项必须在Keyboard Shortcuts参数界面中列出。

通过注册菜单项，可以实现QtCreator中的菜单项在Keyboard Shortcuts参数界面中列出。

三、注册菜单项

QtCreator的所有菜单项都应该出现在键盘选择里面的“Keyboard Shortcuts” 中。

Core::Command类表示一个action动作，例如菜单项menu item、工具按钮tool button，或者是快捷键shortcut。开发者不能直接创建Command对象，而是使用ActionManager::registerAction()注册一个 action，然后获取返回值，其返回值就是一个Command。Command对象表示用户可见的action及其属性。

下面代码显示了如何为DoNothing插件注册“About DoNothing” 菜单项：

  1. #include <coreplugin/coreconstants.h>
  2. #include <coreplugin/actionmanager/actionmanager.h>
  3. #include <coreplugin/actionmanager/command.h>
  4. #include <coreplugin/icore.h>
  5.  
  6. #include <QKeySequence>
  7. #include <QAction>
  8.  
  9. bool DoNothingPlugin::initialize(const QStringList& args, QString *errMsg)
  10. {
  11.     Q_UNUSED(args);
  12.     Q_UNUSED(errMsg);
  13.  
  14.     // Fetch the action manager
  15.     Core::ActionManager* am = Core::ICore::instance()->actionManager();
  16.  
  17.     // Create a command for "About DoNothing".
  18.     Core::Command* cmd = am->registerAction(
  19.                 new QAction(this),
  20.                 "DoNothingPlugin.AboutDoNothing",
  21.                 Core::Context(Core::Constants::C_GLOBAL));
  22.     cmd->action()->setText(QString::fromUtf8("About DoNothing"));
  23.  
  24.     // Add the command to Help menu
  25.     am->actionContainer(Core::Constants::M_HELP)->addAction(cmd);
  26.  
  27.     return true;
  28. }

编译后运行，About DoNothing菜单项已经出现在Help菜单的开始位置。

 

使用注册方式添加菜单项，可以在Keyboard Shortcuts参数界面中列出About DoNothing菜单项，并可以关联快捷键。

 四、响应菜单项

DoNothing插件已经作为一个菜单项加入到QtCreator中。既然菜单项就是一个QAction，可以通过连接triggered(bool)或者toggled(bool)信号，并增加响应trigger、toggled事件的槽函数。

插件类的实现如下：

DoNothingPlugin.h文件：

  1. #ifndef DONOTHINGPLUGIN_H
  2. #define DONOTHINGPLUGIN_H
  3.  
  4.  
  5. #include <extensionsystem/iplugin.h>
  6.  
  7. class DoNothingPlugin : public ExtensionSystem::IPlugin
  8. {
  9.     Q_OBJECT
  10. public:
  11.     DoNothingPlugin();
  12.     ~DoNothingPlugin();
  13.  
  14.     void extensionsInitialized();
  15.     bool initialize(const QStringList & arguments, QString * errorString);
  16.     void shutdown();
  17. protected slots:
  18.     void doNothing();
  19. };
  20.  
  21. #endif // DONOTHINGPLUGIN_H

DoNothingPlugin.cpp文件：

  1. #include "DoNothingPlugin.h"
  2. #include <QtPlugin>
  3. #include <QStringList>
  4. #include <coreplugin/coreconstants.h>
  5. #include <coreplugin/actionmanager/actionmanager.h>
  6. #include <coreplugin/actionmanager/actioncontainer.h>
  7. #include <coreplugin/icore.h>
  8. #include <QKeySequence>
  9. #include <QAction>
  10. #include <QMessageBox>
  11.  
  12.  
  13. DoNothingPlugin::DoNothingPlugin()
  14. {
  15.     // Do nothing
  16. }
  17.  
  18. DoNothingPlugin::~DoNothingPlugin()
  19. {
  20.     // Do notning
  21. }
  22.  
  23. bool DoNothingPlugin::initialize(const QStringList& args, QString *errMsg)
  24. {
  25.     Q_UNUSED(args);
  26.     Q_UNUSED(errMsg);
  27.  
  28.     // Fetch the action manager
  29.     Core::ActionManager* am = Core::ICore::instance()->actionManager();
  30.  
  31.     // Create a command for "About DoNothing".
  32.     Core::Command* cmd = am->registerAction(
  33.                 new QAction(this),
  34.                 "DoNothingPlugin.AboutDoNothing",
  35.                 Core::Context(Core::Constants::C_GLOBAL));
  36.     cmd->action()->setText(QString::fromUtf8("About DoNothing"));
  37.     // Add the command to Help menu
  38.     am->actionContainer(Core::Constants::M_HELP)->addAction(cmd);
  39.  
  40.     connect(cmd->action(), SIGNAL(triggered(bool)), this, SLOT(doNothing()));
  41.     return true;
  42. }
  43.  
  44. void DoNothingPlugin::extensionsInitialized()
  45. {
  46.     // Do nothing
  47. }
  48.  
  49. void DoNothingPlugin::shutdown()
  50. {
  51.     // Do nothing
  52. }
  53.  
  54. void DoNothingPlugin::doNothing()
  55. {
  56.     QMessageBox::information(
  57.             0,
  58.             QString::fromUtf8("About DoNothing Plugin"),
  59.             QString::fromUtf8("Seriously dude, this plugin does nothing")
  60.         );
  61. }
  62.  
  63.  
  64. Q_EXPORT_PLUGIN(DoNothingPlugin)

编译后运行QtCreator，点击DoNothing菜单项：

 使用Qt Creator主窗口作为弹出消息对话框的parent，代码修改如下：

  1. void DoNothingPlugin::doNothing()
  2. {
  3.     QMessageBox::information(
  4.      Core::ICore::instance()->mainWindow(),
  5.      "About DoNothing Plugin",
  6.      "Seriously dude, this plugin does nothing");
  7. }

五、添加菜单

向QtCreator添加菜单不能使用Core::Command，而是使用Core::ActionContainer，将其添加到MENU_BAR上面。代码如下：

  1. #include <QMenu>
  2.  
  3.  
  4.  
  5. bool DoNothingPlugin::initialize(const QStringList& args, QString *errMsg)
  6. {
  7.     Q_UNUSED(args);
  8.     Q_UNUSED(errMsg);
  9.  
  10.     // Fetch the action manager
  11.     Core::ActionManager* am = Core::ICore::instance()->actionManager();
  12.  
  13.     // Create a DoNothing menu
  14.     Core::ActionContainer* ac =  am->createMenu("DoNothingPlugin.DoNothingMenu");
  15.     ac->menu()->setTitle(QString::fromUtf8("DoNothing"));
  16.     // Create a command for "About DoNothing".
  17.     Core::Command* cmd = am->registerAction(
  18.                 new QAction(this),
  19.                 "DoNothingPlugin.AboutDoNothing",
  20.                 Core::Context(Core::Constants::C_GLOBAL));
  21.     cmd->action()->setText(QString::fromUtf8("About DoNothing"));
  22.     connect(cmd->action(), SIGNAL(triggered(bool)), this, SLOT(doNothing()));
  23.     // Add DoNothing menu to the menubar
  24.     am->actionContainer(Core::Constants::MENU_BAR)->addMenu(ac);
  25.     // Add the "About DoNothing" action to the DoNothing menu
  26.     ac->addAction(cmd);
  27.  
  28.     return true;
  29. }

编译运行QtCreator如下：

 六、定位菜单、菜单项位置

当前添加的菜单或者菜单项都是在第一个位置。如何修改新增菜单或菜单项的位置,将“DoNothing”菜单放到“Help”前。示例代码如下：

  1. #include <QMenuBar>
  2.  
  3.  
  4. bool DoNothingPlugin::initialize(const QStringList& args, QString *errMsg)
  5. {
  6.     Q_UNUSED(args);
  7.     Q_UNUSED(errMsg);
  8.  
  9.     Core::ActionManager* am = Core::ICore::instance()->actionManager();
  10.  
  11.     // Create a DoNothing menu
  12.     Core::ActionContainer* ac =  am->createMenu("DoNothingPlugin.DoNothingMenu");
  13.     ac->menu()->setTitle(QString::fromUtf8("DoNothing"));
  14.     // Create a command for "About DoNothing".
  15.     Core::Command* cmd = am->registerAction(
  16.                 new QAction(this),
  17.                 "DoNothingPlugin.AboutDoNothing",
  18.                 Core::Context(Core::Constants::C_GLOBAL));
  19.     cmd->action()->setText(QString::fromUtf8("About DoNothing"));
  20.     connect(cmd->action(), SIGNAL(triggered(bool)), this, SLOT(doNothing()));
  21.     // Insert the "DoNothing" menu between "Window" and "Help".
  22.     QMenu* helpMenu =  am->actionContainer(Core::Constants::M_HELP)->menu();
  23.     QMenuBar* menuBar =  am->actionContainer(Core::Constants::MENU_BAR)->menuBar();
  24.     menuBar->insertMenu(helpMenu->menuAction(), ac->menu());
  25.     // Add the "About DoNothing" action to the DoNothing menu
  26.     ac->addAction(cmd);
  27.  
  28.     return true;
  29. }

编译运行QtCreator如下：

 可以使用相同的方法定位菜单项的位置。

声明：本文内容由网友自发贡献，不代表【wpsshop博客】立场，版权归原作者所有，本站不承担相应法律责任。如您发现有侵权的内容，请联系我们。转载请注明出处：https://www.wpsshop.cn/w/花生_TL007/article/detail/154092
推荐阅读
相关标签

Copyright © 2003-2013 www.wpsshop.cn 版权所有，并保留所有权利。

  

闽ICP备14008679号