关闭

web在线编辑word,excel,pdf插件-----WebOffice 文档控件API

16101人阅读 评论(2) 收藏 举报
分类:



目    录

 

 

 

一、工作原理...5

1.1         开发流程...5

1.2         WEB页面调用控件:.6

二、接口说明...7

2.1         接口...7

2.1.1     AboutBox.7

2.1.2     AcceptAllRevisions.7

2.1.3     CloseDoc.7

2.1.4     DelLocalFile.8

2.1.5     GetDocumentObject.8

2.1.6     GetFieldValue.9

2.1.7     GetTempFilePath.9

2.1.8     GetRevCount.10

2.1.9     GetFileSize.10

2.1.10            GetBookMarkCount.10

2.1.11            HideMenuItem.10

2.1.12            HttpInit.11

2.1.13            HttpAddPostFile.11

2.1.14            HttpAddPostString.11

2.1.15            HttpAddPostCurrFile.12

2.1.16            HttpPost.12

2.1.17            InsertFile.12

2.1.18            IsOpened.13

2.1.19            IsSaved.13

2.1.20            LoadOriginalFile.14

2.1.21            OpenFileDlg.14

2.1.22            ProtectDoc.15

2.1.23            PrintDoc.15

2.1.24            PutSaved.15

2.1.25            Save.16

2.1.26            SaveTo.16

2.1.27            SaveAs.16

2.1.28            SetFieldValue.17

2.1.29            SetTrackRevisions.18

2.1.30            ShowRevisions.18

2.1.31            SetCurrUserName.18

2.1.32            ShowDialog.18

2.1.33            UnProtectDoc(BSTRstrPwd).19

2.2         属性...20

2.2.1     DocType.20

2.2.2     Version.20

2.2.3     AppVersion.20

2.2.4     lEventRet.20

2.2.5     IsModify.21

2.2.6     ShowToolBar.21

2.2.7     lContinue.21

2.3         事件...21

2.3.1     NotifyWordEvent.21

2.3.2     NotifyCtrlReady.22

2.3.3     NotifyToolBarClick.22

附录:WebOffice文件Http上传原理...23

 

 

 

 

 

 

 

                    


一、工作原理

WebOffice是基于客户端的ocx控件,它的功能是将Office文档(Word、Excel、WPS)嵌入到浏览器中,并调用Office中各种接口,完成文档编辑工作,然后使用控件的Http接口模拟表单提交,发送到数据处理页面(此文档举例为saveDoc.asp页,代码见演示文件),完成文档的存档工作。

1.1  开发流程

  ├  装载控件        <object>...</ object >

  ├  触发初始化方法

<SCRIPTLANGUAGE=javascript FOR=WebOffice1 EVENT=NotifyCtrlReady>

<!--

 WebOffice1_NotifyCtrlReady()         

//-->

</SCRIPT>

  ├  执行初始化方法,打开新文档或装载已经存在的文档

functionWebOffice1_NotifyCtrlReady() {

   document.all.WebOffice1.LoadOriginalFile("…","…");

}    

  ├  根据当前步骤,来决定是否进入修订状态,如果是修订状态,最好设置当前的用户名

functionWebOffice1_NotifyCtrlReady() {

   document.all.WebOffice1.LoadOriginalFile("…","…");

   document.all.WebOffice1.SetCurrUserName("张三"); 

   document.all.WebOffice1.SetTrackRevisions(1);

}

├ 填写表单元素,编辑Office文档

  ├  执行Http上传接口保存表单元素和Office文档          

//保存文档之前,如果需要接受修订,需要调用

document.all.WebOffice1.SetTrackRevisions(4);   

//通过Http接口上传

document.all.WebOffice1.HttpInit();             

document.all.WebOffice1.HttpAddPostString("…","…");

document.all.WebOffice1.HttpAddPostCurrFile("…","…");      

document.all.WebOffice1.HttpPost("…")

  ├  saveDoc.asp获取表单数据和Office进行数据库操作,并返回操作是否正确。

  ├  根据saveDoc.asp返回值进行相应操作。

