QtCreator插件開發（二）——QtCreator菜單和菜單項

原創 天山老妖S 2018-09-10 02:07

QtCreator插件開發（二）——QtCreator菜單和菜單項

一、QtCreator菜單欄簡介

1、QtCreator菜單簡介

QtCreator菜單欄如下：
QtCreator插件開發（二）——QtCreator菜單和菜單項
QtCreator默認菜單包括“文件”、“編輯”、“工具”、“窗體”、“幫助”。“構建”、“調試”、“分析”由插件提供，不是QtCreator的默認菜單。在“幫助”菜單中的“關於插件”對話框中將所有可以取消的插件取消後重啓QtCreator，得到QtCreator默認菜單如下：
QtCreator插件開發（二）——QtCreator菜單和菜單項

2、Core::ActionManager簡介

QtCreator主程序僅僅是一個插件加載器。QtCreator所提供的所有功能都是通過插件實現的。QtCreator最主要的一個插件叫做Core插件。如果沒有Core插件，QtCreator將沒有插件加載功能。
Core插件的關鍵組件是ActionManager。ActionManager的作用是註冊菜單、菜單項以及鍵盤快捷鍵。如果想要添加新的菜單或菜單項，就需要使用ActionManager。
爲了訪問ActionManager，可以使用下面的代碼：

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

3、Core::ActionContainer簡介

ActionContianer表示QtCreator中的菜單或者菜單欄。通常不會直接創建ActionContainer的實例，而通過ActionManager::createMenu()、ActionManager::createMenuBar()函數進行訪問。
QtCreator每一個默認菜單都關聯一個ActionContainer對象。給定一個菜單，獲取其關聯的ActionContainer對象，可以使用下面的代碼：

#include <coreplugin/coreconstants.h>
#include <coreplugin/actionmanager/actionmanager.h>
#include <coreplugin/actionmanager/actioncontainer.h>
#include <coreplugin/icore.h>

Core::ActionManager* am = Core::ICore::instance()->actionManager();
Core::ActionContainer* ac = am->actionContainer(ID);

QtCreator每個菜單的ID如下：
QtCreator插件開發（二）——QtCreator菜單和菜單項
每個ID都是Core命名空間中的靜態const char *常量，$$QT_CREATOR_ROOT/src/plugins/coreplugin/coreconstants.h文件中定義了這些常量。
如果想要訪問“Help”菜單，可以使用如下的代碼：

#include <coreplugin/coreconstants.h>
#include <coreplugin/actionmanager/actionmanager.h>
#include <coreplugin/actionmanager/actioncontainer.h>
#include <coreplugin/icore.h>

Core::ActionManager* am = Core::ICore::instance()->actionManager();
Core::ActionContainer* ac =     am->actionContainer( Core::Constants::M_HELP );

二、添加菜單項

如果將DoNothing插件添加到“Help”菜單，增加爲“About DoNothing”菜單項。
DoNothingPlugin.cpp文件修改如下：

#include <coreplugin/coreconstants.h>
#include <coreplugin/actionmanager/actionmanager.h>
#include <coreplugin/actionmanager/actioncontainer.h>
#include <coreplugin/icore.h>
#include <QMenu>

bool DoNothingPlugin::initialize(const QStringList& args, QString *errMsg)
{
    Q_UNUSED(args);
    Q_UNUSED(errMsg);

    Core::ActionManager* am = Core::ICore::instance()->actionManager();
    Core::ActionContainer* ac = am->actionContainer(Core::Constants::M_HELP);
    QAction* aboutDoNothing = ac->menu()->addAction(QString::fromUtf8("About DoNothing"));

    return true;
}

編譯後啓動QtCreator，菜單如下：
QtCreator插件開發（二）——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” 菜單項：

#include <coreplugin/coreconstants.h>
#include <coreplugin/actionmanager/actionmanager.h>
#include <coreplugin/actionmanager/command.h>
#include <coreplugin/icore.h>

#include <QKeySequence>
#include <QAction>

