阅读本文大概需要 6 分钟

对于一个多插件的 IDE 软件来说，支持界面扩展是必不可少的，今天我们来看看在 Qt Creator 当中是如何实现界面扩展的

概述

界面扩展无非就是在其它插件中访问修改主界面当中的一些菜单、参数，或者添加、删除某些菜单，目前很多大型软件都是支持插件化开发的

前几篇我们一起看了Qt Creator的主界面其实很简单，主界面包括一个菜单栏，模式工具栏，内容区域以及状态栏，如下图所示：

我们看到的其它丰富功能均是通过插件化实现的，今天我们详细学习下看看 QTC 当中菜单栏是怎么实现扩展的

实现原理

“

在学习代码之前我们可以想一想，如果让我们自己来实现应该如何实现，比如扩展一个Menu菜单？

既然其他插件要扩展，那么肯定需要访问核心插件创建的 menu 对象，那么就必须要有访问权限，那么核心插件定义的 menu 对象应该有哪些权限呢？

仔细回忆下我们刚开始学习 C/C++ 的时候老师就给我们说过，定义一个变量/对象要注意哪些关键点？

• 变量/对象的名

• 变量/对象的值

• 变量/对象的作用域

• 变量/对象的生命周期

所以我们要实现一个菜单也是需要考虑这几个方面，最关键的是这个对象的生命周期，外部要能访问该对象可以有好几种方式：暴露指针给外使用、提供注册接口、定义单例……，其实把 menu定义成一个单例是最便捷最灵活的一种方式了，类似下面这种

PS: 定义接口或者暴露指针也可以，只不过每次访问还要先访问核心插件对象，处理起来比较繁琐罢了

源码实现

好了，下面我们看下源码是怎么实现的

菜单管理代码主要在这个位置 : /Src/plugins/.coreplugin/actionmanager

文件虽然看着很多，不用担心，我们主要关心的类有这么几个：

• ActionContainer

• ActionContainerPrivate

• MenuActionContainer

• MenuBarActionContainer

• ActionManager

这几个类之间继承关系如下所示：

黄色表示的类对内使用，外部看不到具体的实现，每个菜单都可以是一个 MenuActionContainer 对象，MenuBarActionContainer全局只有一份，相当于是一个容器来容纳所有的菜单

那么我们如何创建一个菜单呢？其中有专门管理创建、注册的类来实现，这是一个单例类

在这个单例类当中，主要有两个重要的数据结构用来存储创建的菜单对象，详细实现都在它的 D指针里面

使用哈希Map 来存储每个对象，当创建的菜单对象比较多时查找效率非常高，同时注意键值key 是一个自定义的字符串ID，由特殊规则构成的全局唯一的值

其中有一个比较重要的数据结构 Context

这个类其实就是一个字符串 ID 的数组封装，各个菜单的标识、状态控制都用到了它，这个结构贯穿整个 Qt Creator插件系统，使用起来还是非常方便的

有了上面的结构，那么如何创建菜单以及子菜单呢，下面我们详细看下

创建 MenuBar

这里没啥好说的，和我们平时在QMainWindow当中创建方法一样，只不过这里创建细节统一封装管理起来了

创建菜单

下面我们以「文件」菜单为例看下创建过程

这两行代码就完成了「文件」菜单的创建，代码很简洁也非常容易理解，这里我们需要注意下几个常量定义技巧

所有的菜单都是通过字符串常量来区分的，这个常量相当于现实世界中我们每个人的身份证都是唯一的，而且都是有规律的

PS：看到这里再问大家一个问题，定义常量时，宏定义写法和上面的写法哪个好？为什么？欢迎讨论

到了这里，仅仅是创建了菜单，点击菜单后内容还是空的，我们接着继续看

每个action创建后通过 addAction 添加到对应的菜单上即可，如果某个 action 还有子菜单，那么就需要先创建一个菜单，然后直接添加菜单即可，比如「最近访问的文件」

任意一个action可以拥有多个子菜单，只需要在创建的时候根据递归关系选择创建action还是ActionContainer

测试

为了验证上述流程分析是否正确，我们可以编译一个测试插件，然后在该插件里面新创建一个菜单，分为下面几个流程：

• 创建测试插件PluginDemo子工程；

• 在插件初始化函数当中创建菜单；

• 编译该插件，然后把该插件(动态库)拷贝到 QTC 对应插件目录下

• 运行软件

创建插件编译后生成的目录结构如下所示：

可以看到我们测试插件路径和程序 exe是独立的

运行软件显示效果如下所示

可以看到整个代码不超过 10行就把创建的菜单添加到了主界面当中，使用起来目前看来还是很方便的，而且方便扩展，由于使用插件化和其它模块进行了解耦

相信大家也都看到了，QTC 插件系统当中比较重要的ID编号问题，这些编号都有固定的格式，而且每个ID无论从命名还是具体内容表达的意思都是显而易见的

• M开头表示菜单名字，比如文件、编辑、视图、构建……

• G开头表示分组信息，比如文件菜单当中包含了：新建文件、打开文件、打开工程、保存文件……

总结

Qt Creator界面插件化内容还很多，本次只是简简单单地学习了菜单管理逻辑以及如何使用，如果想了解更多细节阅读对应源码即可

一款优秀的开源软件有很多内容值得我们反复去学习、理解、使用的，未来很长，我们继续……

PS：文中涉及到相关流程图以及对应源码，如果感兴趣可以后台私信发给你

如果觉得对你有帮助，欢迎留言互相交流学习

推荐阅读

Qt Creator 源码学习笔记01，初识QTC

Qt Creator 源码学习笔记02，认识框架结构结构

Qt Creator 源码学习笔记03，大型项目如何管理工程

Qt Creator 源码学习笔记04，多插件实现原理分析