1.2  WEB页面调用控件:

 

     <OBJECT id=WebOffice1 height=520width="100%" style="LEFT: 0px; TOP: 0px"

classid="clsid:E77E049B-23FC-4DB8-B756-60529A35FAD5"  codebase=WebOffice.ocx#Version=3,0,0,0>

     <PARAM NAME="_Version"VALUE="65536">

     <PARAM NAME="_ExtentX"VALUE="2646">

     <PARAM NAME="_ExtentY"VALUE="1323">

     <PARAM NAME="_StockProps"VALUE="0"></OBJECT>

主要参数说明:

id         控件在网页的别名,可以通过别名调用控件的方法、属性

width      控件的宽度,可以使用绝对大小,如width="100px"。

height     控件的高度

codebase      设置控件自动下载的路径,用户如果没有安装控件,系统会自动访问codebase的路径下载控件;“#Version”后的是控件的版本,如果用户当前的软件版本低于“#Version”后面的版本,系统也会自动下载最新的控件

 

注意:    如果控件的width 和height属性使用%表示,则要明确指明它所在的容器的大小,如把控件放到表格<td>内,则要明确指明表格<td>的width和height的绝对值。


二、接口说明

2.1  接口

2.1.1     AboutBox

原 型: void AboutBox();

功  能:显示WebOffice版本信息

返回值:

示  例:

document.all.WebOffice1.AboutBox();

 

2.1.2     AcceptAllRevisions

原  型: longAcceptAllRevisions();

功  能:接受当前文档所有修订

返回值:

0:接受修订成功

       非零:接受修订失败

示  例:

document.all.WebOffice1.AcceptAllRevisions();

2.1.3     CloseDoc

原  型: long CloseDoc(longblReqSaved);

功  能:关闭当前文档

参 数:

      blReqSaved:

       0:关闭文档,不保存当前修改。

       1:关闭文档,保存当前修改。

       2:如果文档已经被修改,显示保存文档对话框,否则直接关闭。

       其它:关闭文档,保存当前修改。

返回值:

       0:    失败

       非零: 成功

示  例:

    //关闭当前文档,不保存当前修改。

document.all.WebOffice1.CloseDoc (0);

 

2.1.4     DelLocalFile

原  型: long DelLocalFile(BSTRstrFilePathName);

功  能:删除本地文件

参 数:

      strFilePathName:本地文件的绝对路径。

返回值:

       0:    删除成功

       非零: 删除失败

示  例:

 document.all.WebOffice1.DelLocalFile("c:\\111.doc");

 

2.1.5    GetDocumentObject

原  型: IDispatch*GetDocumentObject();

功  能:

获取文档对象的ActiveDocument对象,此接口非常重要,基本所有的VBA功能都可以通过这个接口来实现。

参 数:                  

返回值: ActiveDocument对象的Dispatch

示  例:

/* 以下的JavaScript为采用ActiveDocument的方式直接操作VBA,向DOC文档的书签中加入一个图片。

function AddPicture(strMarkName,strBmpPath,vType)

在书签位置插入图片,

strMarkName 书签的名称

strBmpPath  图片的路径

vType       插入后的图片的样式,5为浮动在文字上面

AddPicture("test1","d:\\111.bmp",5);

AddPicture("test1","d:\\111.bmp",128);

*/

function AddPicture(strMarkName,strBmpPath,vType)

{

//定义一个对象,用来存储ActiveDocument对象
         var obj;
         obj =new Object(document.all.WebOffice1.GetDocumentObject());
         if(obj!=null){
               var pBookMarks;

// VAB接口获取书签集合
                  pBookMarks = obj.Bookmarks;
                  var pBookM;

// VAB接口获取书签strMarkName
                  pBookM = pBookMarks(strMarkName);
                  var pRange;

// VAB接口获取书签strMarkName的Range对象
                  pRange = pBookM.Range;
                  var pRangeInlines;

// VAB接口获取书签strMarkName的Range对象的InlineShapes对象
                  pRangeInlines = pRange.InlineShapes;
                  var pRangeInline;

// VAB接口通过InlineShapes对象向文档中插入图片
                  pRangeInline = pRangeInlines.AddPicture(strBmpPath); 

//设置图片的样式,5为浮动在文字上面
                  pRangeInline.ConvertToShape().WrapFormat.TYPE = vType;
                  delete obj; 

   }

}

 

