【计算机】DSOFRAMER.OCX使用指南（共53页）

1、在 web 中使用 office 文档！ ntko office 文档控件开发接口 参考v3.0 build 3,0,0,8 更新时间：2005 年 05 月 30 日 开开发发接接口口 千航网络【ntko software】 电子邮件： web： tel-faxcopyright 2003-2005，by liulingxun all rights reserved 版权所有：千航网络 保留所有权利 未经许可,请勿分发本文档的部分或全部 目目录录 第第1章章 软件最终用户许可协议 重要须知 请认真阅读：本 最终用户许可协议（以下称 协议 ） 是您（个人或单一实体）

2、与 我们之间有关ntko office 文档控件软件产品的 法律协议。本 “软件产品 ”包括计算机软件，并可能包括相关媒体、印刷材料， 和“联机 ”或电子文档（ “软件产品 ”）。本 “软件产品 ”还包括对我们提供 给您的原 “软件产品 ”的任何更新和补充资料。任何与本“软件产品 ”一同 提供给您的并与单独一份最终用户许可证相关的软件产品是根据那份许可协议中的 条款而授予您。您一旦安装、复制、下载、访问或以其它方式使用“软件产 品”，即表示您同意接受本协议 各项条款的约束。如您不同意本协议 中的条款，请不要安装或使用“软件产品 ”； ntko office 文档控件是受版权保护的。如果您得到的

3、是未注册版本，您还 没有获得运行授权。请在测试完成之后从您的机器中删除。如果您得到的是注册版 本，您可以在授权协议许可的范围内使用本软件。 您不能分发，销售，以及非法破解本软件。也不能超出协议许可的范围使用本 软件。否则，将被视为侵犯了我们的知识产权。 对反向工程 (reverse engineering)、反向编译 (decompilation)、反汇 编 (disassembly) 的限制。您不得对本“软件产品 ”进行反向工程、反向编 译 (decompile) 或反汇编 (disassemble)，但尽管有这项限制，如适用法律明 示允许上述活动，则不在此限。另外，我们不对您在使用此软件的

4、过程中对您的机 器或者数据造成的损失负责。 第第2章章 功能介绍（ features） 1、 功能简介 使用 ntko office 文档控件，能够在浏览器窗口中直接编辑word,excel 等 office 文档并保存到web 服务器。实现文档和电子表格的统一管理。同时支 持痕迹保留，手写签名，电子盖章等办公自动化系统必备的功能。是oa 系 统开发的最佳选择组件！卓越的性能，低廉的价格，标准高效的编程接口，让您以 最低的开发成本，轻松创建极具特色的解决方案！ 它能够将编辑过的office 文档直接保存到web 服务器；支持在线编辑包 括 microsoft word，excel 以及 pow

5、erpoint 在内的所有office 文档类型；支 持各种后台web 服务器和编程语言。并且可以在浏览器中通过jscript 或者 vbscript 使用控件提供的属性和方法控制文档操作。 2、 3.0 版本的新功能 ntko office 文档控件 3.0 版本在已有强大功能的基础上，新增了文档电 子签名 【数字签名 】的功能。同时简化了一些常用功能的函数和方法。 ntko office 文档控件 3.0 版本的数字签名功能基于国际标准开发，同时符合 国家即将实施生效的电子签名法 。使用电子签名 【数字签名 】，可以验 证对文档内容，格式等的任何改动。同时支持联合签名，证书吊销列表等功能。

6、另 外， ntko office 文档控件 3.0 版本还支持数字签名的信任程度显示。数字签 名可以区分为完全可信，基本可信，或者不可信。 电子签名 【数字签名 】功能采用标准接口，可以和企业已有的pki 系统 无缝融合。 3、 详细功能列表 新增电子签名【数字签名】 的功能。 v3.0 版本新增了文档电子签名【数字签名】的功能。 同时简化了一些常用功能的函数和方法。ntko office 文档控件 3.0 版本的数字签名功能基于国际 标准开发，同时符合国家即将实施生效的电子签 名法。使用电子签名【数字签名】，可以验证对 文档内容，格式等的任何改动。同时支持联合签名， 证书吊销列表等功能。电子

