WPS二次开发 插件教材

1、二次开发 插件教材使用vb开发wps office插件使用vb开发wps office插件教程内容简介：wps office的插件由一个实现了特定接口的dll、一个xml配置文件以及插件本身需要的其他文件组成。wps office 插件dll实际上是一个实现了_idtextensibility2接口的com组件。 1. _idtextensibility2 插件dll要导出com要 office的插件由一个实现了特定接口的dll、一个xml配置文件以及插件本身需要的其他文件组成。wps office 插件dll实际上是一个实现了_idtextensibility2接口的com组件。_idtex

2、tensibility2介绍插件dll要导出com要求的dllcanunloadnow、dllgetclassobject、dllregisterserver和dllunregisterserver四个函数，并实现_idtextensibility2接口。_idtextensibility2接口的定义在kingsoft add-in designer类型库中，如果是c+在c:/program files/kingsoft/wps office personal/office6/ksaddndr.dll导入ksaddndr.dll就可以使用这个接口。在这里建议用官网的插件向导生成工程这样容易生成

3、dll文件:插件安装时，wps office会将插件dll注册（dllregisterserver）到系统中。wps office启动时，将通过插件平台（管理插件的模块）加载插件。插件平台通过com方式创建一个_idtextensibility2对象，然后调用_idtextensibility2.onconnection。插件可以在onconnection中做一些初始化操作，如添加菜单项、工具栏按钮等。onconnection之后，onstartupcomplete将被调用，至此插件加载完成。wps关闭时，插件平台先后调用onbeginshutdown和ondisconnection。目前，w

4、ps office插件平台不会调用插件的_idtextensibility2.onaddinsupdate方法。插件实现一个空的onaddinsupdate就可以了，即直接返回s_ok，应避免在其中编写其他代码，以免将来引起兼容问题。1.1private sub idtextensibility2_onconnection(byval application as object, byval connectmode as addindesignerobjects.ext_connectmode, byval addininst as object, custom() as variant) s

5、et app = applicationend subonconnection方法一共带有4个参数。第一个参数application是宿主程序对象；第二个参数是connectmode类型的枚举值；第三个和第四个参数目前没有使用，插件实现onconnection时必须忽略这两个参数private enum connectmode ext_cm_afterstartup = 0 ext_cm_startup = 1 ext_cm_external = 2 ext_cm_commandline = 3end enum其中，ext_cm_startup和ext_cm_afterstartup是插件平台

6、加载com插件时传入onconnection的。ext_cm_external和ext_cm_commandline目前没有用到。a. ext_cm_startupwps启动时，插件平台会立即加载com插件，调用onconnection(application, ext_cm_startup)。b.ext_cm_afterstartup用于安装插件过程。安装插件时，wps office插件平台会加载插件，并调用onconnection(application, ext_cm_afterstartup)，此时插件要做两件事情，即安装后的初始化以及加载初始化。如果插件安装以后不需要进一步的配置等初

7、始化工作，那么对这个插件而言，不需要区分ext_cm_afterstartup和ext_cm_startup。一般情况下，插件会在onconnection中添加菜单项或者工具栏按钮等功能入口。在wps office添加的菜单项或者工具栏按钮，分为“临时”和“持久”两种类型。顾名思义，带有“临时”属性的菜单项或工具栏按钮，在wps office重新启动以后就不存在了；带有“持久”属性的菜单项或工具栏按钮，在wps office重新启动以后，仍然存在。插件添加菜单项和工具栏按钮时，推荐使用“临时”的菜单项和工具栏按钮，在宿主程序关闭时，插件也不要调用api删除菜单或工具栏按钮。插件添加菜单项或工具

8、栏按钮时，建议先检查这些菜单或按钮是否已经存在，以免重复添加。例如: dim combar as commandbar dim cbtn as commandbarbutton dim combarname as string set app = application for each combar in app.commandbars combarname = combar.name if combarname = sky then combar.delete end if next set combar = app.commandbars.add(sky) set cbtn = comb