2.1.6     GetFieldValue

原  型: BSTRGetFieldValue(BSTR strFieldName, BSTR strSheetName);

功  能:获得书签位置的数值

参 数:

strFieldName:书签的名字

strSheetName:预留字段(值为空)

    

返回值:返回书签的值

示  例:

//获得书签的值

 var strFieldValue=document.all.WebOffice1.GetFieldValue("mark_1","")

 

2.1.7     GetTempFilePath

原  型: BSTRGetTempFilePath();

功  能:获得临时文件路径

参 数:                  

返回值:当前文件的临时路径

示  例:

 var strTempPath=document.all.WebOffice1.GetTempFilePath()

2.1.8     GetRevCount

原  型: longGetRevCount();

功  能:获取修订节点的个数

参 数:                  

返回值:获取修订节点的个数

示  例:

 

 

 

2.1.9     GetFileSize

原  型: longGetFileSize (LPCTSTR strFilePath);

功  能:获取本地文件的大小

参  数:                  

返回值:

示  例:

 var vLen = obj.GetFileSize("c:\\111.doc");

2.1.10   GetBookMarkCount

原 型: longGetBookMarkCount();

功 能:获取文档中书签的总数量

参 数:                  

返回值:

示 例:

 

2.1.11   GetBook MarkInfo(lIndex,iType)

原 型: longGetBook MarkInfo(lIndex,iType);

功 能:获取文档中书签的信息

参 数:

lIndex:书签的序号,从1开始

   iType:获取内容类型。0获取书签名,1获取书签值

返回值:

示 例:

 

2.1.12   HideMenuItem

原  型: long HideMenuItem(long lMenuType);

功  能:控制自有工具栏的显示

参 数:

lMenuType工具栏开关,采用32位的数字作为开关,当相关位为1的时候,按钮显示,为0是按钮隐藏。

enum{

    vNew = 0x01,         //新建

    vOpen= 0x02,             //打开

    vSaveAs= 0x04,       //保存

    vPrint= 0x10,          //打印

    vPrintView= 0x20,      //打印预览

    vReturn= 0x1000,       //全屏

vShowHideMenu = 0x4000, //显示/隐藏菜单

    vFullScrean= 0x2000    //返回

};

返回值:

示  例:

 //只显示新建和全屏按钮

Object.HideMenuItem(0x01 + 0x1000);

2.1.13   HttpInit

原  型: long HttpInit();

功  能:初始化上传接口

参 数:                  

返回值:

示  例:

//上传前必须执行此方法

document.all.weboffice1.HttpInit();

2.1.14   HttpAddPostFile

原  型: longHttpAddPostFile(BSTR strName, BSTR strFile);

功  能:Http上传相关(保留)

参 数:                  

返回值:

示  例:

//上传本地文件c:\\111.doc

document.all.weboffice1.HttpAddPostFile("111","c:\\111.doc")

 

2.1.15   HttpAddPostString

原  型: longHttpAddPostString(BSTR strName, BSTR strValue);

功  能:添加要上传的表单域

参 数:

      strName:表单域的名称

       strValue:表单域的值

      

返回值:

      

示  例:

//添加表单域,可多次执行此方法

document.all.WebOffice1.HttpAddPostString("DocTitle",myform.DocTitle.value);

 

2.1.16   HttpAddPostCurrFile

原  型: longHttpAddPostCurrFile(String field, String newFileName);

功  能:添加要上传的Word或者Excel文件

参  数:

Field:要上传文件的id

newFielName:上传后的新文件名。该参数可以为空,系统将自动为文件命名

返回值:

示 例:

document.all.WebOffice1.HttpAddPostCurrFile("DocContent","");

2.1.17   HttpPost

原  型: BSTR HttpPost(BSTRstrHttpURL);

功  能:将当前表单和文件数据提交到指定URL路径

参 数:

strHttpURL:  处理表单和文件数据的文件URL路径   

