本文介绍了一种使用VC++ ATL(Active TemplateLibrary),利用ISPExtensibility接口,为 iStylePDF 加入功能简单的COM插件(addin),加入工具栏按钮等可视部件,并为其加入响应事件的方法。我们采用VS2010为iStylePDF平台开发插件,当然也可以使用其他VS工具。开发插件的第一步需要安装iStylePDF的客户端,客户端程序中包括了ActiveX控件,这个是我们需要用到的类型库。如果没有客户端,请进入这里下载。下面开始逐步介绍开发步骤。
1、在visual C++编程环境下,利用向导生成一个名为PDFAddin的ATL COM Appwizard工程(图一):
在向导的设置中采用默认设置,选择Next。然后单击Finish,这样一个空的ATL project就产生了(如图二)。
2、插入一个ATL的简单对象:
选择菜单Project—>Add Class...,出现类向导对话框(如图三),单击Add:
输入简单对象类名称,如PDFReader。注意一点的地方是VS2010 ProgID自己填写,这个名字很重要,最后编译生成的文件名称必须用这个命名。示例所示为iStylePDF.PDFReader。最后编译的控件名称为iStylePDF.PDFReader.spi(如图四),单击Next。
文件类型选项采用默认值。选项页的设置根据自己的需要是否设置连接点和ISupportErrorInfo支持,其他采用默认值即可。(如图五),单击完成。一个基本的COM组件就创建了,编译该工程看是否正常。现在该控件还没有和iStylePDF关联起来。接下来是重点设置。
3、在CPDFReader类中实现ISPExtensibility的接口:
ISPExtensibility是iStylePDF类型库中的一个虚接口类。插件程序的CPDFReader只要继承并实现该类的几个接口就能和宿主程序关联。添加继承虚接口类步骤如下,首先选择类视图,找到ATL的简单对象类,右键单击弹出菜单,选择Add->Implement Interface。如图六
可用的类型库名称中选择iStylePDF ObjectLibrary<1.0>,如果类型库中没有,说明控件没有注册,也可以从文件选择iStylePDF.ocx。接口中选择ISPExtensibility,移动到右边的实现接口类中,单击完成。如图七。
现在就自动添加了ISPExtensibility接口类的接口函数,OnConnection,OnDisconnection主要使用这两个函数。修改输出文件名称,编译成功之后。即可放到iStylePDF安装目录的plugins目下,平台启动就会加载该插件。目前插件什么功能都没有实现,所以什么看不到,下面介绍添加一个工具条。
4、添加工具栏按钮:
添加工具栏按钮可以再程序连接的函数中实现。OnConnection参数是一个Application顶级对象,通过该对象可以获取所有的其他对象。请参考对象模型。我们定义一个变量把Application指针保存起来。
OnConnection的实现如下代码:
CommandBar的函数说明请参考对象模型。编译运行工具栏就加进去了。如图九
5、按钮事件的添加:
按钮添加了,需要接收按钮的事件,下面就是要介绍实现Event的响应。ATL为COM对象的Idispatch接口提供了两个模板类:IDispEventImpl<>和IDispEventSimpleImpl<>,选择IDispEventSimpleImpl<>,因为它不需要额外的类型库信息,从IDispEventSimpleImpl<>继承一个类:
然后再添加事件映射宏即可接收事件。BEGIN_SINK_MAP(CPDFReader) END_SINK_MAP()
接下来我们要做的是为按钮加单击事件。首先要用_ATL_SINK_INFO结构描述回调的参数信息,必须声明为外部变量,我们为事件预定义了一些参数说明,如下:
声明按钮点击事件的回调函数:
然后在事件映射处添加事件映射:
编译运行。点击按钮,没有弹出对话框。嗯,这样就对了,我们还有一个步骤没做。增加事件类的DispEventAdvise。在连接函数中增加如下代码:
别忘了,在断开连接的地方释放事件响应:
好了,一个插件就完成了,亲们, 赶紧去试试吧,不懂的地方,请猛点这里官网。
使用VC++ ATL实现iStylePDF的COM插件