9、ar.controls.add(kso.ksocontrolbutton) with cbtn .caption = 插入图片 .faceid = 1 .style = ksobuttoniconandcaptionbelow .tooltiptext = look up sky end with1.2._idtextensibility2.onstartupcomplete插件平台加载插件过程中，会先后调用onconnection和onstartupcomplete。如果插件需要在插件启动以后（onconnection执行完之后）做一些事情，可以将这些工作放到onstartupcomplet

10、e中执行。大多数情况下，插件可以实现一个空的onstartupcomplete，返回s_ok即可。1.3._idtextensibility2.onbeginshutdownwps office关闭过程中，插件平台会调用onbeginshutdown，通知插件做清理工作，如保存配置、终止未完成的工作、释放系统资源等。onbeginshutdown在ondisconnection之前被调用。1.4._idtextensibility2.ondisconnectionondisconnection和onconnection相对应，插件在onconnection中添加菜单或工具栏命令、注册事件通知，

11、ondisconnection则注销事件通知。private sub idtextensibility2_ondisconnection(byval removemode as addindesignerobjects.ext_disconnectmode, custom() as variant) set app = nothingend subondisconnection带removemode和custom两个参数。其中custom参数目前没有用到，插件忽略这个参数即可；第一个参数removemode是ext_disconnectmode类型的枚举值，如下所示：private enum

12、ext_disconnectmode ext_cm_afterstartup = 0 ext_cm_startup = 1 ext_cm_external = 2 ext_cm_commandline = 3end enum目前只用到了ext_dm_hostshutdown。wps office关闭时，插件平台会调用插件的_idtextensibility2.ondisconnection(ext_dm_hostshutdown, custum) 方法。前面推荐插件使用“临时”的菜单和工具栏按钮。使用“临时”菜单和按钮时，插件在处理ext_dm_hostshutdown过程中不需要删除菜单、按

13、钮等项目。2.插件配置文件wps office插件的配置文件是一个符合一定命名规则的xml文件。插件配置文件必须和插件dll放在相同的文件夹中。插件配置文件的文件名必须遵循“addon-name.app-name.lang.xml”这样的格式。a. addon-name插件模块的名称，必须和插件模块的文件名完全一致。如wpsaddondemo.dll插件，addon-name为“wpsaddondemo”。b. app-name插件支持的wps模块，包括：wps、et、wpp、kso，其中kso表示支持wps office的所有模块。c. lang插件支持的语言版本，如1033、2052等。“

14、0”表示支持所有语言。假如wpsaddondemo.dll插件支持wps office的所有模块，支持简体中文，那么它的配置文件名称为“wpsaddondemo.kso.2052.xml”。如果插件需要针对wps office的不同模块编写不同的配置文件，那么可以按照以上规则编写多个配置文件。插件平台优先使用精确匹配的插件配置文件，以wpsaddondemo插件为例，wps文字启动时，插件平台先查找名为“wpsaddondemo.wps.2052.xml”的配置文件，若找不到则继续查找名为“wpsaddondemo.kso.2052.xml”的配置文件，如果都找不到，则说明该插件不支持wps文

15、字。id=70d748c8-974d-44c0-8115-9072478a6009 version=234 type=comaddin name=插件示例 author=wpsdesc=wps office 插件简介 image=icon.jpg homepage=help=loadimm=1updateitv=7/ksoplugin插件配置文件中至少要包含id、version、type、name四项数据。a.id插件id是插件com组件的clsid，wps office插件平台将根据id加载插件，获取_idtextensibility2接口。这里介绍个工具给你，选择库是工程生成.dll文件下面会说到。b.verion插件版本号使用windows风格的命名方式，即主版本号子版本号修正版本号构建，如“9”。插件版本号会显示在插件平台对话框中。c.typetype必须为comaddin，说明插件dll是一个com组件。在插件平台对话框中看到的插件名称。e.loadimmwps启动时是否立即加载插件，必须为“1”，表示立即加载插件。好我们打开c:教材点击regaddin.reg注册下,然后启动wps他会弹出一句话:这句话就