WebOffice-开发文档 下载本文

标记

名称: 状态: 部门: 文档ID:

WebOffice 文档控件

开发文档

WebOffice开发文档 发布 研发部

WebOffice-01-001

目 录

一、工作原理.................................................................................................................. 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 AddMenu ............................................................................................... 7 2.1.4 BookMarkOpt ........................................................................................ 7 2.1.5 CloseDoc.............................................................................................. 8 2.1.6 ConvertToAip....................................................................................... 8 2.1.7 CreateApp ............................................................................................ 8 2.1.8 DelLocalFile....................................................................................... 9 2.1.9 DownLoadFile....................................................................................... 9 2.1.10 ExcProtectSharing ....................................................................... 9 2.1.11 ExcUnprotectSharing ................................................................. 10 2.1.12 FtpConnect ................................................................................. 10 2.1.13 FtpDisConnect ............................................................................ 10 2.1.14 FtpGetFile ................................................................................. 10 2.1.15 GetDocumentObject ......................................................................11 2.1.16 GetFieldValue ............................................................................ 12 2.1.17 GetTempFilePath ........................................................................ 12 2.1.18 GetRevCount ............................................................................... 12 2.1.19 GetRevInfo ................................................................................. 13 2.1.20 GetFileSize ............................................................................... 14 2.1.21 GetBookMarkCount....................................................................... 14 2.1.22 GetBookMarkInfo ........................................................................ 14 2.1.23 HideMenuItem.............................................................................. 15 2.1.24 HideMenuAction .......................................................................... 15 2.1.25 HttpInit..................................................................................... 16 2.1.26 HttpAddPostFile ........................................................................ 16 2.1.27 HttpAddPostBuffer ..................................................................... 17 2.1.28 HttpAddPostValue....................................................................... 17 2.1.29 HttpAddPostString ..................................................................... 17 2.1.30 HttpAddPostCurrFile ................................................................. 17 2.1.31 HttpAddPostCurrFile2................................................................ 18 2.1.32 HttpPost..................................................................................... 18 2.1.33 InsertFile ................................................................................. 18 2.1.34 IsOpened..................................................................................... 19

2.1.35 IsSaved ...................................................................................... 20 2.1.36 InsertFile ................................................................................. 20 2.1.37 LoadOriginalFile....................................................................... 21 2.1.38 OpenFileDlg ............................................................................... 21 2.1.39 ProtectDoc ................................................................................. 21 2.1.40 PrintDoc..................................................................................... 22 2.1.41 PutSaved..................................................................................... 22 2.1.42 ReplaceText ............................................................................... 23 2.1.43 Save............................................................................................ 23 2.1.44 SaveTo ........................................................................................ 23 2.1.45 SaveAs ........................................................................................ 23 2.1.46 SaveAsPDF ................................................................................... 24 2.1.47 SetFieldValue ............................................................................ 24 2.1.48 SetPageAs ................................................................................... 25 2.1.49 SetTrackRevisions ..................................................................... 26 2.1.50 ShowRevisions ............................................................................ 26 2.1.51 SetCurrUserName ........................................................................ 26 2.1.52 SetToolBarButton2 ..................................................................... 26 2.1.53 SetCurrTime ............................................................................... 28 2.1.54 SetKeyCtrl ................................................................................. 28 2.1.55 SetSecurity ............................................................................... 28 2.1.56 ShowDialog ................................................................................. 29 2.1.57 SetValue..................................................................................... 29 2.1.58 SetDocVariable .......................................................................... 30 2.1.59 UnProtectDoc(BSTR strPwd) ....................................................... 30 2.1.60 ZipFile ...................................................................................... 31 2.1.61 GetBMPos..................................................................................... 31 2.1.62 LocalProtect.............................................................................. 31 2.1.63 UnActiveExcel() ........................................................................ 32 2.1.64 HideMenuArea.............................................................................. 32 2.1.65 SetCustomColour ........................................................................ 32 2.1.66 SetCustomToolBtn....................................................................... 33 2.1.67 GetFileBase64 ............................................................................ 34 2.1.68 SaveBinaryFileFromBase64......................................................... 34 2.1.69 SetWindowText ............................................................................ 34 2.2 属性 ......................................................................................................... 35

2.2.1 DocType ............................................................................................. 35 2.2.2 Version ............................................................................................. 35 2.2.3 AppVersion ........................................................................................ 35 2.2.4 lEventRet .......................................................................................... 35 2.2.5 IsModify............................................................................................ 36 2.2.6 ShowToolBar ...................................................................................... 36 2.2.7 OptionFlag ........................................................................................ 36 2.2.8 Is2007 ............................................................................................... 37

2.2.9 lContinue .......................................................................................... 37 2.3 事件 ......................................................................................................... 37

2.3.1 NotifyWordEvent ............................................................................... 37 2.3.2 NotifyCtrlReady ............................................................................... 38 2.3.3 NotifyToolBarClick .......................................................................... 38

三、ASP例子说明 ......................................................................................................... 40

3.1 Access数据库结构 .................................................................................. 40 3.2 演示程序主要页面说明 ............................................................................ 40 3.3 开发必读 .................................................................................................. 40 四、FAQ ......................................................................................................................... 41

4.1 如何把文件直接上传到服务器 ....................................................................... 41 五、附录 ....................................................................................................................... 42

5.1 WebOffice文件Http上传原理 ...................................................................... 42 5.1 如何自定义工具栏.............................................................错误!未定义书签。

一、工作原理

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

1.1 开发流程

├ 装载控件 ... ├ 触发初始化方法

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

function WebOffice1_NotifyCtrlReady() {

document.all.WebOffice1.LoadOriginalFile(\, \); }

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

function WebOffice1_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页面调用控件:

主要参数说明:

