第一章 二次开发环境
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 进行二次开发
1、下载并解压Eclipse包。
2、在Eclipse目录下点击Eclipse可执行文件,启动Eclipse。
3、在Eclipse中,新建一个项目:
在菜单“File”—》“New”—》“Project...”弹出“New Project”对话框,在列表中选中“Java Project”选项,下一步,给定一个项目名,假设项目名为“example”,完成,这样就建立了一个名为 “example”的项目。
4、在Eclipse的“Package Explorer”里,选中“example”节点,右键弹出菜单,点击“Properties”菜单项,在弹出的“Properties”对话框中选中左边的“Java Build Path”,选中对话框右边的第三项“Libraries”页面,点击“Add External Jars...”按钮,将永中Office 按装目录下的“Yozo_Office.jar”添加进编译环境。这样就可以应用永中Office 的开发包对永中Office 进行二次开发了。
5、在Eclipse 的“Package Explorer”里,选中“example”节点,选择菜单“File”->“New”->“Class”弹出“New Java Class”对话框,填写类名称,假设为“MyTest”,点击完成按钮,这样就在项目“example”中建立了一个名为 “MyTest”的新类。
第二章 二次开发对象层次结构
API是Application Programming Interface(应用程序编程接口)的缩写,即一个主应用程序的开发者提供给其他开发者使用的服务和功能。这意味着API允许一些外部程序访问提供API的程序,即另外的程序通过主应用程序的API而使用某一个子程序的功能。许多大的应用程序都提供了API供二次开发者使用,如各种程序开发语言、各种操作系统及办公软件等。
API不仅仅可以被外部应用程序使用,许多大型应用程序也使用API 以便于自身程序的一部分与另一部分联系。如果一套服务或帮助功能——一个大应用程序的内核已被建立,那么,一个做完了的API就可以使开发应用程序的剩余部分变得十分轻松;此外,将其中一部分常用而且稳定的API开放给用户,用户在此基础上可以根据自己的需要开发出更加强大和个性化的功能,产品功能在适用过程中得到扩展,与用户的交互性也因此而更强。
基于跨平台操作的特性,永中Office充分考虑到用户对功能扩展的要求、不同需求对解决方案的要求及个性化等其它各方面的要求,在其内置的宏编辑器中提供了一整套实现内部功能的API供用户调用;此外,永中Office宏编辑器还支持导入JAVA的类库以使用JAVA 语言强大而丰富的类。
任何API都是基于对象的操作,在操作对象的基础上实现功能。永中Office二次开发的API即相当于JAVA语言中的方法,既可以是对某一对象单个属性或事件的控制和操作,也可以是对整个对象进行的操作,从而实现形式多样的功能。
2.1单实例和多实例
永中Office二次开发体系支持单实例和多实例两种方式。单实例方式通常在永中Office的宏编辑器中使用,多实例方式通常在外部调用永中Office时使用。单实例和多实例在代码中的差别体现在创建永中Office实例时,下面是示例代码:
单实例示例: