VC++6.0 编写插件（图文并茂）

下午偶然注意到VC++6.0新建工程标签页下的DevStudio Add-in Wizard，没有接触过，看名字是给Developer

Studio开发插件，心生喜感，于是百度之，发生百度检索几乎找不到一篇完整的文字讲述这个wizard的使用，

所以在CSDN搜了搜，费尽周折下载了一个只有几行实际代码的demo，同时在MSDN提供的实例中看到了类似的

demo，研究了几个小时，基本理清了这种插件的编写过程，总结出来，以供大家交流。IDE插件的用处不言而喻

，大名鼎鼎的Bound Check和Visual Assist X都属于这类插件。但我刚刚接触，水平很有限，更多地是希望得

到有共同爱好的朋友的指教。

鉴于各种"手把手教你XXX"文体横行，我也来手把手一次吧。

我这里的环境是Visual C++ 6.0，相信其他Visual Studio版本的方法是大同小异的。

1. 创建工程。启动VC++，新建一个DevStudio Add-in Wizard工程，如图，比如我这里命名为Addin，确

定。

工程设置，这里填写你给插件的描述，这将在Visual Studio装载插件时在列表中显示。比如我写Addin by

Lusta。

上图中2个复选框最好都选上，第一个使工程有默认的按钮工具条，第二个使该工程默认重写了响应Developer

Studio事件的函数。确认。

2. 相关准备。进入工程，查看Class View，会发现它自动生成了这么几个类。

其中，CXXXApp的作用相当于其他一般工程类型中的App类，比如MFC中的CWinApp类，是整个可执行程序或者链

接库的启动类。
    CCommands类负责完成从界面触发的操作，具体的细节我也讲不清楚，因为这里用到了COM组件，似乎。我不是

很了解，基本只是摸清了大概的框架。
    CDSAddIn类，完成某些初始化工作。具体描述在MSDN中可以找到，MSDN中有关于插件开发的几篇文章。我没有

细看，主要得研究代码才懂。
    ICommands，声明为interface ICommands : IDispatch{}; 我也看不懂了，interface ICommands不知道是属于

什么类或者什么组件，COM技术？但是我看懂了这其中的函数实际就是响应VC界面上插件工具条按钮点击的代码

实体。
    Globals变量中有不少内容，但都属于Wizard生成，可以不管。

对了，我们还没有想好编写的这个插件得有些什么功能。这些决定了我们要在ICommands中写进一些什么函数。

比如，我经常用windows记事本来临时做一些大段代码的批量处理，替换，查找，要比VC自身提供的功能方便很

多，所以我们在这里给插件添加一个启动windows记事本的功能。
    windows还有一些小工具也很实用，比如我的专业是遥感，所以经常是做图像处理，偶尔会用windows画图工具

来截取图片或者转换图像格式，所以也可以把启动MSPaint添加插件工具条按钮中。这些没必要细说，我这里还

添加了启动计算器的功能，因为Visual Studio调试并不提供手动计算的功能，比如你计算某幅位图的存储宽度

。另外，增加一个通过百度搜索某一关键字的功能，以及关于本插件的信息。

3.编写代码。使用向导，右击类视图中的ICommands，点击Add Method，似乎这里都是叫方法，不叫函数。注意

：ICommands中已经默认生成了一个叫做AddinCommandMethod的方法，你可以删除它，也可以重写它做自己的事

。Add Method对话框如下：

填写名称，参数列表，下面的声明可以不修改，其中的id[X]代表该方法的ID，这个ID标识了该方法与插件工具

条按钮的顺序，比如id[6]的方法，响应第6个按钮的点击。
我在这里添加了4个方法，分别是：

注意第一个是自动生成的。然后我们可以在类视图中看到ICommands下出现了一共5个方法。

接下来要做的是，在工具条中插入这么多个按钮，并设置好按钮的图形（BMP位图）。在类视图中点开CDSAddin

类的OnConnection()，这是一个插件连接时的初始化过程。