7、签名【数字签名】功能 采用标准接口，可以和企业已有的 pki 系统无缝融 合。 新增可定制得文件菜单，可 定制一个主菜单，禁止 f12 保存，可显示页码，页数信 息得状态栏。 v 版本新增了可定制文件菜单，可定制一个主 菜单。进一步增强了系统得可集成性。新增得禁止 f12 快捷键保存文档，以及在禁止拷贝得基础上禁 止拖放文字得功能，进一步增强了文件得安全性。 新得状态栏可以显示 word 文档得页码和页数等信 息。用户使用更加方便。 新增压缩传输接口，定制菜 单栏颜色 v 版本新增了定制菜单栏颜色的接口，以及使 用压缩方式保存和打开服务器文件的功能。对于一 般 19

8、k 左右的新 word 文档，压缩后只有 2k 左右。 大大提高了存储效率。 新增了全文批注（全屏批注） 和定位批注签名的功能。 v 版本在已有强大功能的基础上，新增了全文 批注（全屏批注）和定位批注签名的功能。能够采 用所见所得的方式在屏幕上进行批注，并插入到屏 幕所在位置。新版本还支持屏幕位置插入签名，光 标位置插入签名，以及签名缩放等功能。 全面支持 c/s 方式和其他容 器。在 vb,delphi,c+builder 中均可以很方便的使用控件 v2,3,2,0 版本之后，ntko office 文档控件不仅可 以继续与浏览器和各种后台 web 服务器无缝集成创 建 b/s

9、 结构的应用，更全面支持 c/s 方式的编程和 其他容器。您可以在 vb,delphi,以及 c+ builder 中 使用控件。快速创建具有痕迹保留，电子印章等功 能的 c/s 结构的应用。 支持将数据直接写入 odbc 数据源。 v2,3,2,0 版本之后，ntko office 文档控件支持直 接从 odbc 数据源读取文档内容，或者将文档内容 存入 odbc 数据源。这为 c/s 结构下创建共享的办 公系统，文档管理，知识管理解决方案提供了更强 大的接口。 状态栏,智能 web 调用,预定义 模板套红 ntko office 文档控件 2.2 版本全面支持状态栏， 用户界面更加友好。智

10、能 web 让您甚至可使用 xml 或者自定义的协议和服务器通讯! 广泛的操作系统，web 服务 器，数据库和编程语言支持 后台支持 windows,linux,unix 等各种操作系统；支 持 iis，domino，websphere，apache 等所有后台 web 服务器类型，支持 db2，oracle，mysql，sql server 等各种常用数据 库和 jsp，asp，php，perl 等编程语言。 支持在提交编辑文档的同时， 提交表单的其它数据，包括 其它的文件上传 采用我们独创的“智能提交”技术，让您在提交编辑 文档的同时，提交表单的其它数据，以及表单中其 它的文件上传。这可以

11、让您更加快速的集成现有的 应用程序，或者创建新的应用程序。 支持所有的 office 菜单 完全符合用户习惯，用户操作更加轻松，尤其是复 杂的表格操作，和在 office 中操作完全一致，大大 节约开发成本；而且菜单项目可以通过 javascript 来 控制允许或者禁止。 支持发布为 html 发布为 html 的功能，可以让您将在线编辑的文档 （word,excel）以 html 的方式发布到 web 服 务器。让没有安装控件的用户也能够方便的查看文 档。 支持将 html 及其相关文件 直接发布到 domino 文档 可以将 html 文件及其相关文件直接作为附件发布 到 domino

12、的文档中。 版本控制功能 版本控制功能，能够让您对 word 和 excel 文档 有更多的控制。 支持强制痕迹保留 可以通过对控件编程，让用户只能在痕迹保留状态 下工作；强制用户保留一切编辑痕迹。 支持手写签名和加密的电子 印章 支持使用我们的工具制作加密的电子印章，可将印 章放入 u 盘等硬件设备。高强度的单向加密算法保 证只有拥有正确的口令才能够恢复出印章的数据。 只有单向加密才能保证不能从印章文件恢复出口令。 无需后台配置,即可支持 lotus domino 可与 lotus domino 服务器天然集成。domino 服务 器无需安装 java，或其它任何组件。降低系统部署 的难度。