bool DoNothingPlugin::initialize(const QStringList& args, QString *errMsg)
{
    Q_UNUSED(args);
    Q_UNUSED(errMsg);

    // Fetch the action manager
    Core::ActionManager* am = Core::ICore::instance()->actionManager();

    // Create a command for "About DoNothing".
    Core::Command* cmd = am->registerAction(
                new QAction(this),
                "DoNothingPlugin.AboutDoNothing",
                Core::Context(Core::Constants::C_GLOBAL));
    cmd->action()->setText(QString::fromUtf8("About DoNothing"));

    // Add the command to Help menu
    am->actionContainer(Core::Constants::M_HELP)->addAction(cmd);

    return true;
}

編譯後運行，About DoNothing菜單項已經出現在Help菜單的開始位置。
QtCreator插件開發（二）——QtCreator菜單和菜單項
使用註冊方式添加菜單項，可以在Keyboard Shortcuts參數界面中列出About DoNothing菜單項，並可以關聯快捷鍵。
QtCreator插件開發（二）——QtCreator菜單和菜單項

四、響應菜單項

DoNothing插件已經作爲一個菜單項加入到QtCreator中。既然菜單項就是一個QAction，可以通過連接triggered(bool)或者toggled(bool)信號，並增加響應trigger、toggled事件的槽函數。
插件類的實現如下：
DoNothingPlugin.h文件：

#ifndef DONOTHINGPLUGIN_H
#define DONOTHINGPLUGIN_H

#include <extensionsystem/iplugin.h>

class DoNothingPlugin : public ExtensionSystem::IPlugin
{
    Q_OBJECT
public:
    DoNothingPlugin();
    ~DoNothingPlugin();

    void extensionsInitialized();
    bool initialize(const QStringList & arguments, QString * errorString);
    void shutdown();
protected slots:
    void doNothing();
};
#endif // DONOTHINGPLUGIN_H

DoNothingPlugin.cpp文件：

#include "DoNothingPlugin.h"
#include <QtPlugin>
#include <QStringList>
#include <coreplugin/coreconstants.h>
#include <coreplugin/actionmanager/actionmanager.h>
#include <coreplugin/actionmanager/actioncontainer.h>
#include <coreplugin/icore.h>
#include <QKeySequence>
#include <QAction>
#include <QMessageBox>

DoNothingPlugin::DoNothingPlugin()
{
    // Do nothing
}

DoNothingPlugin::~DoNothingPlugin()
{
    // Do notning
}

bool DoNothingPlugin::initialize(const QStringList& args, QString *errMsg)
{
    Q_UNUSED(args);
    Q_UNUSED(errMsg);

    // Fetch the action manager
    Core::ActionManager* am = Core::ICore::instance()->actionManager();

    // Create a command for "About DoNothing".
    Core::Command* cmd = am->registerAction(
                new QAction(this),
                "DoNothingPlugin.AboutDoNothing",
                Core::Context(Core::Constants::C_GLOBAL));
    cmd->action()->setText(QString::fromUtf8("About DoNothing"));
    // Add the command to Help menu
    am->actionContainer(Core::Constants::M_HELP)->addAction(cmd);

    connect(cmd->action(), SIGNAL(triggered(bool)), this, SLOT(doNothing()));
    return true;
}

void DoNothingPlugin::extensionsInitialized()
{
    // Do nothing
}

void DoNothingPlugin::shutdown()
{
    // Do nothing
}

void DoNothingPlugin::doNothing()
{
    QMessageBox::information(
            0,
            QString::fromUtf8("About DoNothing Plugin"),
            QString::fromUtf8("Seriously dude, this plugin does nothing")
        );
}

Q_EXPORT_PLUGIN(DoNothingPlugin)

編譯後運行QtCreator，點擊DoNothing菜單項：
QtCreator插件開發（二）——QtCreator菜單和菜單項
使用Qt Creator主窗口作爲彈出消息對話框的parent，代碼修改如下：

void DoNothingPlugin::doNothing()
{
    QMessageBox::information(
        Core::ICore::instance()->mainWindow(),
        "About DoNothing Plugin",
        "Seriously dude, this plugin does nothing");
}

五、添加菜單

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

#include <QMenu>

