WebOffice常用API接口使用说明

3.控件部份接口使用说明

1.新建文档

方式一：CreateNew接口

用ProgId方式依本地机OFFICE版本新建文件方式，此方式如果本地机是Office2003则建立的文档是DOC,XLS,PPT等格式，如果本地机是OFFICE2007以上版本，则建立的文件是DOCX,XLSX,PPTX等格式。
//新建WORD文档
document.getElementById(‘WebOffice’).CreateNew(“Word.Document”);
//新建EXCEL文档
document.getElementById(‘WebOffice’).CreateNew(“Excel.Sheet”);
//新建PPT文档
document.getElementById(‘WebOffice’).CreateNew(“PowerPoint.Show”);
也可以写成
网页获到WebOffice编程对象：
var WebOffice=document.getElementById(‘WebOffice’);
执行上面语句，则WebOffice即为JS的控件编程对象，有了此对象名，即可访问相关接口，让控件工作。
//新建WORD文档
WebOffice.CreateNew(“Word.Document”);
//新建WORD文档
WebOffice.CreateNew(“Excel.Sheet”);
//新建PPT文档
WebOffice.CreateNew(“PowerPoint.Show”);
上面两个写法是相同的，下面的接口也类似。

方式二：Open接口

采用模板方式建立(实际项目开发式建议此方式)
在服务器上存放好DOC,DOCX,XLS,XLSX,PPT,PPTX等格式的模板文件，需要建立时打开对应格式的模板文件即可。
1.打开一个空白doc文档，建立doc文档
WebOffice.Open(‘http://www.officectrl.com/weboffice/temp/word.doc’,true,“Word.Document”);
2.打开一个空白xls文档，建立xls文档
WebOffice.Open(‘http://www.officectrl.com/weboffice/temp/excel.xls’,true,“Excel.Sheet”);
3.打开一个空白ppt文档，建立ppt文档
WebOffice.Open(‘http://www.officectrl.com/weboffice/temp/ppt.ppt’,true,“PowerPoint.Show”);
4.打开一个空白docx文档，建立docx文档
WebOffice.Open(‘http://www.officectrl.com/weboffice/temp/word.docx’,true,“Word.Document”);
5.打开一个空白xlsx文档，建立xlsx文档
WebOffice.Open(‘http://www.officectrl.com/weboffice/temp/excel.xlsx’,true,“xlsx”);
6.打开一个空白pptx文档，建立pptx文档
WebOffice.Open(‘http://www.officectrl.com/weboffice//temp/ppt.pptx’,true,“pptx”);

2.打开文件方法:Open接口

1.打开本地路径的文件：
document.getElementById(‘WebOffice’).Open(“c:\aa.doc”);
2.指定用WORD来打开本地文本文件:

document.getElementById(‘WebOffice’).Open(“c:\aa.txt”,true,“Word.Document”);
3.打开服务器上的文件：
document.getElementById(‘WebOffice’).Open(“http://aaa.com/aa/a.doc”);
4.指定用WORD来打开服务器上的文件:

document.getElementById(‘WebOffice’).Open(“http://aaa.com/aa/a.doc”,true,“Word.Document”);
5.二进制流的方式打开文件：
document.getElementById(‘WebOffice’).Open(“http://aaa.com/aa/a.jsp?id=1”,true,“Word.Document”);
上面open方法的第二个参数 false,true是可以自由选择的，暂未起实质作用。

3.保存文件

3.1保存文件到本地电脑
save接口
document.getElementById(‘WebOffice’).Save(“c:\aa.doc”);
saveas接口
document.getElementById(‘WebOffice’).ActiveDocument.SaveAs(“c:\aa.doc”);
3.2保存文件到服务器

采用HTTP标准协议上传文件，在服务器端需要运行一个jsp、php、.net或Node.js等脚本,用于接上客户端上来过来的文件并保存到服务器硬盘或数据库里。
这个接收脚本页面编写类似于传统网页表单Post上传接收文件的一个页面,此页面完成数据接收保存工作。
接收页面的地址类似于：http://www.officectrl.com/officecs/upload.aspx?id=1
3.2.1 save方法

如：strSaveUrl = “http://www.officectrl.com/officecs/upload.aspx?id=1”;
则：
document.getElementById(‘WebOffice’).Save(“http://www.officectrl.com/officecs/upload.aspx?id=1”);
或
document.getElementById(‘WebOffice’).Save(strSaveUrl);
3.2.2 httppost方法

模拟表单Post上传，采用标准Http协议Post上传文档数据，将文档Post到一个动态页面 (servlet,jsp,php,aspx,asp,node.js…),由此动态网页负责接收和保存上传过来的参数变量和文档二进制数据。

HttpInit();
HttpAddPostString(参数名,参数值);
HttpAddPostCurrFile(“docfile”,上传文档名称);
HttpPost(服务器动态页面地址);

示例：
//初始化Http引擎，最新版控件可以不需要再初始化
document.getElementById(‘WebOffice’).HttpInit();
//增加上传参数变量，类似与表单录入框名称和值，比如下面语句：ID为名称，202001为值
document.getElementById(‘WebOffice’).HttpAddPostString(“id”,“202001”);
document.getElementById(‘WebOffice’).HttpAddPostString(“User”,“张三”);
//将控件里打开的WORD文档以A.DOC名称上传,docfile为固定的参数
document.getElementById(‘WebOffice’).HttpAddPostCurrFile(“docfile”, “a.doc”);
//上面语句为准备上传的数据，接下来执行模拟表单上传动作
document.getElementById(‘WebOffice’).HttpPost(“http://www.officectrl.com/officecs/upload.aspx?id=1”);

注意用Save方法保存与httpPost方法保存的接收程序写法是不同的，具体可以参考相关示例:
HttpPost接口实现 http://www.officectrl.com/down/word0.1.rar
Save接口 http://www.officectrl.com/down/word0.2.rar

未完待续…