13、同时能够将已有的复杂应用迅速转换到使 用控件的应用。降低开发成本，节约开发时间。 基于标准协议，无任何自定 义数据格式，通用性好 基于标准协议的开发，使得合作伙伴无须担心技术 的进步带来后续维护和开发风险。 支持从本地或服务器 url 获 取加密的电子印章 支持从本地和服务器将电子印章加入到 office 文档。 支持从服务器 url 或本地直 接插入透明浮动图片到 word，excel 文档 新增加的 addpicfromurl 和 addpicfromlocal 函数 可以直接从 url 或本地插入透明的浮动图片到 office 文档 支持将手工绘制的图片作为 透明浮动的图片增加到 wor

14、d，excel 文档 新增加的 dohanddraw 函数可以将您不期而至的灵 感迅速转化成图片放到 word 或者 excel 文档中。 全面支持 office2000 的打印预 览 增强了对 office2000 的打印预览支持，支持全部 office2000 系统的打印预览。另外支持 officexp 和 office2003 中 excel 的打印预览。 轻量级，只有不足 60k 使用 c 语言直接开发 com 接口，简洁高效，对内 核函数的直接调用使得无需其它动态链接库的支持， 兼容性极好！ 在下载和上载 office 文档时 不会产生临时文件 使用流数据作为 office 文档的数

15、据源，不会产生临 时文件。因此不会引起防病毒软件如 norton antivirus 的错误警告。 能够禁止用户从文档拷贝数 据 isnocopy 属性可以禁止用户从 office 文档中拷贝数 据。 支持简洁高效的编程接口 可使用 javascript 和 vbscript 对控件进行编程。可以 完全控制 office 文档。 支持 http 协议，https over ssl 协议 对 https 协议的支持使得可以创建更加安全的应 用。并且自动支持 session cookie。使用当前页面的 session cookie 和服务器进行交互。 支持各种手写笔录入，签名， 绘图/批注 支持

16、键盘录入，各种手写笔（汉王、蒙恬、联想） 录入方式和使用手写笔手写签名，手工绘图/批注 使用 ntko office 文档控件，可以大大缩短整个系统的开发时间，降低系统 的开发成本，提高产品的质量和用户体验。 4、 需要的软件 正确运行本控件需要客户机安装windows98 及以上操作系统，internet explorer 5.0 及以上版本，以及正确安装microsoft office 97 以上版本。 5、 支持的web 服务器 支持所有的支持http/1.1 标准的 web 服务器。 6、 html object 标识符 第第3章章 主要属性参考 3.1、 一般界面相关一般界面相关 1

17、、 statusbar statusbar：布尔型。读写。是否显示状态栏。 2、 caption caption：标题栏的左边的标题，可读写； 设置： obj.caption = “欢迎使用 ” 3、 backcolor，forecolor backcolor：背景颜色；可读写；缺省值：系统窗口背景颜； forecolor：前景颜色；可读写；缺省值：系统窗口字体颜色； 设置： obj.backcolor = ole_color 说明： ole_color 是一个 bgr (blue, green, red)数值。 bgr value = (blue * 65536) + (green * 25

18、6) + red 4、 bordercolor bordercolor：边框颜色，可读写；缺省值：系统按钮颜色； 设置： obj.bordercolor= ole_color 说明： ole_color 是一个 bgr (blue, green, red)数值。 bgr value = (blue * 65536) + (green * 256) + red 5、 titlebarcolor，titlebartextcolor titlebarcolor：标题框颜色，可读写；缺省值：系统按钮颜色； titlebartextcolor：标题框文本颜色，可读写；缺省值：系统焦点按钮颜色； 6、 t

19、itlebar titlebar：显示 /隐藏标题栏，可读写; 读取： varbool = titlebar; 设置： titlebar = true | false 7、 borderstyle borderstyle：边框属性，可读写； 设置： obj.borderstyle = 0|1|2|3 0：无边框 1：平面边框 2：3d 边框 3：3d 窄边框 读取： var = obj.borderstyle 缺省值：1 3.2、 工具栏相关属性工具栏相关属性 1、 toolbars toolbars：显示 /隐藏工具栏，可读写; 设置： titlebars = true | false 2、

20、 isresettoolbarsonopen isresettoolbarsonopen：读取 /设置是否在打开文档之后重置工具栏为常 用模式。 3.3、 菜单控制相关属性菜单控制相关属性 1、 menubar menubar：布尔型。读写。是否显示菜单栏。 注注意意：当当工工具具栏栏属属性性（toolbars 属属性性）为为真真，也也就就是是显显示示工工具具栏栏的的时时候候， menubar 只只能能为为true。 2、 menubarcolor menubarcolor：菜单栏背景颜色；可读写；缺省值：白色； 设置： obj. menubarcolor = ole_color 说明： ol