id 控件在网页的别名,可以通过别名调用控件的方法、属性 width 控件的宽度,可以使用绝对大小,如width=\。 height 控件的高度

codebase 设置控件自动下载的路径,用户如果没有安装控件,系统会自动访问

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

注意: 如果控件的width 和height属性使用%表示,则要明确指明它所在的容

器的大小,如把控件放到表格内,则要明确指明表格的width和height的绝对值。

二、接口说明

2.1 接口

2.1.1

AboutBox 原 型: void AboutBox();

功 能:显示WebOffice版本信息 返回值: 示 例:

document.all.WebOffice1. AboutBox();

2.1.2 AcceptAllRevisions 原 型: long AcceptAllRevisions(); 功 能:接受当前文档所有修订 返回值:

0:接受修订成功

非零:接受修订失败 示 例:

document.all.WebOffice1.AcceptAllRevisions();

2.1.3 AddMenu 原 形:AddMenu(LPCTSTR cMenuName, LPCTSTR cChildName, long iIndex, LPCTSTR cBindJSFun)

功 能:(保留) 参 数: 返回值:

示 例:

2.1.4 BookMarkOpt 原 型: long BookMarkOpt(BSTR strBookMarks,long lType);

功 能:获取文档书签列表(保留) 参 数: 返回值: 示 例:

2.1.5 CloseDoc

原 型: long CloseDoc(long blReqSaved); 功 能:关闭当前文档 参 数:

blReqSaved:

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

2:如果文档已经被修改,显示保存文档对话框,否则直接关闭。 其它:关闭文档,保存当前修改。 返回值:

0: 失败 非零: 成功 示 例:

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

document.all.WebOffice1.CloseDoc (0);

2.1.6 ConvertToAip 原 型: short ConvertToAip(short nAddOriFile,short nSupport)

功 能:把当前通过LoadOriginalFile打开的原始文件直接转化成AIP文件。 参 数:

nAddOriFile:是否装载原始文件。

0:不装载。

非0:装载原始文件。

nSupport:

是否以普通方式(即解析文档的书签)打开。0:不解析。非0:解析。

返回值:

0:转化失败

非零:转化成功

示 例:document.all.WebOffice1.ConvertToAip (1,1);

2.1.7 CreateApp 原 型: short CreateApp(BSTR strAppName); 功 能:(保留) 参 数:

返回值: 示 例:

2.1.8 DelLocalFile 原 型: long DelLocalFile(BSTR strFilePathName);

功 能:删除本地文件(6.0.4.0以后的版本,只能删除临时文件,即通过GetTempFilePath获取的路径)

参 数:

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

0: 删除成功 非零: 删除失败 示 例:

document.all.WebOffice1.DelLocalFile(\

2.1.9 DownLoadFile 原 型: short DownLoadFile(LPCTSTR strHttpFileURL, LPCTSTR strLocalFilePath, LPCTSTR strTitle, LPCTSTR strFileType)

功 能:下载远程服务器文件,当设置OptionFlag |= 0x0080 会弹出文件下载进度条。

参 数:

strHttpFileURL:服务器文件路径。

strLocalFilePath:保存的本地文件路径,如为空则弹出文件保存对话框。 strTitle:文件保存对话框的默认文件名,仅当strLocalFilePath为空有效。

strFileType:默认文件类型,仅当strLocalFilePath为空有效。

返回值:

0: 成功 非零: 失败 示 例:

obj.DownLoadFile(\obj.DownLoadFile(\标题\

2.1.10 ExcProtectSharing 原 型: long ExcProtectSharing(BSTR strPassword,BSTR strWriteResPassword, short bReadOnlyRecommended,BSTR strSharingPassword);

功 能:(保留) 参 数: 返回值: 示 例:

2.1.11 ExcUnprotectSharing 原 型: long ExcUnprotectSharing(BSTR strSharingPassword); 功 能:(保留) 参 数: 返回值: 示 例:

2.1.12 FtpConnect 原 型: long FtpConnect(BSTR strURL, long lPort, BSTR strUser, BSTR strPwd);

功 能:FTP相关(保留) 参 数: 返回值: 示 例:

2.1.13 FtpDisConnect 原 型: long FtpDisConnect(); 功 能:FTP相关(保留) 参 数: 返回值: 示 例:

2.1.14 FtpGetFile 原 型: long FtpGetFile(BSTR strRemoteFile, BSTR strLocalFile); 功 能:FTP相关(保留) 参 数: 返回值:

示 例:

2.1.15 GetDocumentObject 原 型: IDispatch* GetDocumentObject(); 功 能:

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

返回值: ActiveDocument对象的Dispatch 示 例:

/* 以下的JavaScript为采用ActiveDocument的方式直接操作VBA,向DOC文档的书签

中加入一个图片。

function AddPicture(strMarkName,strBmpPath,vType) 在书签位置插入图片, strMarkName 书签的名称 strBmpPath 图片的路径

vType 插入后的图片的样式,5为浮动在文字上面 AddPicture(\ AddPicture(\ */

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.16 GetFieldValue 原 型: BSTR GetFieldValue(BSTR strFieldName, BSTR strSheetName); 功 能:获得书签位置的数值 参 数:

strFieldName:书签的名字

strSheetName:预留字段(值为空)

返回值: 返回书签的值 示 例:

//获得书签的值

var strFieldValue=document.all.WebOffice1.GetFieldValue(\

2.1.17 GetTempFilePath 原 型: BSTR GetTempFilePath(); 功 能:获得临时文件路径 参 数: 返回值: 当前文件的临时路径 示 例:

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

2.1.18 GetRevCount 原 型: long GetRevCount(); 功 能:获取修订节点的个数 参 数:

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

2.1.19 GetRevInfo 原 型: BSTR GetRevInfo(long lIndex, long lType);

功 能:获取修订节点的信息(修订人,修订的时间,修订的动作) 参 数:

lIndex: 修订的节点编号 lType: 获取的信息编号 返回值: 示 例:

//1.获取修订的用户

vUserName = document.all.WebOffice1.GetRevInfo(i,0); //2.获取修订的时间

vDate = new String(document.all.WebOffice1.GetRevInfo(i,1)); //3.获取修订的动作

var vRet = document.all.WebOffice1.GetRevInfo(i,2); vRet == \表示\插入\的操作 vRet == \表示\删除\的操作 //4.获取修订的内容

vUserName = document.all.WebOffice1.GetRevInfo(i,3); //总体的例子代码 var vCount;

vCount = document.all.WebOffice1.GetRevCount(); var vOpt = 0; var vDate;

for(var i=1; i<= vCount; i++){

vOpt = document.all.WebOffice1.GetRevInfo(i,2); if(\ vOpt = \插入\

}else if(\ vOpt = \删除\ }else{

vOpt = \未知操作\ }

vDate = new String(document.all.WebOffice1.GetRevInfo(i,1)); vDate = parseFloat(vDate); dateObj = new Date(vDate);

alert(dateObj.getYear() + \年\月\dateObj.getDate() +\日\+ dateObj.getHours() +\时\+ dateObj.getMinutes() +\分\秒\

alert(\用户:\+ \操作:\+ vOpt + \内容:\

}

2.1.20 GetFileSize 原 型: long GetFileSize (LPCTSTR strFilePath); 功 能:获取本地文件的大小 参 数: 返回值: 示 例:

var vLen = obj.GetFileSize(\

2.1.21 GetBookMarkCount 原 型: long GetBookMarkCount(); 功 能:获取文档中书签的总数量 参 数: 返回值: 示 例: GetFileSize

2.1.22 GetBookMarkInfo 原 型: BSTR GetBookMarkInfo(long lIndex, long lType); 功 能:获取各书签的信息(名称和变量) 参 数: 返回值: 示 例:

var vBKCount;

vBKCount = document.all.WebOffice1.GetBookMarkCount(); var iIndex; var vName; var vValue; var vShowInfo; vShowInfo = \

for(iIndex = 1; iIndex <= vBKCount; iIndex++){

vName = document.all.WebOffice1.GetBookMarkInfo(iIndex,0 ); vValue = document.all.WebOffice1.GetBookMarkInfo(iIndex,1 ); vShowInfo += \ vName = \ vValue = \ }

alert(vShowInfo);

2.1.23 HideMenuItem 原 型: long HideMenuItem(long lMenuType); 功 能:控制自有工具栏的显示 参 数:

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

enum{

vNew = 0x01, //新建 vOpen = 0x02, //打开 vSaveAs = 0x04, //保存 vPrint = 0x10, //打印 vPrintView = 0x20, //打印预览 vReturn = 0x1000, //全屏 vFullScrean = 0x2000 //返回 };

返回值: 示 例:

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

Object.HideMenuItem(0x01 + 0x1000);

2.1.24 HideMenuAction 原 型: long HideMenuAction(short shMenuMode, long lValue); 功 能:设置菜单的隐藏和显示。支持Office2007的菜单隐藏和显示 参 数:(仅适用于Office2007)

shMenuMode:设置模式:具体值及含义如下:

0:Office2003以下,直接关闭菜单,暂未支持。可使用SetToolBarButton2接口控制

1:Office2007以上,需要设置关闭菜单列表 2:扩展值,暂无含义 3:扩展值,暂无含义 4:扩展值,暂无含义

5:设置关闭菜单列表后,需调用此值激活。并第二个参数设置为0,具体见示例。

6:恢复菜单显示及功能使用,第二个参数设置为0 lValue:设置要隐藏的菜单及禁止复制、粘贴功能 0x1000:十进制为4096--粘贴无效 0x2000:十进制为8192—复制无效

0x100000:十进制为1048576—开始菜单

0x200000:十进制为2097152—插入菜单 0x400000:十进制为4194304—页面布局菜单 0x800000:十进制为8388608—引用菜单

0x1000000:十进制为16777216—邮件菜单 0x2000000:十进制为33554432—审阅菜单 0x4000000:十进制为67108864—视图菜单

0x8000000:十进制为134217728—开发工具菜单 0x10000000:十进制为268435456—加载项菜单

返回值: 示 例:

//设置粘贴无效

document.all.WebOffice1. HideMenuAction(1,4096);//设置动作 document.all.WebOffice1. HideMenuAction(5,0);//激活设置 //设置复制无效

document.all.WebOffice1. HideMenuAction(1,4096); document.all.WebOffice1. HideMenuAction(5,0); //设置开始菜单隐藏

document.all.WebOffice1. HideMenuAction(1,1048576); document.all.WebOffice1. HideMenuAction(5,0);

//设置多菜单隐藏(比如隐藏开始、插入、页面布局菜单)

document.all.WebOffice1. HideMenuAction(1,1048576+2097152+4194304); document.all.WebOffice1. HideMenuAction(5,0); //恢复至设置之前状态(即正常状态)

document.all.WebOffice1. HideMenuAction(6,0);

2.1.25 HttpInit 原 型: long HttpInit(); 功 能:初始化上传接口 参 数: 返回值: 示 例:

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

document.all.weboffice1.HttpInit();

2.1.26 HttpAddPostFile 原 型: long HttpAddPostFile(BSTR strName, BSTR strFile); 功 能:Http上传相关(保留) 参 数: 返回值: 示 例:

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

document.all.weboffice1.HttpAddPostFile(\ \

2.1.27 HttpAddPostBuffer 原 型: long HttpAddPostBuffer(BSTR strName, BSTR strRelateFile, BSTR pbBuffer, long lLen);

功 能:Http上传相关(保留) 参 数: 返回值: 示 例:

2.1.28 HttpAddPostValue 原 型: long HttpAddPostValue(BSTR strName, long lValue); 功 能:Http上传相关(保留) 参 数: 返回值: 示 例:

2.1.29 HttpAddPostString 原 型: long HttpAddPostString(BSTR strName, BSTR strValue); 功 能:添加要上传的表单域 参 数:

strName:表单域的名称 strValue:表单域的值 返回值: 示 例:

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

document.all.WebOffice1.HttpAddPostString(\myform.DocTitle.value);

2.1.30 HttpAddPostCurrFile 原 型: long HttpAddPostCurrFile(String field, String newFileName); 功 能:添加要上传的Word或者Excel文件 参 数:

Field:要上传文件的id

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

document.all.WebOffice1.HttpAddPostCurrFile(\

2.1.31 HttpAddPostCurrFile2 原 型: long HttpAddPostCurrFile2(BSTR strName) 功 能:(保留) 参 数: 返回值: 示 例:

2.1.32 HttpPost 原 型: BSTR HttpPost(BSTR strHttpURL);

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

strHttpURL: 处理表单和文件数据的文件URL路径 返回值: Succeed:上传成功 failed: 上传失败 示 例: //相对路径

var returnValue=document.all.WebOffice1.HttpPost(\//绝对路径 var

returnValue=document.all.WebOffice1.HttpPost(\)

2.1.33 InsertFile 原 形:short InsertFile(LPCTSTR strFilePathName, short nCurPos) 功 能:插入合并文件,和插入图片。 参 数:strFilePathName:

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

位置和图片控制符。nCurPos 或者nCurPos -8 0: 当前位置

1: 文件开头 2: 文件末尾

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

返回值:

0:正确 其他:错误 示 例: //文件头部

document.all.WebOffice1.InSertFile(\//文件尾部

document.all.WebOffice1.InSertFile(\//当前光标位置

document.all.WebOffice1.InSertFile(\//文件头部

document.all.WebOffice1.InSertFile(\//文件尾部

document.all.WebOffice1.InSertFile(\//当前光标位置

document.all.WebOffice1.InSertFile(\

2.1.34 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.35 IsSaved 原 型: long IsSaved(); 功 能:判断文件是否被修改 参 数: 返回值:

0:文件已被修改 非零:文件未被修改

示 例:

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

2.1.36 InsertFile 原 型: long InsertFile(BSTR strFilePathName, short nCurPos); 功 能:插入、合并文件或插入图片 参 数:

strFilePathName:文件或者图片的路径,可以是Http.或者Ftp路径 nCurPos:位置和图片控制符。nCurPos 或者nCurPos -8 0: 当前位置 1: 文件开头

2: 文件末尾

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

0:插入成功 非0:插入失败

示 例: //文件头部

document.all.WebOffice1.InSertFile(\//文件尾部

document.all.WebOffice1.InSertFile(\//当前光标位置

document.all.WebOffice1.InSertFile(\//文件头部

document.all.WebOffice1.InSertFile(\//文件尾部

document.all.WebOffice1.InSertFile(\//当前光标位置

document.all.WebOffice1.InSertFile(\

2.1.37 LoadOriginalFile 原 型: long LoadOriginalFile(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(\id=8\

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

document.all.WebOffice1.LoadOriginalFile(\document.all.WebOffice1.LoadOriginalFile(\// 新建Excel

document.all.WebOffice1.LoadOriginalFile(\// 通过Word打开本地文件

document.all.WebOffice1.LoadOriginalFile(\

2.1.38 OpenFileDlg 原 型: short OpenFileDlg();

功 能:打开本地文件显示在WebOffice中 参 数:pcFileNameOrUrl:保存的文件路径 返回值: 示 例: //打开对话框

document.all.WebOffice1.OpenFileDlg();

2.1.39 ProtectDoc 原 型: long ProtectDoc(long lProOrUn, long lType, BSTR strPWD); 功 能:文档保护

参 数:

lProOrUn:

└ 1:为保护文档 └ 0:为解锁文档 lType :

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

└ 2 :文档完全保护,不允许任何操作 strPWD:文档保护、解锁时所需设置的密码

返回值: 示 例:

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

document.all.WebOffice1.ProtectDoc(1, 0, \// 解锁文档

document.all.WebOffice1.ProtectDoc(0, 0, \

2.1.40 PrintDoc 原 型: long PrintDoc(long blShowDlg); 功 能:打印当前文档 参 数:blShowDlg:

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

非零:显示打印对话框 返回值:

0:打印失败

非零:打印成功 示 例:

//显示打印对话框

document.all.WebOffice1.PrintDoc(1);

2.1.41 PutSaved 原 型: long PutSaved(boolean bSaved); 功 能:设置当前文档的修改状态 参 数:

0: 处于修改状态 1: 处于保存状态 返回值: 示 例:

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

document.all.WebOffice1.PutSaved(0);

2.1.42 ReplaceText 原 型: short ReplaceText(LPCTSTR strSearchText, LPCTSTR strReplaceText, long lGradation)

功 能:替换文字 参 数:

strSearchText: 待替换的文字

strReplaceText:替换后的文字

lGradation:替换方向。1:向下替换;0:向上替换; 返回值: 示 例:

//把“1”替换为”2”

document.all.WebOffice1.ReplaceText(\

2.1.43 Save 原 型: long Save(); 功 能:

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

参 数: 返回值:

0:保存失败

非零:保存成功 示 例:

document.all.WebOffice1.Save();

2.1.44 SaveTo 原 型: long SaveTo(BSTR pcFileNameOrUrl); 功 能:将文件另存为至其它位置 参 数:

pcFileNameOrUrl:保存的文件路径

返回值:

0:保存失败

非零:保存成功 示 例:

//将文件另存为

document.all.WebOffice1.SaveTo(“c:\\\\webOffice.doc”);

2.1.45 SaveAs 原 型: long SaveAs(BSTR strFileName, long dwFileFormat); 功 能:保存文件到本地

参 数:

strFileName: 要保存的文件路径和文件名 dwFileFormat:保存的文件类型 └ 0 Word类型 └ 2 Txt文件 └ 6 Rtf文件

└ -4143 Excel类型

返回值: 示 例:

document.all.WebOffice1.SaveAs(\ 文件

document.all.WebOffice1.SaveAs(\ 文件

document.all.WebOffice1.SaveAs(\ 文件

document.all.WebOffice1.SaveAs(\文件

// 另存为Word// 另存为Txt// 另存为Rtf// 另存为Excel

2.1.46 SaveAsPDF 原 型: long SaveAsPDF(LPCTSTR strOriFilePath, LPCTSTR strSaveFilePath, long lType)

功 能:保存文件为PDF格式,本地不需要安装Adobe软件。需要下载PDF支持模块。

参 数:

strOriFilePath: 本地文件路径,如果为空,则表示为当前打开的文件 strSaveFilePath:保存的PDF文件格式,如果需要把此文件上传到服务器,请参照 HttpAddPostFile接口 lType:保留参数,传0即可。

返回值:

0:成功 其他:失败

示 例:

document.all.WebOffice1.SaveAsPDF(\ document.all.WebOffice1.SaveAsPDF(\

2.1.47 SetFieldValue 原 型: long SetFieldValue(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赋值

document.all.WebOffice1.SetFieldValue(\电子签章\// 套本地红头

document.all.WebOffice1.SetFieldValue(\\

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

document.all.WebOffice1.SetFieldValue(\\

// 套服务端红头2

document.all.WebOffice1.SetFieldValue(\oc\

//添加图片电子印章

document.all.WebOffice1.SetFieldValue(\mp\

//在Excel中添加图片

document.all.WebOffice1.SetFieldValue(\ntl/zh-CN/images/logo_cn.gif\

2.1.48 SetPageAs 原 型: long SetPageAs(LPCTSTR strLocalFile, long lPageNum, long lType) 功 能:把某一页的文档保存为doc,html,text,bmp,jpg 参 数:

strLocalFile:待保存的文件路径 lPageNum:第几页

lType:文件类型 0:doc (其他暂没支持,下个版本扩展) 返回值: 示 例:

//把第一页保存为独立的doc文件

document.all.WebOffice1. SetPageAs(\

2.1.49 SetTrackRevisions 原 型: long SetTrackRevisions(long lValue); 功 能:修订文档 参 数:

lValue:文档修订状态

└ 1: 开始修订文档 └ 0: 进入非留痕状态 └ 4:接受当前修订 返回值: 示 例: // 开始修订

document.all.WebOffice1.SetTrackRevisions(1); // 接受修订

document.all.WebOffice1.SetTrackRevisions(4);

2.1.50 ShowRevisions 原 型: long ShowRevisions(long nNewValue); 功 能:显示、隐藏修订 参 数:

nNewValue:要保存的文件路径和文件名 └ 1:显示修订 └ 0:隐藏修订 返回值: 示例:

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

2.1.51 SetCurrUserName 原 型: long SetCurrUserName(BSTR strCurrUserName);

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

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

示 例:document.all.WebOffice1.SetCurrUserName(\张三\

2.1.52 SetToolBarButton2 原 型: short SetToolBarButton2(VARIANT lIndex, VARIANT lID, VARIANT lControl);

功 能:

设置所有菜单项或者菜单项按钮的隐藏和现实

参 数:

lIndex:要显示隐藏的元素名称。根据Word/Excel 的不同版本,可能有部分不同

└ Standard:常用工具条 └ Formatting:格式化工具条 └ Menu Bar:菜单栏

当lIndex为0的时候,lID代表的是按钮的ID数值,关于各按钮的ID值,请参照附件。

lID:要操作的菜单元素的位置

lControl:按钮状态控制,按位控制,如该值为1时,它的二进制为0001,

表示该菜单元素是显示但不可用

第一位为:是否显示。0:隐藏;1:显示 第二位为:是否可用。0:不可用;1:可用。 第三位为:工具栏和菜单栏是否恢复到默认状态。0:不恢复;1:恢复。

第四位为:是否隐藏整个菜单栏或工具栏,1为隐藏,0为显示

返回值: 示 例:

// 常用工具栏上的新建按钮 显示但不可用

document.all. WebOffice1.SetToolBarButton2(\// 常用工具栏上的打开按钮 隐藏。

Docume.nt.all. WebOffice1.SetToolBarButton2(\// 恢复常用工具栏为初始状态

document.all. WebOffice1.SetToolBarButton2(\// 格式工具栏上的格式按钮 显示但不可用

document.all. WebOffice1.SetToolBarButton2(\// 恢复格式工具栏为初始状态

document.all. WebOffice1.SetToolBarButton2(\// 菜单栏文件选项,显示但不可用。

document.all.WebOffice1.SetToolBarButton2(\// 菜单栏文件选项,显示但不可用。

document.all.WebOffice1.SetToolBarButton2(\

// 隐藏整个菜单栏(如果需要隐藏之后再显示,请设置第三个参数为11) document.all.WebOffice1.SetToolBarButton2(\

// 隐藏整个格式工具栏(如果需要隐藏之后再显示,请设置第三个参数为11) document.all.WebOffice1.SetToolBarButton2(\

// 隐藏整个常用工具栏(如果需要隐藏之后再显示,请设置第三个参数为11) document.all.WebOffice1.SetToolBarButton2(\

2.1.53 SetCurrTime 原 型: short SetCurrTime(BSTR dateAndTime);

功 能:设置客户端的修订时间,防止客户端和服务端的时间误差 参 数:

dateAndTime:参数的形式必须为 yyyy-mm-dd hh-mm-ss的形式

返回值: 示 例:

document.all.WebOffice1.SetCurrTime(\

2.1.54 SetKeyCtrl

原 型: long SetKeyCtrl(long lCtrl, long lChar, long lType); 功 能:屏蔽、运行Office的快捷键 参 数:

lCtrl:要屏蔽、运行的快捷键的值。

Ctrl=512 Shift=256 Alt=1024

例:Ctrl + S = 512 + 83 (大写S的ASCII码值) = 595 例:Ctrl + O = 512 + 79 = 591

例:Ctrl + Shift + E = 512 + 256 + 69 = 837

注意:字母使用大写的ASCII码值 lChar:控制类型

└ -1:屏蔽快捷键 └ 1:执行快捷键命令 └ 0:恢复快捷键

└ lTyp:扩展接口,目前暂设为0

返回值: 示 例:

//屏蔽Ctrl + S

document.all.WebOffice1.SetKeyCtrl(595,-1,0) //屏蔽Ctrl + O

document.all.WebOffice1.SetKeyCtrl(591,-1,0)

2.1.55 SetSecurity 原 型: long SetSecurity(long lFlag) 功 能:

设置文档安全选项 参 数:

lFlag:按位标记的控制开关。

0x01表示不允许打印(当第一位为1时有效) 0x02表示不允许保存(当第二位为1时有效)

0x04表示不允许复制(当第三位为1时有效) 0x08表示不允许拖动(当第四位为1时有效) 0x8000表示清除开关(当最高位为1时有效)

返回值: 示 例: //禁止打印

Object.SetSecurity(0x01); //恢复允许打印

Object.SetSecurity(0x01 + 0x8000); //禁止保存

Object.SetSecurity(0x02); //恢复允许保存

Object.SetSecurity(0x02 + 0x8000); //禁止复制

Object.SetSecurity(0x04); //恢复允许复制

Object.SetSecurity(0x04 + 0x8000); //禁止打印、保存、复制

Object.SetSecurity(0x01+0x02+0x04); //恢复允许打印、保存、复制

Object.SetSecurity(0x01+0x02+0x04+0x8000);

2.1.56 ShowDialog 原 型: long ShowDialog(long dwIndex); 功 能:

显示对话框 参 数:

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

2.1.57 SetValue 原 形:short SetValue(LPCTSTR strValue, LPCTSTR strName)

功 能:设置Word、Excel文档基本信息,目前仅支持 只读和可写密码 参 数:strValue:设置的基本信息的数值

strName:基本信息的标识,如只读密码的标识为\可改密码的标识为\

返回值:

0:正确设置

-1:不支持此命令,请确定您的第二个参数为正确。 示 例:

//设置当前文档的打开密码为”password”

document.all.WebOffice1.SetValue(\

//设置当前文档的可写密码为”password”

document.all.WebOffice1.SetValue(\

2.1.58 SetDocVariable 原 形:short SetDocVariable(LPCTSTR strVarName, LPCTSTR strValue, long lOpt)

功 能:设置Word中的变量的值,更可以更新与此变量相关联的域。 参 数:strVarName 变量名称 strValue

变量设置的数值 lOpt

一个按位操作的数字位, 第一位为1: 表示update域关联的

第二位为1: 表示如果没有这个变量则添加

返回值:

1:正确设置 0:错误 示 例:

//设置变量 DocName的值为\文档名称\,如不存在DocName的变量则返回 document.all.WebOffice1.SetDocVariable(\文档名称\

//设置变量 DocName的值为\文档名称\,如不存在DocName的变量则添加 document.all.WebOffice1.SetDocVariable(\文档名称\

//设置变量 DocName的值为\文档名称\,并更新DocName所关联的域 document.all.WebOffice1.SetDocVariable(\文档名称\

2.1.59 UnProtectDoc(BSTR strPwd) 原 型: long UnProtectDoc(BSTR strPwd); 功 能:解除当前文档保护

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

0:解锁成功

非零:解锁失败

示 例:

document.all.WebOffice1.UnProtectDoc(\

2.1.60 ZipFile 原 型: short ZipFile(BSTR cSourceFile, BSTR cAimFile,long wFileType,long bEnc);

功 能: 压缩文档(保留) 参 数: 返回值: 示 例:

2.1.61 GetBMPos 原 型: long GetBMPos(LPCTSTR strBMName, short lPosType) 功 能:获取bookmark的位置 参 数:

Strbmname 书签名

lPosType = 0 表示bookmark的start lPosType = 1 表示bookmark的end 返回值:书签位置 示 例:

var v1 = document.all.WebOffice1.GetBMPos(\var v2 = document.all.WebOffice1.GetBMPos(\

2.1.62 LocalProtect 原 型: long LocalProtect(LPCTSTR strPosList, LPCTSTR strPWD, LPCTSTR strFuture) 功 能:设置局部保护 参 数:

strPosList 的样式为:0-111,222-999,1223-8888 strPWD 保护密码

strFuture 设为空即可 示 例:

var v1 = document.all.WebOffice1.GetBMPos(\var v2 = document.all.WebOffice1.GetBMPos(\var v = \

document.all.WebOffice1.LocalProtect(v, \

2.1.63 UnActiveExcel() 原 型: void UnActiveExcel()

功 能:Excel 退出编辑状态,在编辑状态的时候无法调用VBA 示 例:

document.all.WebOffice1.UnActiveExcel();

2.1.64 HideMenuArea 原 型: long HideMenuArea(LPCTSTR pcExcludeBar1, LPCTSTR pcExcludeBar2, LPCTSTR pcExcludeBar3, LPCTSTR pcExcludeBar4)

功 能:1.《2003屏蔽所有的菜单,除了参数的4个菜单。

2.《2007 功能区隐藏。当 pcExcludeBar1= \功能区显示,否则隐藏 示 例:

//隐藏2003所有菜单

document.all.WebOffice1.HideMenuArea(“”,””,””,””); //显示菜单栏和常用工具栏

document.all.WebOffice1.HideMenuArea(“Menu Bar”,”Standard”,””,””); //隐藏2007功能区

document.all.WebOffice1.HideMenuArea(“”,””,””,””); //显示2007功能区

document.all.WebOffice1.HideMenuArea(“show”,””,””,””); //隐藏2007全部菜单

document.all.WebOffice1.HideMenuArea(“hideall”,””,””,””); //显示2007全部菜单

document.all.WebOffice1.HideMenuArea(“showmenu”,””,””,””);

2.1.65 SetCustomColour 原 型: void SetCustomColour(long lType, long lColour) 功 能:自定义工具栏皮肤 参 数:lType: 设置肤色

custColorToolBarBKColor = 0, 底色

custColorToolBarMiddleColor = 1, 中间色 custColorToolBarTopColor = 2, 上色 custColorToolBarBottomColor = 3, 下色 lColour: 为颜色值 0-65535 已经有的三个模式

m_colCustom[custColorToolBarTopColor] = RGB(243, 244, 250); m_colCustom[custColorToolBarMiddleColor] = RGB(225, 226, 236);

m_colCustom[custColorToolBarBottomColor] = RGB(153, 151, 181); m_colCustom[custColorToolBarBKColor] = RGB(243, 243, 247);

m_colCustom[custColorToolBarTopColor] = RGB(131, 97, 59);

m_colCustom[custColorToolBarMiddleColor] = RGB(239, 216, 138); m_colCustom[custColorToolBarBottomColor] = RGB(133, 94, 53); m_colCustom[custColorToolBarBKColor] = RGB(130, 92, 52);

m_colCustom[custColorToolBarTopColor] = RGB(220, 235, 254); m_colCustom[custColorToolBarMiddleColor] = RGB(196, 219, 249); m_colCustom[custColorToolBarBottomColor] = RGB(136, 174, 228); m_colCustom[custColorToolBarBKColor] = RGB(191, 214, 249);

示 例:

//设置皮肤为第一种模式,温馨浪漫

document.all.WebOffice1.SetCustomColour(2,250*256*256+244*256+243);

document.all.WebOffice1.SetCustomColour(1,236*256*256+226*256+225);

document.all.WebOffice1.SetCustomColour(3,181*256*256+151*256+153);

document.all.WebOffice1.SetCustomColour(0,247*256*256+243*256+243);

2.1.66 SetCustomToolBtn 原 型: long SetCustomToolBtn(long lIndex, LPCTSTR pcBtnText) 功 能:自定义工具栏,添加工具栏按钮 参 数:

lIndex:内置按钮索引,

pcBtnText:设置自定义菜单的文字信息 系统内置了 5 个按钮。

SetCustomToolBtn(0,\SetCustomToolBtn(1,\SetCustomToolBtn(2,\SetCustomToolBtn(3,\SetCustomToolBtn(4,\

2.1.67 GetFileBase64 原 型: BSTR GetFileBase64(BSTR strFilePath, long dwExt) 功 能:获取文件的base64 参 数:

strFilePath:文件路径 为空字符表示当前文档的base64, dwExt:0 示 例:

document.all.WebOffice1. GetFileBase64(\

2.1.68 SaveBinaryFileFromBase64 原 型: long SaveBinaryFileFromBase64(BSTR strFilePath, BSTR strBase64) 功 能:把base64的文件保存为二进制的数据,其中 strfilepath必须是临时文件。 参 数:

strFilePath:文件路径,通常为GetTempFilePath的返回值 strBase64:文件的base64值,通常为GetFileBase64返回值。 示 例:

var tempPath=document.all.WebOffice1.GetTempFilePath();//获取临时文件路径 var v=document.all.WebOffice1.GetFileBase64(\获取当前文档base64值 document.all.WebOffice1.SaveBinaryFileFromBase64(tempPath,v);

2.1.69 SetWindowText 原 型: long SetWindowText(LPCTSTR strText, long nType)

功 能:在weboffice工具栏显示版权等信息,在上传的进度条上设置信息

设置提示信息 (在控件初始化时候调用,字符串大小不得大于128字节)

参 数:

strText:文字内容

nType:0: 工具栏授权信息

1:上传进度条开始提示信息 2: 上传进度条结束提示信息

示 例:

document.all.WebOffice1.SetWindowText(“WebOffice正式版本”, 0);

2.1.70 GetOcxVersion 原 型: long GetOcxVersion () 功 能:获取ocx控件的版本号 返回值:文档版本号 示 例:

alert(document.all.WebOffice1.GetOcxVersion());

2.2 属性

2.2.1

DocType 原 型: long DocType; 说 明:文件类型,只读 数 值:

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 原 型: BSTR Version;

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

2.2.3 AppVersion 原 型: BSTR Version;

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

2.2.4 lEventRet 原 型: BOOL LEventRet;

说 明:见事件 NotifyToolBarClick事件 数 值:

2.2.5 IsModify 原 型: BOOL IsModify;

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

2.2.6 ShowToolBar 原 型: BOOL ShowToolBar; 说 明:是否显示工具栏。 数 值: 1:显示工具栏 ;

0:隐藏工具栏

2.2.7 OptionFlag 原 型: long OptionFlag;

说 明:系统标志位,可读写。此属性比较重要,可以作为各种控制开关。 数 值:

OPTIONFLAG_WORD_07SAVETO03 0x0001(Office2007保存为兼容格式) OPTIONFLAG_EXCEL_07SAVETO03 0x0002(Office2007保存为兼容格式) OPTIONFLAG_HTTPSAVEENC 0x0004(HttpPost时候文件加密压缩) OPTIONFLAG_SETFILEDVALUE 0x0008(书签操作后删除盖书签) OPTIONFLAG_NODELWORDNORMAL 0x0010(清除Word的模板文件)

OPTIONFLAG_NOENCOUDEURL 0x0020(设置URL的是否UTF8编码) OPTIONFLAG_SHOWPRESS 0x0080(是否显示进度条) OPTIONFLAG_DOCSHA1 0x0400(设置此项则IsModify有效) 示 例:

//1.调用LoadOriginalFile打开URL上路径的时候 // 如果对URL进行UTF8编码就调用 Obj.OptionFlag |= 0x0020;

// 如果不对URL编码调用下面这句(默认) Obj.OptionFlag &= 0xffdf;

Obj.LoadOriginalFile(\//2.在上传和下载的时候

//调用下面语句,则显示进度条: Obj.OptionFlag |= 0x0080;

//调用下面语句,则不显示进度条(默认): Obj.OptionFlag &= 0xff7f;

//3.在上传时候设置是否对文件加密和压缩 //调用下面语句,则对文件加密和压缩: Obj.OptionFlag |= 0x0004;

//调用下面语句,则不对文件加密和压缩(默认):

Obj.OptionFlag &= 0xfffc;

2.2.8 Is2007 原 型: long Is2007;

功 能:判断是否Office2007,只读 参 数: 返回值:

1:是2007版本 0:不是2007版本 示 例:

//判断当前Office是不是2007版本 document.all.WebOffice1. Is2007();

2.2.9 lContinue 原 型: long lContinue;

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

1:可以继续执行(默认) 0:终止默认操作 示 例:

//禁止关闭当前的Word/Excel/Wps文档 OnNotifyWordEvent(BSTR strEventName) {

if(strEventName == “DocumentBeforeClose”) {

lContinue = 0; } }

2.3 事件

2.3.1

NotifyWordEvent 原 型: void NotifyWordEvent(BSTR strEventName); 说 明:捕获部分Word/Excel/Wps事件。

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

DocumentChange

DocumentBeforeClose DocumentBeforePrint DocumentBeforeSave

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

2.3.2 NotifyCtrlReady 原 型: void NotifyCtrlReady();

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

2.3.3 NotifyToolBarClick 原 型: void NotifyToolBarClick(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

说 明:

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

以下实例截获了SAVEAS的按钮事件。 //1. 定义事件处理函数

//2. 截获处理事件

function WebOffice1_NotifyToolBarClick(lCmd) { if(32772==lCmd) {

document.all.WebOffice1.lEventRet = 0; } }

三、ASP例子说明

3.1 Access数据库结构

表doc

======================================== id 自动编号 DocID 文本(10) DocTitle 文本(10) DocType 文本(15) DocData 日期/时间 DocContent OLE 对象

======================================== 说明:DocContent为上传的Office文档的数据,为二进制数据类型,如果使用SQLServer请改为Image类型。

3.2 演示程序主要页面说明

config.asp 取得服务器的项目文件目录,赋值给Application对象,供接口调用 docEidt.asp 调用weboffice控件在线编辑word,并提交给savedoc.jsp页面上传保存word文档

saveDoc.asp 保存表单元素和上传的word文件

getDoc.asp 取得数据库中的记录并返回给调用它的页面 debug.htm 用于调试数据传送到saveDoc.asp页 template 用于存放红头文件的模板

3.3 开发必读

1) 调用控件的时候尽量在控件ID前加“document.all”,如:

document.all.WebOffice1

2) Javascirpt区分大小写,使用时请注意。 3) WebOffice控件为VC++6编写,控件的所有方法和参数区分大小写,请严格参考本手册。 4) 在本控件的演示程序中,有个debug.hml文件用于测试表单元素和文件上传。

四、FAQ

4.1 如何把文件直接上传到服务器

WebOffice通过Http协议实现文件直接上传到服务器,原理见附件一《WebOffice文件Http上传原理》

五、附录

5.1 WebOffice文件Http上传原理

WebOffice文件Http上传原理分析 WebOffice控件使用了自身的文件Http上传接口实现文件和表单域的上传保存,本文将简要介绍该上传方式的原理和使用方法。注: WebOffice的上传接口和AIP是一致的。 原理 因为Web页面上的WebOffice打开的文件无法随表单记录提交到处理页面,所以我们把文件模拟成表单的文件域,通过接口把文件和表单元素发送到保存记录的页面(过程类似表单的提交)。 主要上传接口: ? HttpInit(); 该方法用于初始化上传接口,不需要设置参数 ? HttpAddPostString(String FieldName, String someValue); 添加要提交的表单域, FieldName是要上传表单域名称,someValue是表单域值 例一: HttpAddPostString(\它类似域表单域的 例二: HttpAddPostString(\ ….

注意:如果使用上传接口,那么form表单里的表单域不会被提交到处理页面。需要手工添加到上传接口(HttpAddPostString接口),然后通过控件发送到处理页面。例二使用了“WebForm.username.value”获取表单域值。 ? HttpAddPostCurrFile(String fileName, String ReName); 添加当前WebOffice编辑的文件给上传接口,该接口把文件模拟到成一个表单的文件域,并提交到处理页面。 例一: HttpAddPostCurrFile(\该接口模拟表单文件域如下:

注意:第二个参数为空表示控件自动为文件命名,如:dj_temp.aip,如果需要重命名可以在第二个参数指明文件名称,也可在保存页面指定文件名称。 ? 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(\// 添加上传文件 document.all.WebOffice1.HttpAddPostCurrFile(\// 提交上传文件 returnValue = document.all.WebOffice1.HttpPost(\if(\ } alert(\文件上传成功\alert(\文件上传失败\ } else { 关于保存 WebOffice上传接口将数据流以Http方式提交到保存页面,至于对数据处理就和普通的文件上传处理一样了,具体代码参考附件(asp和jsp的实现)。