bool DoNothingPlugin::initialize(const QStringList& args, QString *errMsg)
{
    Q_UNUSED(args);
    Q_UNUSED(errMsg);

    // Fetch the action manager
    Core::ActionManager* am = Core::ICore::instance()->actionManager();

    // Create a DoNothing menu
    Core::ActionContainer* ac =     am->createMenu("DoNothingPlugin.DoNothingMenu");
    ac->menu()->setTitle(QString::fromUtf8("DoNothing"));
    // Create a command for "About DoNothing".
    Core::Command* cmd = am->registerAction(
                new QAction(this),
                "DoNothingPlugin.AboutDoNothing",
                Core::Context(Core::Constants::C_GLOBAL));
    cmd->action()->setText(QString::fromUtf8("About DoNothing"));
    connect(cmd->action(), SIGNAL(triggered(bool)), this, SLOT(doNothing()));
    // Add DoNothing menu to the menubar
    am->actionContainer(Core::Constants::MENU_BAR)->addMenu(ac);
    // Add the "About DoNothing" action to the DoNothing menu
    ac->addAction(cmd);

    return true;
}

編譯運行QtCreator如下：
QtCreator插件開發（二）——QtCreator菜單和菜單項

六、定位菜單、菜單項位置

當前添加的菜單或者菜單項都是在第一個位置。如何修改新增菜單或菜單項的位置,將“DoNothing”菜單放到“Help”前。示例代碼如下：

#include <QMenuBar>

bool DoNothingPlugin::initialize(const QStringList& args, QString *errMsg)
{
    Q_UNUSED(args);
    Q_UNUSED(errMsg);

    Core::ActionManager* am = Core::ICore::instance()->actionManager();

    // Create a DoNothing menu
    Core::ActionContainer* ac =         am->createMenu("DoNothingPlugin.DoNothingMenu");
    ac->menu()->setTitle(QString::fromUtf8("DoNothing"));
    // Create a command for "About DoNothing".
    Core::Command* cmd = am->registerAction(
                new QAction(this),
                "DoNothingPlugin.AboutDoNothing",
                Core::Context(Core::Constants::C_GLOBAL));
    cmd->action()->setText(QString::fromUtf8("About DoNothing"));
    connect(cmd->action(), SIGNAL(triggered(bool)), this, SLOT(doNothing()));
    // Insert the "DoNothing" menu between "Window" and "Help".
    QMenu* helpMenu =   am->actionContainer(Core::Constants::M_HELP)->menu();
    QMenuBar* menuBar =     am->actionContainer(Core::Constants::MENU_BAR)->menuBar();
    menuBar->insertMenu(helpMenu->menuAction(), ac->menu());
    // Add the "About DoNothing" action to the DoNothing menu
    ac->addAction(cmd);

    return true;
}

編譯運行QtCreator如下：
QtCreator插件開發（二）——QtCreator菜單和菜單項
可以使用相同的方法定位菜單項的位置。

發表評論
所有評論
還沒有人評論，想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章

nagios check_memory 插件開發

wjp13671142513 2019-02-23 13:37:36

Chrome插件開發進階

奇妙的hi 2019-02-23 00:14:44

多個eclipse插件導出同名且版本不同的包帶來的問題之分析過程

王新和 2019-02-22 20:17:39

jQuery 關於點擊菜單項，使子條目"向上"展開效果的實現

我不會抽菸 2019-02-22 22:51:08

爲SharePoint網站創建自定義導航菜單

kaneb0y 2019-02-22 22:45:55

3級菜單實現---low版

se18956844 2019-02-22 21:54:17

用smartsniff抓取http包

xmyklw 2019-02-22 21:50:52

MFC 菜單

jwj121234 2019-02-22 21:50:07

Ubuntu筆記

luyucia 2019-02-22 21:46:05

Javascript自定義菜單插件

Bush_Tea 2019-02-22 21:35:11

動態生成二級導航菜單

zhupengfei418 2019-02-22 21:15:19

Eclipse New菜單中沒有Android Project選項

啊磊 2019-02-22 21:08:47

活動菜單

du_51 2019-02-22 20:23:34

活動菜單

du_51 2019-02-22 20:23:33

巧破網頁禁用鼠標右鍵

行者無忌 2019-02-22 20:05:59