21、e_color 是一个 bgr (blue, green, red)数值。 bgr value = (blue * 65536) + (green * 256) + red 3、 menubarstyle menubarstyle：设定菜单条的风格。 取值： ntkomenubarflat = 0, /平坦风格 ntkomenubarlinearh1 = 1 /水平填充 1 ntkomenubarlinearh2 = 2, /水平填充 2 ntkomenubarlinearv1 = 3, /垂直填充 1 ntkomenubarlinearv2 = 4, /垂直填充 2 ntkomenubarl

22、inearhm = 5 /中间填充 4、 menubuttoncolor menubuttoncolor：设定菜单按钮的填充颜色。当menubuttonstyle 为 3 或者以上时起作用。 5、 menubuttonstyle menubuttonstyle：设定菜单按钮的风格。 ntkomenubuttonhilight = 0,/默认系统亮度显示 ntkomenubuttonupper = 1, /凸起显示 ntkomenubuttonlower = 2, /凹陷显示 ntkomenubuttonflat = 3, /平坦风格 ntkomenubuttonlinearh1 = 4, /水

23、平填充 1 ntkomenubuttonlinearh2 = 5, /水平填充 2 ntkomenubuttonlinearv1 = 6, /垂直填充 1 ntkomenubuttonlinearv2 = 7, /垂直填充 2 ntkomenubuttonlinearhm = 8 /中间填充 6、 menubuttonframecolor menubuttonframecolor：设定菜单按钮边框的颜色。 7、 custommenucaption custommenucaption：自定义主菜单的标题。当新增的主菜单中有菜单项目 时，会显示该标题到主菜单。主菜单的项目可以通过新增的方法： ad

24、dcustommenuitem 增加。请参考 “主要方法参考 ”部分的 “自定义菜单相 关方法 ”部分。 8、 menuitemcount menuitemcount：只读。返回自定义主菜单中的项目数量。 9、 filemenuitemcount filemenuitemcount：只读。返回自定义文件菜单中的项目数量。 10、 isshowtoolmenu isshowtoolmenu：显示 /隐藏工具菜单，可读写；缺省值：true； 设置： isshowtoolmenu= true | false 说明：在隐藏审阅（修订）工具栏之后，一般也需要隐藏工具菜单。否则，从 工具菜单也能够访问到审

25、阅功能。 11、 filenew，fileopen，fileclose，filesave，files aveas，fileprint，fileprintpreview，filepagese tup，fileproperties 布尔型。可读写。用来允许或者禁止相应的文件菜单项。与 enablefilecommand(commandtype)属性作用相同。 12、 enablefilecommand 过时 该属性已过时，仅为兼容保留。新的应用程序请使用 filenew，fileopen，fileclose，filesave，filesaveas，fileprint，filep rintprevi

26、ew，filepagesetup，fileproperties 属性。 enablefilecommand(commandtype)：设置文件命令状态，可读写; 设置： enablefilecommand(0-7)= true | false 读取： var = enablefilecommand(0-7) 说明： commandtype = 0|1|2|3|4|5|6|7 |8 0：文件 -新建菜单 1：文件 -打开菜单 2：文件 -关闭菜单 3：文件 -保存菜单 4：文件 -另存为菜单 5：文件 -打印菜单 6：文件 -打印预览菜单 7：文件 -打印设置菜单 8：文件 -属性菜单 3.4、

27、 文档信息相关属性文档信息相关属性 1、 activedocument activedocument：返回文档对象的自动化接口，只读； 读取： docobj = obj.activedocument 比如：如果打开一个word 文档，则 activedocuent 代表一个 word.document 对象。可以用javascript 或者 vbscript 对该对象进行控制来 操作 office 文档。 2、 doctype 返回当前控件中的文档类型,只读 . 0: 没有文档； 100 =其他文档类型； 1=word；2=excel.sheet 或者 excel.chart ； 3=powe

