永中Office二次开发技术手册范本.doc

. . Word完美格式 永中Office二次开发技术手册 前言 一、宏和二次开发 在实现办公自动化的今天，我们经常会碰到这样一个问题，在使用办公软件时总要重复流程一样的相同操作，这使工作变得繁琐而枯燥，能不能提供一种方法，使这些相同操作能够通过一个命令自动完成或者使用更为简单的途径得到呢？宏因此而产生了。 宏是指用一个符号名称所代表的一段程序代码，将定义代码段按实际参数进行加工，形成实际代码直接插入程序的执行序列中。许多应用程序具有建立宏的功能，它们可以把操作人员为解决某项问题而执行的一些操作命令记下来，形成一个文件段，并且用一个符号表示。当同样的问题重复执行时，只要输入代表这一系列命令的宏命令即可。这些代码可以是由用户编写，也可以通过办公软件提供的宏录制功能记录下简单任务而生成。 结合自己的需要，利用宏充分开发应用程序潜在的功能，可以获得使用上最大限度的满足，这也就是通常意义上的二次开发，即利用宏语言扩展宿主程序的功能、集成不同类型的数据以实现办公软件在具体事件中的解决方案。 永中Office为您提供了非常丰富而全面的宏API（API表示应用程序接口），通过这些API您可以非常自如操作永中Office。并且使您在实现自定义的解决方案时更加得心应手，更灵活的发挥永中Office 的集成优势。 二、本手册结构 第一部分为二次开发环境。 永中Office的二次开发，我们推荐，一是利用永中Office自带的宏编辑器进行开发，二是可以在Eclipse上开发。 第二部分为应用和API 我们在第2章给出了二次开发结构，也即永中Office二次开发的类层次图。有了该类层次图，就可以了解永中Office二次开发中的层次和对象了。 第3章为总控,这里有二次开发应用的总入口 第4章为电子表格应用 第5章为文字处理应用,自由表格也在这一章 第6章为幻灯片演示 第7章为公共组件，包含2个主要组件：自选图形和图表 第三部分为其它语言调用与应用 第8章为永中Office COM组件开发 第9章为嵌入浏览器样例 第10章为嵌入Java应用程序样例 附录 附录一为永中Office 二次开发技巧集,我们列举了一些二次开发技巧 附录一为永中Office 二次开发FAQ 我们希望起到抛砖引玉的作用。详细的API说明可以参见永中Office的API文档。 第一章 二次开发环境 1.1宏编辑器中进行二次开发 1、从菜单“工具”—》“宏”—》“宏编辑器”，打开宏编辑器。 2、在宏编辑器中，从菜单“插入”—》“模块”，新建一个模块。 3、在模块中，可以添加宏，通过宏，就可以操作永中Office。 4、示例：将下面的宏代码添加到模块中，宏的名字是“insertValue”。 样例1.1.1 //在当前的工作表中，往单元格（2，3）中设值“apple” 。 void insertValue() { Application.gotoProduct(GlobalConstants.SPREADSHEET); Workbook workbook = Application.getWorkbooks().getActiveWorkbook(); Worksheet sheet = workbook.getWorksheets().getActiveWorksheet(); sheet.setCellValue(2, 3, apple); } 注意：永中Office的宏语言是JAVA。 在模块中添加宏时，请不要添加方法的修饰符，如 public，private，protected，static，final 等。 永中Office的宏只能在永中Office自己的文件格式（.eio）中使用，保存为微软格式文件时宏代码会丢失。 1.2使用Eclipse 进行二次开发 下载并解压Eclipse包。 在Eclipse目录下点击Eclipse可执行文件，启动Eclipse。 在Eclipse中，新建一个项目： 在菜单“File”—》“New”—》“Project...”弹出“New Project”对话框，在列表中选中“Java Project”选项，下一步，给定一个项目名，假设项目名为“example”，完成，这样就建立了一个名为 “example”的项目。 4、在Eclipse的“Package Explorer”里，选中“example”节点，右键弹出菜单，点击“Properties”菜单项，在弹出的“Properties”对话框中选中左边的“Java Build Path”，选中对话框右边的第三项“Libraries”页面，点击“Add Extern