返回值:

     Succeed:上传成功

      failed: 上传失败

示  例:

//相对路径

var returnValue=document.all.WebOffice1.HttpPost("../saveDoc.jsp");

//绝对路径

var returnValue=document.all.WebOffice1.HttpPost("http://127.0.0.1/saveDoc.jsp")

2.1.18   InsertFile

原  形:short  InsertFile(LPCTSTR strFilePathName, shortnCurPos)

功  能:插入合并文件,和插入图片。

参  数:strFilePathName:

           文件或者图片的路径,可以是Http.或者Ftp路径

         nCurPos:

           位置和图片控制符。nCurPos 或者nCurPos -8

           0: 当前位置

           1: 文件开头

2: 文件末尾

            如果第四位为1:表示插入的是图片

      

返回值:

       0:正确

       其他:错误

示  例:

//文件头部

document.all.WebOffice1.InSertFile("http://XX.com/XX.doc",1);

//文件尾部

document.all.WebOffice1.InSertFile("http://XX.com/XX.doc",2);

//当前光标位置

document.all.WebOffice1.InSertFile("http://XX.com/XX.doc",0);

//文件头部

document.all.WebOffice1.InSertFile("http://XX.com/XX.jpg",9);

//文件尾部

document.all.WebOffice1.InSertFile("http://XX.com/XX.jpg",10);

//当前光标位置

document.all.WebOffice1.InSertFile("http://XX.com/XX.jpg",8);

2.1.19   IsOpened

原  型: long IsOpened();

功  能:判断当前是否打开文件

参 数:                  

返回值:

0:表示当前未打开文档

非0:表示已经打开文档

FILE_TYPE_WORD = 11,

FILE_TYPE_WORD =11,

FILE_TYPE_EXCEL= 12,

FILE_TYPE_PPT = 13,

FILE_TYPE_RTF = 14,

FILE_TYPE_WPS = 21,

FILE_TYPE_PDF = 31,

FILE_TYPE_UNK = 127     

 

示  例:

var isOpened=document.all.WebOffice1.IsOpened();

2.1.20   IsSaved

原  型: long IsSaved();

功  能:判断文件是否被修改

参 数:                  

返回值:

0:文件已被修改

非零:文件未被修改

 

示  例:

var isSaved=document.all.WebOffice1.IsSaved();

2.1.21   LoadOriginalFile

原  型: longLoadOriginalFile(BSTR pcFileNameOrUrl, BSTR pcType);

功  能:新建、装载Office文档

参 数:

pcFileNameOrUrl:

要装载文件的本地路径或者URL,值为空表示新建文档,如果是在Http的Web环境下,可以传相对路径. 

pcType:

doc:打开、新建Word文件

xls:打开、新建Excel文件

ppt:打开、新建PPT  文件

wps:打开、新建WPS  文件

    

返回值:

      0:失败

          非0:成功

示  例:

 // 通过URL打开一个服务器文件,getdoc.asp代码见演示文件

document.all.WebOffice1.LoadOriginalFile("http://127.0.0.1/getdoc.asp?id=8","doc");

// 通过URL打开一个服务器文件,相对路径

document.all.WebOffice1.LoadOriginalFile("/getdoc.asp?id=8","doc");

document.all.WebOffice1.LoadOriginalFile("./getdoc.asp?id=8","doc");

// 新建Excel

document.all.WebOffice1.LoadOriginalFile("","xls");

// 通过Word打开本地文件

document.all.WebOffice1.LoadOriginalFile("C:\\demo.doc","doc");

2.1.22   OpenFileDlg

原  型: shortOpenFileDlg();

功  能:打开本地文件显示在WebOffice中

参  数:pcFileNameOrUrl:保存的文件路径

返回值:

示  例:

//打开对话框

document.all.WebOffice1.OpenFileDlg()

2.1.23   ProtectDoc

原  型: longProtectDoc(long lProOrUn, long lType, BSTR strPWD);

功  能:文档保护

参  数:

lProOrUn:

└ 1:为保护文档

└ 0:为解锁文档

lType       :

└ 0 :文档保护,只允许修订

└ 1 :文档保护,只允许批注