28、rpoint.show； 4= visio.drawing； 5=msproject.project； 6= wps doc； 7:kingsoft sheet 3、 docsize docsize：长整型。只读。获取当前文档的字节数。 4、 isnocopy isnocopy：控件中的文档是否禁止拷贝，可读写；缺省值：false。 读取： boolvalue = docobj.isnocopy 设置： docobj.isnocopy boolvalue 5、 isstrictnocopy isstrictnocopy：是否严格禁止拷贝；布尔型；可读写； 设置： obj. isstrictno

29、copy = true or false。 说明： isstrictnocopy 可以用来设置严格的禁止拷贝控件中的内容。该属性 从 v 版本开始提供。 6、 data data 属性标识文档的内容。设定obj.data=data 将打开文档。 data 是一 个 variant 类型变量。 该该属属性性主主要要用用于于powerbuilder，delphi，vb 等等 c/s 应应用用，用用来来获获取取文文档档数数据据 并并保保存存，或或者者用用来来使使用用已已经经保保存存的的数数据据恢恢复复打打开开文文档档。 7、 statusmessage 返回最后操作的结果字符串,只读

30、. 8、 statuscode 返回最后操作的结果代码,只读 . 0: 成功 ; 1:文件错误 ; 2:网络错误 ; 3: 内存错误 ; 4:参数错误 ;5:从 odbc 数据库读写数据错误 6：从 variant 读写数据错误 100：其他错误 9、 signcursortype signcursortype：读取 /设置签名批注时的光标类型。0：笔形。 1：红点。 该属性 =1 可用于平板电脑用户。 3.5、 网络传输控制相关属性网络传输控制相关属性 1、 maxuploadsize maxuploadsize：返回或者设置最大允许提交的数据量。以字节为单位。 2、 isuseutf8ur

31、l isuseutf8url：读取 /设置是否使用utf-8 传输 url。 3、 isuseutf8data isuseutf8data：读取 /设置是否使用utf-8 在智能提交中传输网页数据。 如果网页编码设置为utf-8，需要设置此属性，以便控件自动使用utf-8 编码进行网页数据的提交。 4、 isusecontrolagent isusecontrolagent：读取 /设置向服务器提交请求时是否使用ntko office control agent.此信息也可用于判断是否是控件请求的数据.从 而可以设定后台程序拒绝其他请求。 5、 isdirectconnect isdirect

32、connect：是否使用直接连接连接服务器。【而不是默认的采用浏 览器设置 】。对于某些老版本的代理服务器环境，设置此选项可以避免因浏览器 自动检测代理服务器引起的问题。 6、 isopenurlreadonly isopenurlreadonly：返回布尔值，只读； 标识在使用openfromurl 函数打开文档时是否传递了只读参数。 3.6、 数字证书签名相关属性数字证书签名相关属性 1、 issavedocextention issavedocextention：读取 /设置是否保存文档扩展信息.如果使用数字签 名功能，必须设置此属性为true。以便使用ntko office 扩展文档格

33、式保 存信息。 2、 issavedataifhasvds issavedataifhasvds：读取 /设置文档已有合法数字签名之后是否允许保存 文档数据。默认为false。即，如果文档已经有合法数字签名，将不允许保存文 档数据以破坏签名。如果设置为true，则用户保存文档时，可能会造成现有数 字签名的破坏。 3.7、 控件密钥相关属性控件密钥相关属性 1、 productcaption，productkey 标题栏名称和密钥。正式版本用户请参考说明。 3.8、 与事件处理相关的属性与事件处理相关的属性 1、 cancellastcommand cancellastcommand：布尔型。只

34、写。在“onfilecommand”事件中使 用。请参考 “onfilecommand”事件。 设置最后一次的文件操作是否应该取消,只写 .该属性可用于接管缺省的工 具栏的新建，打开或者保存操作，并设置该参数为true 来取消缺省操作。 比如：以下代码接管保存菜单和按钮的操作，并取消缺省的操作 if (cmd = 3) /user has clicked on file save menu or button /save to server /cancel default process tanger_ocx_saveedittoserverdisk(); document.all(tange

35、r_ocx).cancellastcommand = true; 2、 cancelsheetdoubleclick cancelsheetdoubleclick：设置是否取消excel 双击操作 ,只写。该属性 必须在事件onsheetbeforedoubleclick 中使用。请参考事件 onsheetbeforedoubleclick 的介绍。 3、 cancelsheetrightclick cancelsheetrightclick：设置是否取消excel 右键操作 ,只写。该属性必 须在事件 onsheetbeforerightclick 中使用。请参考事件 onsheetbefo

