要实现Add-in Object 有三种方法,一种是利用ATL COM Wizard中的ATL对象 Add-in Object来实现,另一种是利用DevStudio Add-in Wizard来实现,第三种就是手工写所有的代码,如果手工写,一定要记住实现IDSAddIn接口,这样才能才能增加新的命令和工具条到VC的IDE环境中去。
我主要是讲解ATL COM Wizard,所以我用第一种方法来实现。在这里我实现了IApplicationEvents 和 IDSAddIn接口,实现IapplicationEvents接口是应为我要对Application 对象进行操作,比如NewDocument()、WorkspaceOpen()等等方法。而实现IDSAddIn接口,是应为要增加新的命令和工具条到VC的IDE环境中去。
示例程序实现的功能:
1) 在VC的IDE环境中增加一个工具条(4个按钮),并且能操纵VC的IDE环境,(工具条如下图) 第一个按钮弹出对话框允许修改用户信息,第二个按钮最小化所有打开的窗口,第三个最大化所有的窗口,第四个按钮弹出一个Messagbox。
2) 对每一个新建的文档,根据文档类型在文件头自动加上版权信息和相关内容注释。
源代码 http://263.csdn.net/FileBBS/files/2001_8/T_436_1.zip
观看效果:下载源代码,编译后生成Sample_02.dll,然后在VC的环境中,选择菜单tools/customize ,然后选择最后一个Add-ins and Macro Files 标签,选择Browse按钮,选择刚才编译后的Sample_02.dll文件,然后在Add-ins and Macro列表框中选中Copyright Class ,然后Close Customize对话框,这是VC的IDE环境就会出现一个有四个按钮的工具条(见上图)。大家可以分别点击这几个按钮看看效果,也可分别在VC环境中(新建)New 几种类型的文件(.cpp ,.h .htm 和.txt文件)看看文件头是否加上版权信息.
下面一步步引导大家来实现此例子程序:
1) 用ATL COM Wizard建立一个叫Sample_02的DLL项目文件
2) 在Class Wizard 中鼠标右键,在弹出菜单种选择New ATL Object…
3) 在ATL COM Wizard对话框中的Categroy选择Object 在Object中选择Add-in Object,选择Next按钮(如图)。
4) 选择属性对话框的Names标签,在C++组的Short Name编辑框输入Copyright(如图)
5) 选择DevStudio Add-in标签,在Add-in Features中选择Application Events,选择OK按钮确定
上面的步骤生成基本Add-in框架代码
6) 创建IDE工具条
a) 创建两个Bitmap 文件作为工具条图像资源
IDB_TOOLBAR_LARGE_COPYRIGHT 32 x 32大小
IDB_TOOLBAR_MEDIUM_COPYRIGHT 16 x 16 大小
b) 在Ccopyright 类的OnConnection()函数中加入创建工具条按钮的代码, 详细代码请参看源代码
此段代码主要用了Application Object的两个方法AddCommand()和AddCommandBarButton(),AddCommand()方法调用后,在菜单的Tools/Customize 中的Commands标签中的Categroy列表框中就会有对应的Command命令(),
如果我增加一条这样的命令AddCommand(CComBSTR(_T("ShowInfoDlg/n显示/n修改用户版权信息/n显示")),CComBSTR(_T("ShowInfoDlg")), 0, dwAddInID, &bRet);在Categroy的All Commands中就能找到ShowInfoDlg这条命令。AddCommandBarButton()方法就是向IDE集成环境增加一个工具条按钮,程序中可以不调用此方法,可以手动拖拉到工具条上。打开菜单Tools/Customize 用鼠标拽拉你需要的的命令到工具条上即可(如图)
在Ccopyright 类NewDocument()方法中的代码,主要就是增加必要的版权信息到文档中,此处主要是说明怎样操作VC环境中文档,大家也得到具体的Windows来修改窗口的形状和属性,怎么修改就要看各自的想象力了。
增加命令对应的方法:
1) 如果要增加一条命令,必须在Icopyright中增加相应的方法。如在示例程序中我增加了MiniWindow这个命令,那么我在Icopyright中也必须增加MiniWindow这样一个方法 (在ClassWizard中鼠标右键Icopyright,在弹出菜单中选择Add Method 即可增加方法)
示例程序程序中共增加了四个命令:ShowInfoDlg,MiniWindow,MaxWindow和Test,应此必须在Icopyright接口中实现此四个方法
7)实现工具条后,就是实现具体的方法了,具体的实现请参看Ccopyright中的四个方法
STDMETHODIMP CCopyright::ShowInfoDlg()
STDMETHODIMP CCopyright::MaxWindow()
STDMETHODIMP CCopyright::MiniWindow()
STDMETHODIMP CCopyright::Test()
值的说明的是在ShowInfoDlg()方法中弹出了一个对话框。在ATL中类似于这种对话框很容易实现。在Class Wizard 中鼠标右键,在弹出菜单种选择New ATL Object…在ATL Object wizard中的Category中选择Miscellaneous ,在Object中选择Dialog,Next按钮后,在ATL Object wizard属性对话框中Short name 编辑框中输入UserInfoDlg即完成对话框的实现。另外,对话框中输入的用户信息是记载在注册表中的.ShowInfoDlg()方法弹出的界面如下图:
至此,示例代码基本完成,由于很多人对ATL开发都比较熟悉,应此原理和一些细节就不一一说明了。由于匆忙中完成的,错误之处,还请大家见谅。
附加:怎样调试示例程序,编译运行,在弹出的对话框中选择VC的安装路径下的Common/MSDev98/Bin/MSDEV.EXE作为调试程序,然后在调试启动的VC环境中选择菜单下tools/customize中...具体操作参看前面的观看效果一段说明。
下一次,准备给大家介绍用ATL COM Wizard 中的Simple Object 做一个简单的分布式C/S应用,以及怎样从服务端动态的返回数据。