└ 2 :文档完全保护,不允许任何操作

strPWD:文档保护、解锁时所需设置的密码

  

返回值:

示  例:

// 保护文档,只允许修订

document.all.WebOffice1.ProtectDoc(1,0, "12345");  

// 解锁文档

document.all.WebOffice1.ProtectDoc(0,0, "12345");     

 

2.1.24   PrintDoc

原  型: long PrintDoc(longblShowDlg);

功  能:打印当前文档

参 数:blShowDlg:

0:不显示打印对话框,直接打印

              非零:显示打印对话框

返回值:

0:打印失败

              非零:打印成功

示  例:

//显示打印对话框

 document.all.WebOffice1.PrintDoc(1);

2.1.25   PutSaved

原  型: longPutSaved(boolean bSaved);

功  能:设置当前文档的修改状态

参  数: 

       0: 处于修改状态

       1: 处于保存状态

返回值:

示  例:

//设置当前文档处于修改状态

document.all.WebOffice1.PutSaved(0);

2.1.26   Save

原  型: long Save();

功  能

将文件保存原来位置,第一次保存时弹出对话框

参  数:

返回值:

0:保存失败

       非零:保存成功

示  例:

document.all.WebOffice1.Save();

2.1.27   SaveAs

原  型: long SaveAs(BSTRstrFileName, long dwFileFormat);

功  能:保存文件到本地

参  数:

strFileName: 要保存的文件路径和文件名

dwFileFormat:保存的文件类型

     └ 0 Word类型

     └ 2 Txt文件

     └ 6 Rtf文件

└ -4143 Excel类型

返回值:

示  例: 

document.all.WebOffice1.SaveAs("C:\\test.doc",0);      //另存为Word文件

document.all.WebOffice1.SaveAs("C:\\test.txt",2);      //另存为Txt文件

document.all.WebOffice1.SaveAs("C:\\test.rtf",6);      //另存为Rtf文件

document.all.WebOffice1.SaveAs("C:\\test.xls",-4143);  //另存为Excel文件 

2.1.28   SetFieldValue

原  型: longSetFieldValue(BSTR strFieldName, BSTR strValue, BSTR strSheetName);

功  能:添加书签,套红头模板

参  数:strFieldName:书签的名字,对于Excel文件,此数据位单元格

strValue:书签的值,该处可以是个用于返回数据的URL,用于套红头模板。对于Excel文件,如果插入的是图片,此数值为::JPG::+图片的路径

strSheetName:命令的类型,对于Excel文件此数值为Sheet的名称

     └ ::ADDMARK::  添加书签

          └::DELMARK::  删除书签

          └::JPG::         添加图片,可以利用这个来实现图片电子印章

     └ ::FILE::      调用本地或者URL的文件设置书签值(套红头)

 

返回值:

示  例:

// 添加书签mark_1,并为它赋值

document.all.WebOffice1.SetFieldValue("mark_1","北京","::ADDMARK::");

// 为已存在的书签mark_1赋值

document.all.WebOffice1.SetFieldValue("mark_1","电子签章",  "");

// 套本地红头

document.all.WebOffice1.SetFieldValue("mark_1","c:\\test.doc", "::FILE::");

// 套服务端红头1,getDoc.asp页用于返回要装载Word的二进制值,代码见演示文件

document.all.WebOffice1.SetFieldValue("mark_1","http://127.0.0.1/getdoc.asp?id=8", "::FILE::");

// 套服务端红头2

document.all.WebOffice1.SetFieldValue("mark_1","http://127.0.0.1/test.doc","::FILE::");

//添加图片电子印章

document.all.WebOffice1.SetFieldValue("mark_1","http://127.0.0.1/seal.bmp","::JPG::");

//在Excel中添加图片

document.all.WebOffice1.SetFieldValue("","::JPG::http://www.google.cn/intl/zh-CN/images/logo_cn.gif","");

2.1.29   SetTrackRevisions

原  型: longSetTrackRevisions(long lValue);

功  能:修订文档

参  数:

lValue:文档修订状态

     └ 1: 开始修订文档

     └ 0: 进入非留痕状态

     └ 4:接受当前修订

