• 使用VC++ ATL实现iStylePDF的COM插件


    本文介绍了一种使用VC++ ATL(Active Template Library),利用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 Object Library<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。 在连接函数中增加如下代码:

     

    别忘了,在断开连接的地方释放事件响应:

     

     好了,一个插件就完成了。

  • 相关阅读:
    练习JSON
    实现JSON+JDBC的简单操作(以显示对象为例)
    三层架构:表示层-业务逻辑层-数据访问层
    实现json的三个操作(训练JSON)
    实现邮箱验证 简化版
    复习注册表单html和jQuery
    监听器(测试在线人数的)第一种 HttpSessionBindingListener
    Django的中间件
    Django form表单
    Django
  • 原文地址:https://www.cnblogs.com/istylepdf/p/4344658.html
Copyright © 2020-2023  润新知