在这里我们可以看到之前默认生成的AddinCommandMethod方法，它是如何与第一个按钮关联起来的。代码如下

：

我尝试了半天，参考demo，才知道了按钮与方法的关联都是这样一个一个完成的。唯一不同的是，要做这样几

个对应的修改（依次对应图中红框）。
A: 修改为对应方法的名字（我也不知道这里的区别在哪）
B: 修改为事先创建好的字符串资源ID，下面会详细介绍。
C: 修改为对应的方法名。
D: 这个数字的参数名是nBitmapOffset，意思是按钮位图上的偏移值（如果你熟悉MFC工具条的位图就能明白，

加载工具条是自动把位图的某一段分割为一个按钮）。

Windows提供的demo中，是用{ }把两段这样的代码分别圈起来的，形成了不同的作用域，这样就免去了声明不

同命局部变量的麻烦。这样我们就只需把这个{}包括其中的内容拷贝，粘贴4次，然后修改里面的相应参数即可

。

这里需要注意两点。一是nBitmapOffset这个参数，要根据你所绘制的工具条位图的顺序来对应方法的顺序。比

如第一个按钮的nBitmapOffset = 0，第二个按钮的nBitmapOffset = 1，琢磨琢磨你就懂了。这里我也是调试

了老半天才发现的。MSDN上没有任何说明，网上更找不到了。

我的理解是：方法与按钮的关联唯一地由这个参数决定。不管我有没有理解错，你可别弄混了就是。

接下来详细说说上面代码中的IDS_CMD_STRING1字符串资源的格式。如下图：

Caption由/n分为3个部分，第一部分是什么我没有发现，第二部分是光标移到插件按钮上时状态栏提示，第三

部分是光标提示。这里似乎如果格式错误的话就会导致按钮加载失败。得好好注意。

最后就是完成方法的具体实现。这里已经没有什么需要说的了，都是一般函数的编写一样。比如这里我这么测

试一下：

弹一个框，显示notepad。其他类似。如果需要完成功能的话当然easy了，用ShellExecute()或者别的都行。至

于搜索文本，MSDN的SAMPLE中有一个API查询的例子，里面用到了获取选定文本的方法，这里不细述，获取选定

文本后我们只需构建出这么一个东西http://www.baidu.com/s?wd=XXXXX就行了。然后ShellExecute。

至于位图按钮，就得自己画或者编辑了，分为2个，一个是32×32，5个按钮就是160×32，另一个是中等尺寸，

16×16，5个按钮就是80×16。我这里是用Photoshop画的，比较麻烦。

最后我们看看最终效果。

我们把编译好的Addin.dll拷贝到VC++安装目录下面的addin目录中，比如我的Visual C++6.0安装在D:/盘，所

以我可以打开D:/Program Files/Microsoft Visual Studio/Common/MSDev98/AddIns，粘贴到这里，而后在

VC++中点击tools->customize，在customize对话框中点选Add-ins and Macro files标签页，如果没错的话应

该看到列表中有Addin by Lusta。勾选，close。如果有什么问题的话，VC++会提示无法装载，问题在哪就得自

己找了。

图中Toolbar8就是我刚刚加载的插件，旁边是Visual Assist X的工具条。可以看到光标提示"Notepad"。我

们点击它，可以看到弹框。

说明插件已经成功注入了VC++主程序。我们的编写到此结束。

关于插件的卸载，需要强调的是，应该先重复tools->customize操作，将勾去掉，close。最后删除拷贝的dll

文件。如果直接删除的话注册表里面有残余。

好了，到这里为止。我只是凭借记忆总结了一下一般的编写过程。有什么不妥的不对的地方欢迎指正。文字描

述有点麻烦，可能存在讲不清楚的地方，如果有需要这个代码的，可以联系我。

联系方式
QQ: 137571735 现在叫日天昊...
EMAIL: lusta@live.cn

http://blog.sina.com.cn/s/blog_a401a1ea01014tdb.html