返回值:

示  例:

// 开始修订

document.all.WebOffice1.SetTrackRevisions(1);

// 接受修订

document.all.WebOffice1.SetTrackRevisions(4);   

2.1.30   ShowRevisions

原  型: longShowRevisions(long nNewValue);

功  能:显示、隐藏修订

参  数:

nNewValue:要保存的文件路径和文件名

     └ 1:显示修订

     └ 0:隐藏修订

返回值:

示例:

document.all.WebOffice1.ShowRevisions(0);     //隐藏修订

2.1.31   SetCurrUserName 

原  型: longSetCurrUserName(BSTR strCurrUserName);

功  能:设置当前编辑Word、Excel的用户名,主要用于修订文档,标识不同人进行的不同操作

参  数:strCurrUserName:当前编辑人的用户名

返回值:

  示  例:document.all.WebOffice1.SetCurrUserName("张三");   

2.1.32   ShowDialog

原 型: long ShowDialog(longdwIndex);

功  能:

        显示对话框

参  数:

      dwIndex:对话框的ID数值,详细的数值列表请参照附件。

返回值:

示  例:

 

2.1.33   UnProtectDoc(BSTR strPwd)

原 型: long UnProtectDoc(BSTR strPwd);

功  能:解除当前文档保护

参  数:strPwd文档保护时所设置的密码

返回值:

0:解锁成功

       非零:解锁失败

示  例:

document.all.WebOffice1.UnProtectDoc("12345");

 

 


2.2  属性

2.2.1     DocType

原  型: longDocType;

说  明:文件类型,只读

数 值

FILE_TYPE_WORD =11,

FILE_TYPE_WORD = 11,

FILE_TYPE_EXCEL = 12,

FILE_TYPE_PPT = 13,

FILE_TYPE_RTF = 14,

FILE_TYPE_WPS = 21,

FILE_TYPE_PDF = 31,

FILE_TYPE_UNK = 127     

 

2.2.2    Version

原 型: BSTRVersion;

说  明:打开文件的版本号,只读

数  值

 

2.2.3     AppVersion

原 型: BSTRVersion;

说  明:打开文件的版本号,只读

数  值

 

2.2.4    lEventRet

原 型: BOOL LEventRet;

说  明:见事件 NotifyToolBarClick事件

数  值

 

2.2.5    IsModify

原 型: BOOLIsModify;

说  明:判断文档是否被修改,需要在LoadOrigarFile之前设置 OptionFlag|= 0x0400 才有效。

2.2.6    lContinue

原  型: long lContinue;

功  能:用于NotifyWordEvent的处理函数中,可以终止相应事件的继续执行

参  数:

返回值:

       1:可以继续执行(默认)

       0:不是2007版本

示  例:

//禁止关闭当前的Word/Excel/Wps文档

OnNotifyWordEvent(BSTRstrEventName)

{

if(strEventName == “DocumentBeforeClose”)

{

lContinue = 0;

}

}

 

2.3  事件

2.3.1     NotifyWordEvent

原  型:  void  NotifyWordEvent(BSTRstrEventName);

说  明:捕获部分Word/Excel/Wps事件。

参数:strEventNameàWord/Excel的事件名,可能是以下的数值

DocumentChange

DocumentBeforeClose

DocumentBeforePrint

DocumentBeforeSave

备注:本事件在本版本扩展到Excel和Wps的支持,且可以终止该事件的继续执行(使用属性lContinue)。

2.3.2    NotifyCtrlReady

原 型: void NotifyCtrlReady();

说  明:当控件准备完毕后触发,一般在这个事件中完成初始化的操作。

 

 

2.3.3    NotifyToolBarClick

原 型: voidNotifyToolBarClick(long iIndex);

参 数:

long iIndex : 工具栏按钮ID。

ID_RETURN                       32769

ID_NEW                           32770

ID_OPEN                          32771

ID_SAVEAS                        32772

ID_FULLSCREAN                   32773

ID_PRINT                         32774

ID_PRINTVIEW                    32775

说  明:

   