36、rerightclick 的介绍。 第第4章章 主要方法参考 4.1、 新建、打开和保存文档相关方法新建、打开和保存文档相关方法 1、 createnew void createnew( in bstr progid); 创建一个新文档对象。必须指定progid。常用的 progid 有： office document type progid word 文档：“word.document” powerpoint 幻灯片：“powerpoint.show” excel 工作表：“excel.sheet” excel 图表： excel.chart visio 画图： visio.drawing

37、 ms project 项目：msproject.project wps 文档：wpsfile.4.8001 金山电子表：et.sheet.1.80.01.2001 2、 savetourl bstr savetourl ( in variant url, in variant filefieldname, in, optional variant cpara, in, optional variant filename, in, optional variant htmlform ); 该函数使用http 协议将文件保存到url。2.0 版本对该函数做了增强。 通过增加一个可选参数htmlf

38、orm 来引入了我们独创的“智能提交 ”技术。 url 可以是相对于控件所在的网页的相对url 或者是绝对url。 filefieldname 相当于一个html 页面的 form 中的 中的 filefieldname。 可选参数 cpara 是可以让用户定义没有在表单中出现的参数。该参数是以” t = value.replace(/%/g,%25); return(t.replace(/ 可选参数 filename 可以被用来更加方便直接指明文件名。相当于 content-disposition: form-data; name=filefieldname; filename=filena

39、me中的 filename。该参数如果不指定，则如果是新建 word 文档，缺省值是 ”新文档 .doc”；如果是新建excel 电子表，则缺省值是” 新电子表 .xls”。否则，如果是用户从本地打开的文件，则是本地文件的全路径名 称。 可选参数 htmlform 用来指定随控件中的文档一起提交的html form。可以使用form 的 id，比如， “myform”来指定，或者，也可以使 用 form 在网页中所有form 中的序号，比如，0，来指定。 该函数返回值是提交url 之后从服务器返回的数据。 为了使该函数工作，必须在web 服务器中开发一个能够处理表单提交的 cgi 或者 asp

40、 或者是 jsp 等程序。比如，对于如下表单： type: workflow: select file: savetourl(“/postcgi.jsp”,”docfile”,”,”newdoc.doc”,”myform”)或： savetourl(“/postcgi.jsp”,”docfile”,”,”newdoc.doc”,0) 都会在将正在编辑的文档作为一个上传文件的同时，提交上述表单中的所有数 据。因此， postcgi.jsp 程序中，除了处理上述表单的数据，还应该处理一个名 称为 docfile，文件名为newdoc.doc 的上传文件。 如果您的应用程序本身就处理了多个附件，只需

41、要将正文附件替换为控件，然 后调用控件的savetourl 函数，后台程序无须进行任何修改就能够将在线编辑 的文件以及其他的附件同时提交到web 服务器。 3、 openfromurl void openfromurl ( in variant url, in, optional variant readonly, in, optional variant progid ); 该函数使用http 协议从 url 打开文件。 url 可以是相对于控件所在的网页的相对url 或者是绝对url。只要打 开的 url 返回一个正确的office 文档，而不管其扩展名是否正确，该函数都能 够自动正确判断

42、文档类型。 readonly 说明是否以只读方式打开文档。以只读方式打开的文档不能保存回 服务器。 progid 可以省略。如果指定progid，则强行使用progid 指定的类型转 换文档。常用的progid 有： word 文档：“word.document” powerpoint 幻灯片：“powerpoint.show” excel 工作表：“excel.sheet” excel 图表： excel.chart visio 画图： visio.drawing ms project 项目：msproject.project 4、 openlocalfile void openlocalf

43、ile ( in variant document, in, optional variant readonly, in, optional variant progid ); 打开本地文件。如果文件有正确的扩展名，progid 可以省略。否则，必 须指定 progid。 5、 savetolocal void savetolocal(in, optional variant saveasdocument, in, optional variant overwriteexisting); 将文件保存到本地。两个参数都是可选的。如果缺少第一个参数，将保存到原 位置；第二个参数缺省是false，不

44、覆盖现有文件。 6、 publishashtmltourl bstr publishashtmltourl ( in variant url, in variant filefieldname, in, optional variant cpara, in, optional variant filename, in, optional variant htmlform ); 该函数和 2.0 版本的 savetourl 函数的参数完全一致。不同之处在于， filename 现在可能有多个值，包括html 文件，相关的图片文件等等多个文 件，但是都是包含在filename 域中。 7、 ope

45、nfromodbcds 从 odbc 数据源读取文档 .参数是 select 语句 ,必须返回唯一的二进制列. openfromodbcds ( in bstr dsname,/odbc 数据源名称 in bstr selectsql,/select 语句 in bstr username,/用户名 in bstr password/口令 ); 比如： tanger_ocx_obj.openfromodbcds(v23db,select filedata from myuploadtable where id=27,); 8、 savetoodbcds 写入 odbc 数据源 .参数是带有唯一

46、二进制列参数的insert 或者 updata 语句。 savetoodbcds ( in bstr dsname,/odbc 数据源名称 in bstr updatesql,/ updatesql 语句 in bstr username,/用户名 in bstr password/口令 ); 比如： tanger_ocx_obj.savetoodbcds(v23db,insert into myuploadtable (filename,filesize,filedata) values (newdoc.doc,19520,?),); 9、 openncofromlocal 从本地打开以nt

47、ko 压缩的文件类型压缩的office 文档 openncofromlocal ( in bstr filename, in, optional variant promptselect ); 第一个参数指定文件路径和文件名，第二个可选参数指明是否提示用户选择。 默认是提示。 注意：必须filename 指定的文件必须是ntko 压缩的文件类型（*.nco 文件） 10、 savencotolocal 将压缩的 office 文档以 ntko 压缩的文件类型（*.nco 文件）保存到本 地. savencotolocal ( in bstr filename, in, optional var

48、iant promptselect ); 第一个参数指定文件路径和文件名，第二个可选参数指明是否提示用户选择。 默认是提示。 11、 openncofromurl 从 url 打开以 ntko 压缩的文件类型压缩的office 文档。 openncofromurl(in variant url); 12、 savencotourl bstr savencotourl ( in variant url, in variant filefieldname, in, optional variant cpara, in, optional variant filename, in, optional

49、 variant htmlform ); 将 office 文档，以 ntko 压缩的文件类型保存到指定的url。该函数 的参数及详细介绍请参考有关savetourl 函数的介绍。 4.2、 文档通用方法文档通用方法 1、 setreadonly 设置文档为只读 /可写。 setreadonly(isreadonly, password ); js 调用示例： ocx_obj. setreadonly (true,); 2、 showcommandbar showcommandbar(commandbarindexorname, isshow); 显示或者隐藏指定的工具栏。请参考office

50、本身编程手册的 commandbars 集合。 3、 showdialog void showdialog( in showdialogtype dlgtype); 显示对话框；参数为对话框类型。 showdialogtype = 0|1|2|3|4|5|6 0：新建对象1：打开2：保存3：另存为 4：打印5：打印设置6：文件属性 4、 printout void printout( in, optional variant prompttoselectprinter); 打印当前文档。可选参数是是否提示用户选择打印机。 5、 printpreview void printpreview();

51、 显示打印预览视图。 6、 close void close(); 关闭当前文档。 7、 getofficever getofficever() 获取当前 office 的版本。 返回值的含义如下： 9=office2000，10=officexp,11=office2003，6=office95 8= office 97 0=错误 4.3、 自定义菜单相关方法自定义菜单相关方法 1、 addcustommenuitem 在自定义的主菜单中增加自定义菜单项。 addcustommenuitem ( in bstr cmnucaption, in,optional variant issepar

52、ator, /是否分隔，默认为false in,optional variant isneedopendoc, /是否需要打开的文档， 默认为 true in,optional variant cmnuid/菜单 id，默认 0 ); 有关处理用户单击菜单项目的事件，请参考“v2.5 新增事件参考 ”。 第一个参数是菜单项目的标题。如果该标题为空字符串，则增加一个菜单项目 分隔。 第二个可选参数指明该菜单项目是否是分隔，默认为false。 第三个参数指明该菜单项目是否需要打开的文档才可用。默认值为 true。如果该参数为false，则该项目一直可用。如果为true，则只有具有打 开的文档时，该

53、项目才可用。否则，该项目为灰色。 第四个参数指明该菜单项目的自定义id。为数字类型。可以通过这个id 在处理菜单单击事件时标识用户单击的菜单项目。 js 调用示例： 以下函数在自定义的主菜单中增加一个“创建 word 文档 ”菜单项目。 ocx_obj. addcustommenuitem ( 创建 word 文档, false, false, 1 ); 以下函数在自定义的主菜单中增加一个分隔栏： ocx_obj. addcustommenuitem (); 2、 removecustommenuitem removecustommenuitem(in long index) 在自定义的主菜单

54、中删除一个自定义菜单项。 注意：索引从0 开始。比如，如果一个自定义主菜单中原先有4 个菜单 项目，则可以删除0-3 的菜单项目。 另外，删除了前面的一个自定义菜单项之后，后面的项目的索引会发生变化。 比如，对于有4 个菜单项目的自定义主菜单，删除第0 个菜单项目之后，菜 单中将只有0-2 的菜单项目可以删除。 3、 clearallcustommenuitems clearallcustommenuitems()方法将删除所有的自定义主菜单项目。 4、 addfilemenuitem 在自定义的文件菜单中增加自定义菜单项。 addfilemenuitem ( in bstr cmnucapt

55、ion, in,optional variant isseparator, /是否分隔，默认为false in,optional variant isneedopendoc, /是否需要打开的文档， 默认为 true in,optional variant cmnuid/菜单 id，默认 0 ); 该方法的参数和含义与addcustommenuitem 方法相同。只是该方法是在 文件菜单中增加自定义的菜单项。 5、 removefilemenuitem removefilemenuitem(in long index) 在自定义的文件菜单中删除一个自定义菜单项。 6、 clearallfile

56、menuitems clearallfilemenuitems() 删除所有自定义文件菜单项。 4.4、 手写签名，电子印章和图片操作相关方法手写签名，电子印章和图片操作相关方法 1、 addpicfromlocal void addpicfromlocal ( in bstr filename, in, optional variant promptselect, in, optional variant isfloat, in,optional variant left; in,optional variant top, in,optional variant relative, in,o

57、ptional variant scale, in,optional variant zorder; ); 该函数用来从本地增加图片到office 文档。 v2.5 版本为该函数新增了3 个可选参数， relative, scale,和 zorder; relative 取值 1-4。1：光标位置； 2：页边距； 3：页面距离 4：默认设 置栏，段落（为兼容以前版本默认方式）； scale 可选参数表示缩放。默认值100，无缩放。 zorder 表示图片是置于文字的上方还是下方。0：下方； 1：上方； filename 是文件名，该参数是必须的； promptselect 可选参数指明是否允许

58、用户选择文件;缺省是 true，允许选 择； isfloat 可选参数指明是否浮动图片。缺省是true，作为浮动图片插入。 left 可选参数指明如果插入图片的左边距。缺省值是0；如果 isfloat 为 false，则在当前光标处插入。该参数不起作用。如果isfloat 为 true，则 指明插入的图片相对于当前段落左栏的位置，以磅为单位。 top 可选参数指明如果插入图片的上边距。缺省值是0；如果 isfloat 为 false，则在当前光标处插入。该参数不起作用。如果isfloat 为 true，则 指明插入的图片相对于当前段落顶部的位置，以磅为单位。 该函数新增了3 个可选参数， re

59、lative, scale,和 zorder; js 调用示例： ocx_obj.addpicfromlocal( , /路径 true,/是否提示选择文件 true,/是否浮动图片 0,/如果是浮动图片，相对于左边的 left 单位磅 0, /如果是浮动图片，相对于当前段落 top 1, /当前光标处 100,/无缩放 1 /文字上方 ); 2、 addpicfromurl void addpicfromurl ( in bstr url, in, optional variant isfloat, in,optional variant left, in,optional variant

60、top, in,optional variant relative, in,optional variant scale, in,optional variant zorder; ); 该函数用来从url 增加图片到office 文档。 v2.5 版本为该函数新增了3 个可选参数， relative, scale,和 zorder; relative 取值 1-4。1：光标位置； 2：页边距； 3：页面距离 4：默认设 置栏，段落（为兼容以前版本默认方式）； scale 可选参数表示缩放。默认值100，无缩放。 zorder 表示图片是置于文字的上方还是下方。0：下方； 1：上方； url 是