(不适用于Office2007)每个按钮都有默认的处理动作,如果不希望触发默认的处理动作,需要在此时间中设置属性lEventRet = 0;

以下实例截获了SAVEAS的按钮事件。

//1. 定义事件处理函数

<SCRIPTLANGUAGE=javascript FOR=WebOffice1 VENT=NotifyToolBarClick(lCmd)>

<!--

 WebOffice1_NotifyToolBarClick(lCmd)

//-->

</SCRIPT>

//2. 截获处理事件

functionWebOffice1_NotifyToolBarClick(lCmd) {

    if(32772==lCmd){

       document.all.WebOffice1.lEventRet = 0;   

    }

}

 

附录:WebOffice文件Http上传原理

WebOffice文件Http上传原理分析

 

WebOffice控件使用了自身的文件Http上传接口实现文件和表单域的上传保存,本文将简要介绍该上传方式的原理和使用方法。注:WebOffice的上传接口和AIP是一致的。

 

原理

因为Web页面上的WebOffice打开的文件无法随表单记录提交到处理页面,所以我们把文件模拟成表单的文件域<input type=file …>,通过接口把文件和表单元素发送到保存记录的页面(过程类似表单的提交)。

 

主要上传接口:

l HttpInit();

该方法用于初始化上传接口,不需要设置参数

 

l HttpAddPostString(String FieldName, String someValue);

添加要提交的表单域, FieldName是要上传表单域名称,someValue是表单域值

例一:

HttpAddPostString("username", "zhangSan");

它类似域表单域的

<input type=text name=username value=zhangSan>

              例二:

                     HttpAddPostString("username", WebForm.username.value);

                     ….

                     <form name= WebForm >

<input type=text name=username value=zhangSan>

                     </form>

注意如果使用 上传接口,那么form表单里的表单域不会被提交到处理页面。需要手工添加到上传接口(HttpAddPostString接口),然后通过控件发送到处理页面。例二使用了“WebForm.username.value”获取表单域值。

 

l HttpAddPostCurrFile(String fileName, String ReName);

添加当前WebOffice编辑的文件给上传接口,该接口把文件模拟到成一个表单的文件域,并提交到处理页面。

例一:

HttpAddPostCurrFile("AipFile", "");

该接口模拟表单文件域如下:

<input type=file name=AipFile >

注意:第二个参数为空表示控件自动为文件命名,如:dj_temp.aip,如果需要重命名可以在第二个参数指明文件名称,也可在保存页面指定文件名称。

 

l HttpPost(String url);

执行上传操作将文件和表单域提交到url的页面进行保存操作,并获取url页面返回的执行结果 (是否成功,可以根据这个结果来获取服务器端执行的结果)。

url支持绝对路径和相对路径。

绝对路径,例如:http://192.168.0.1/savedoc.asp

相对路径要以“./”或者“../”开头。例如:./savedoc.asp

完整的上传接口演示

function SaveDoc() {

         var returnValue;                                              //保存页面的返回值

         document.all.WebOffice1.HttpInit();  //初始化Http引擎

// 添加相应的Post元素

         document.all.WebOffice1.HttpAddPostString("username", WebForm. username.value);

         // 添加上传文件

         document.all.WebOffice1.HttpAddPostCurrFile("AipFile ","");   

         // 提交上传文件

         returnValue = document.all.WebOffice1.HttpPost("../saveDoc.jsp");

         if("true" == returnValue){

                   alert("文件上传成功");       

         } else  {

                   alert("文件上传失败")

         }

}

 

关于保存

WebOffice上传接口将数据流以Http方式提交到保存页面,至于对数据处理就和普通的文件上传处理一样了,具体代码参考附件(asp和jsp的实现)。


论坛:http://forum.dianju.cn/

 

 

0
0

查看评论
* 以上用户言论只代表其个人观点,不代表CSDN网站的观点或立场
    个人资料
    • 访问:2323389次
    • 积分:18590
    • 等级:
    • 排名:第485名
    • 原创:382篇
    • 转载:181篇
    • 译文:0篇
    • 评论:105条
    联系方式

    qq :122043580


    邮箱:122043580@qq.com

    博客专栏
    最新评论