1、在 WEB 中使用 OFFICE 文档！NTKO OFFICE 文 档 控 件 开 发 接 口参 考 V3.0 Build 3,0,0,8更 新 时 间 ： 2005 年 05 月 30 日开 发 接 口千 航 网 络 【 NTKO SOFTWARE】电 子 邮 件 ： TANGERNTKO.COMWEB： HTTP:/WWW.NTKO.COM/TEL-FAX： 023-62929797 COPYRIGHT 2003-2005， BY LIULINGXUNALL RIGHTS RESERVED版 权 所 有 ： 千 航 网 络保 留 所 有 权 利未 经 许 可 ,请 勿 分 发 本 文 档
2、的 部 分 或 全 部V3.0 版目 录目 录第 1 章 软件最终用户许可协议 1第 2 章 功能介绍（Features） 11、 功能简介 12、 3.0 版本的新功能 23、 详细功能列表 24、 需要的软件 45、 支持的 Web 服务器 56、 HTML Object 标识符 5第 3 章 主要属性参考 53.1、 一般界面相关 51、 Statusbar52、 Caption53、 BackColor， ForeColor54、 BorderColor65、 TitlebarColor，TitlebarTextColor 66、 TitleBar67、 BorderStyle 63.
3、2、 工具栏相关属性 61、 ToolBars62、 IsResetToolbarsOnOpen 73.3、 菜单控制相关属性 71、 Menubar72、 MenubarColor 73、 MenuBarStyle74、 MenuButtonColor75、 MenuButtonStyle76、 MenuButtonFrameColor87、 CustomMenuCaption 88、 MenuItemCount89、 FileMenuItemCount810、 IsShowToolMenu 811、 FileNew，FileOpen，FileClose，FileSave ，FileSave
4、As，FilePrint，FilePrintPreview，FilePageSetup，FileProperties 912、 EnableFileCommand 过时 93.4、 文档信息相关属性 91、 ActiveDocument92、 DocType103、 DocSize104、 IsNoCopy 105、 IsStrictNoCopy106、 Data107、 StatusMessage 108、 StatusCode 119、 SignCursorType113.5、 网络传输控制相关属性 111、 MaxUploadSize112、 IsUseUTF8URL113、 IsUse
5、UTF8Data 114、 IsUseControlAgent115、 IsDirectConnect116、 IsOpenURLReadOnly 113.6、 数字证书签名相关属性 121、 IsSaveDocExtention122、 IsSaveDataIfHasVDS123.7、 控件密钥相关属性 121、 ProductCaption，ProductKey 123.8、 与事件处理相关的属性 121、 CancelLastCommand122、 CancelSheetDoubleClick 133、 CancelSheetRightClick 13第 4 章 主要方法参考 134.1
6、、 新建、打开和保存文档相关方法 131、 CreateNew132、 SaveToURL143、 OpenFromURL154、 OpenLocalFile165、 SaveToLocal166、 PublishAsHTMLToURL177、 OpenFromODBCds178、 SaveToODBCds179、 OpenNCOFromLocal 1810、 SaveNCOToLocal1811、 OpenNCOFromURL1912、 SaveNCOToURL194.2、 文档通用方法 191、 SetReadOnly192、 ShowCommandBar19目 录3、 ShowDialo
7、g204、 PrintOut205、 PrintPreview206、 Close207、 GetOfficeVer 204.3、 自定义菜单相关方法 201、 AddCustomMenuItem 202、 RemoveCustomMenuItem 213、 ClearAllCustomMenuItems 224、 AddFileMenuItem225、 RemoveFileMenuItem226、 ClearAllFileMenuItems224.4、 手写签名，电子印章和图片操作相关方法 221、 AddPicFromLocal222、 AddPicFromURL243、 AddSignF
8、romLocal254、 AddSignFromURL265、 DoHandSign2286、 DoHandDraw2297、 DoCheckSign308、 SetSignsVisible309、 ClearSigns3010、 DoHandSign【请使用 DoHandSign2】 3111、 DoHandDraw【请使用 DoHandDraw2】 324.5、 数字证书签名相关方法 331、 AddDigitalSignature 332、 ReDigitalSignature333、 VerifyDigitalSignature334、 GetDSCount335、 GetValidD
9、SCount336、 DS_CSPProviderName334.6、 适用于 WORD 文档的简化方法 341、 AddTemplateFromLocal342、 GetBookmarkValue343、 SetBookmarkValue 344、 AddTemplateFromURL345、 AddNCOTemplateFromURL346、 AddNCOTemplateFromLocal354.7、 适用于 EXCEL 的简化方法 351、 AddSheet 352、 GetSheetsCount353、 GetRangeValue354、 SetRangeValue355、 GetRa
10、ngeFormula366、 SetRangeFormula367、 SetRangeLocked364.8、 自定义通讯相关方法 361、 DoWebGet 362、 DoWebExecute36第 5 章 主要事件参考 375.1、 文档相关事件 371、 OnDocumentOpened372、 OnDocumentClosed375.2、 菜单相关事件 371、 OnFileCommand372、 OnCustomMenuCmd 373、 OnCustomFileMenuCmd385.3、 签名印章相关事件 381、 AfterHandSignOrDraw 382、 AfterChec
11、kSign383、 OnSignSelect395.4、 EXCEL 事件 391、 OnSheetSelectionChange392、 OnSheetBeforeDoubleClick393、 OnSheetBeforeRightClick40第 6 章 JavaScript/Jscript 代码 401、 使用 JavaScript 响应控件事件 402、 其他示例请参考 41第 7 章 常见问题（FAQs） 411、 SaveToURL 方法出错 412、 如何调用 Word 自己的对话框？ 423、 如何设置禁止拷贝文档数据？ 494、 如果控件不能运行怎么办？ 495、 如何在 的
12、 部分设置属性？ 496、 如何输入产品密钥？ 49NTKO OFFICE 文 档 控 件 开 发 接 口 参 考 V3.0.0.8 1 第 1 章 软 件 最 终 用 户 许 可 协 议重 要 须 知 请 认 真 阅 读 ： 本 最 终 用 户 许 可 协 议 （ 以 下 称 协 议 ）是 您 （ 个 人 或 单 一 实 体 ） 与 我 们 之 间 有 关 NTKO Office 文 档 控 件 软 件 产 品 的法 律 协 议 。 本 “软 件 产 品 ”包 括 计 算 机 软 件 ， 并 可 能 包 括 相 关 媒 体 、 印 刷 材 料 ，和 “联 机 ”或 电 子 文 档 （ “软
13、件 产 品 ”） 。 本 “软 件 产 品 ”还 包 括 对 我 们 提 供给 您 的 原 “软 件 产 品 ”的 任 何 更 新 和 补 充 资 料 。 任 何 与 本 “软 件 产 品 ”一 同提 供 给 您 的 并 与 单 独 一 份 最 终 用 户 许 可 证 相 关 的 软 件 产 品 是 根 据 那 份 许 可 协 议 中 的条 款 而 授 予 您 。 您 一 旦 安 装 、 复 制 、 下 载 、 访 问 或 以 其 它 方 式 使 用 “软 件 产品 ”， 即 表 示 您 同 意 接 受 本 协 议 各 项 条 款 的 约 束 。 如 您 不 同 意 本 协 议 中 的 条 款
14、 ， 请 不 要 安 装 或 使 用 “软 件 产 品 ”；NTKO Office 文 档 控 件 是 受 版 权 保 护 的 。 如 果 您 得 到 的 是 未 注 册 版 本 ， 您 还没 有 获 得 运 行 授 权 。 请 在 测 试 完 成 之 后 从 您 的 机 器 中 删 除 。 如 果 您 得 到 的 是 注 册 版本 ， 您 可 以 在 授 权 协 议 许 可 的 范 围 内 使 用 本 软 件 。您 不 能 分 发 ， 销 售 ， 以 及 非 法 破 解 本 软 件 。 也 不 能 超 出 协 议 许 可 的 范 围 使 用 本软 件 。 否 则 ， 将 被 视 为 侵 犯
15、了 我 们 的 知 识 产 权 。对 反 向 工 程 (Reverse Engineering)、 反 向 编 译 (Decompilation)、 反 汇编 (Disassembly) 的 限 制 。 您 不 得 对 本 “软 件 产 品 ”进 行 反 向 工 程 、 反 向 编译 (decompile) 或 反 汇 编 (disassemble)， 但 尽 管 有 这 项 限 制 ， 如 适 用 法 律 明示 允 许 上 述 活 动 ， 则 不 在 此 限 。 另 外 ， 我 们 不 对 您 在 使 用 此 软 件 的 过 程 中 对 您 的 机器 或 者 数 据 造 成 的 损 失 负
16、责 。第 2 章 功 能 介 绍 （ Features）1、 功 能 简 介使 用 NTKO Office 文 档 控 件 ， 能 够 在 浏 览 器 窗 口 中 直 接 编 辑 Word,Excel等 Office 文 档 并 保 存 到 Web 服 务 器 。 实 现 文 档 和 电 子 表 格 的 统 一 管 理 。 同 时 支持 痕 迹 保 留 ， 手 写 签 名 ， 电 子 盖 章 等 办 公 自 动 化 系 统 必 备 的 功 能 。 是 OA 系统 开 发 的 最 佳 选 择 组 件 ！ 卓 越 的 性 能 ， 低 廉 的 价 格 ， 标 准 高 效 的 编 程 接 口 ， 让
17、您 以最 低 的 开 发 成 本 ， 轻 松 创 建 极 具 特 色 的 解 决 方 案 ！它 能 够 将 编 辑 过 的 Office 文 档 直 接 保 存 到 Web 服 务 器 ； 支 持 在 线 编 辑 包NTKO OFFICE 文 档 控 件 开 发 接 口 参 考 V3.0.0.8 2 括 Microsoft Word， Excel 以 及 PowerPoint 在 内 的 所 有 Office 文 档 类 型 ； 支持 各 种 后 台 Web 服 务 器 和 编 程 语 言 。 并 且 可 以 在 浏 览 器 中 通 过 JScript 或 者VBScript 使 用 控 件
18、提 供 的 属 性 和 方 法 控 制 文 档 操 作 。2、 3.0 版 本 的 新 功 能NTKO OFFICE 文 档 控 件 3.0 版 本 在 已 有 强 大 功 能 的 基 础 上 ， 新 增 了 文 档 电子 签 名 【 数 字 签 名 】 的 功 能 。 同 时 简 化 了 一 些 常 用 功 能 的 函 数 和 方 法 。NTKO OFFICE 文 档 控 件 3.0 版 本 的 数 字 签 名 功 能 基 于 国 际 标 准 开 发 ， 同 时 符 合国 家 即 将 实 施 生 效 的 电 子 签 名 法 。 使 用 电 子 签 名 【 数 字 签 名 】 ， 可 以 验证
19、 对 文 档 内 容 ， 格 式 等 的 任 何 改 动 。 同 时 支 持 联 合 签 名 ， 证 书 吊 销 列 表 等 功 能 。 另外 ， NTKO OFFICE 文 档 控 件 3.0 版 本 还 支 持 数 字 签 名 的 信 任 程 度 显 示 。 数 字 签名 可 以 区 分 为 完 全 可 信 ， 基 本 可 信 ， 或 者 不 可 信 。电 子 签 名 【 数 字 签 名 】 功 能 采 用 标 准 接 口 ， 可 以 和 企 业 已 有 的 PKI 系 统无 缝 融 合 。3、 详 细 功 能 列 表 新增电子签名【数字签名】的功能。V3.0 版本新增了文档电子签名【数字
20、签名】的功能。同时简化了一些常用功能的函数和方法。NTKO OFFICE 文档控件 3.0 版本的数字签名功能基于国际标准开发，同时符合国家即将实施生效的电子签名法。使用电子签名【数字签名】，可以验证对文档内容，格式等的任何改动。同时支持联合签名，证书吊销列表等功能。电子签名【数字签名】功能采用标准接口，可以和企业已有的 PKI 系统无缝融合。新增可定制得文件菜单，可定制一个主菜单，禁止 F12保存，可显示页码，页数信息得状态栏。V2.5.2.1 版本新增了可定制文件菜单，可定制一个主菜单。进一步增强了系统得可集成性。新增得禁止F12 快捷键保存文档，以及在禁止拷贝得基础上禁止拖放文字得功能，
21、进一步增强了文件得安全性。新得状态栏可以显示 Word 文档得页码和页数等信息。用户使用更加方便。 新增压缩传输接口，定制菜单栏颜色V2.5.1.2 版本新增了定制菜单栏颜色的接口，以及使用压缩方式保存和打开服务器文件的功能。对于一般 19K 左右的新 Word 文档，压缩后只有 2K 左右。大大提高了存储效率。 新增了全文批注（全屏批注）和定位批注签名的功能。V2.5.0.1 版本在已有强大功能的基础上，新增了全文批注（全屏批注）和定位批注签名的功能。能够采用所见所得的方式在屏幕上进行批注，并插入到屏幕所在位置。新版本还支持屏幕位置插入签名，光NTKO OFFICE 文 档 控 件 开 发
22、接 口 参 考 V3.0.0.8 3 标位置插入签名，以及签名缩放等功能。全面支持 C/S 方式和其他容器。在 VB,Delphi,C+Builder中均可以很方便的使用控件V2,3,2,0 版本之后， NTKO OFFICE 文档控件不仅可以继续与浏览器和各种后台 Web 服务器无缝集成创建 B/S 结构的应用，更全面支持 C/S 方式的编程和其他容器。您可以在 VB,Delphi,以及 C+ Builder 中使用控件。快速创建具有痕迹保留，电子印章等功能的 C/S 结构的应用。 支持将数据直接写入 ODBC数据源。V2,3,2,0 版本之后， NTKO OFFICE 文档控件支持直接从
23、ODBC 数据源读取文档内容，或者将文档内容存入 ODBC 数据源。这为 C/S 结构下创建共享的办公系统，文档管理，知识管理解决方案提供了更强大的接口。 状态栏,智能 Web 调用, 预定义模板套红NTKO OFFICE 文档控件 2.2 版本全面支持状态栏，用户界面更加友好。智能 Web 让您甚至可使用XML 或者自定义的协议和服务器通讯! 广泛的操作系统，Web 服务器，数据库和编程语言支持后台支持 Windows,Linux,Unix 等各种操作系统；支持 IIS，Domino，Websphere，Apache 等所有后台WEB 服务器类型，支持Db2，Oracle，MySQL，SQL
24、 Server 等各种常用数据库和 JSP，ASP，PHP，PERL 等编程语言。支持在提交编辑文档的同时，提交表单的其它数据，包括其它的文件上传采用我们独创的“ 智能提交” 技术，让您在提交编辑文档的同时，提交表单的其它数据，以及表单中其它的文件上传。这可以让您更加快速的集成现有的应用程序，或者创建新的应用程序。 支持所有的 Office 菜单完全符合用户习惯，用户操作更加轻松，尤其是复杂的表格操作，和在 Office 中操作完全一致，大大节约开发成本；而且菜单项目可以通过 javascript 来控制允许或者禁止。支持发布为 HTML发布为 HTML 的功能，可以让您将在线编辑的文档（WO
25、RD,EXCEL）以 HTML 的方式发布到 WEB 服务器。让没有安装控件的用户也能够方便的查看文档。 支持将 HTML 及其相关文件直接发布到 DOMINO 文档 可以将 HTML 文件及其相关文件直接作为附件发布到 DOMINO 的文档中。版本控制功能 版本控制功能，能够让您对 WORD 和 EXCEL 文档有更多的控制。支持强制痕迹保留 可以通过对控件编程，让用户只能在痕迹保留状态下工作；强制用户保留一切编辑痕迹。 支持手写签名和加密的电子印章支持使用我们的工具制作加密的电子印章，可将印章放入 U 盘等硬件设备。高强度的单向加密算法保证只有拥有正确的口令才能够恢复出印章的数据。NTKO
26、 OFFICE 文 档 控 件 开 发 接 口 参 考 V3.0.0.8 4 只有单向加密才能保证不能从印章文件恢复出口令。 无需后台配置,即可支持 Lotus Domino可与 Lotus Domino 服务器天然集成。Domino 服务器无需安装 Java，或其它任何组件。降低系统部署的难度。同时能够将已有的复杂应用迅速转换到使用控件的应用。降低开发成本，节约开发时间。 基于标准协议，无任何自定义数据格式，通用性好 基于标准协议的开发，使得合作伙伴无须担心技术的进步带来后续维护和开发风险。 支持从本地或服务器 URL 获取加密的电子印章 支持从本地和服务器将电子印章加入到 Office 文
27、档。支持从服务器 URL 或本地直接插入透明浮动图片到Word，Excel 文档新增加的 AddPicFromURL 和 AddPicFromLocal 函数可以直接从 URL 或本地插入透明的浮动图片到Office 文档支持将手工绘制的图片作为透明浮动的图片增加到Word，Excel 文档新增加的 DoHandDraw 函数可以将您不期而至的灵感迅速转化成图片放到 Word 或者 Excel 文档中。 全面支持 Office2000 的打印预览增强了对 Office2000 的打印预览支持，支持全部Office2000 系统的打印预览。另外支持 OfficeXP 和Office2003 中
28、Excel 的打印预览。 轻量级，只有不足 60K使用 C 语言直接开发 COM 接口，简洁高效，对内核函数的直接调用使得无需其它动态链接库的支持，兼容性极好！ 在下载和上载 Office 文档时不会产生临时文件使用流数据作为 Office 文档的数据源，不会产生临时文件。因此不会引起防病毒软件如 Norton Antivirus 的错误警告。 能够禁止用户从文档拷贝数据 IsNoCopy 属性可以禁止用户从 Office 文档中拷贝数据。支持简洁高效的编程接口 可使用 Javascript 和 VBScript 对控件进行编程。可以完全控制 Office 文档。支持 HTTP 协议， HTT
29、PS OVER SSL 协议对 HTTPS 协议的支持使得可以创建更加安全的应用。并且自动支持 Session Cookie。使用当前页面的Session Cookie 和服务器进行交互。支持各种手写笔录入，签名，绘图/批注 支持键盘录入，各种手写笔（汉王、蒙恬、联想）录入方式和使用手写笔手写签名，手工绘图/批注使 用 NTKO Office 文 档 控 件 ， 可 以 大 大 缩 短 整 个 系 统 的 开 发 时 间 ， 降 低 系 统的 开 发 成 本 ， 提 高 产 品 的 质 量 和 用 户 体 验 。 4、 需 要 的 软 件NTKO OFFICE 文 档 控 件 开 发 接 口
30、参 考 V3.0.0.8 5 正 确 运 行 本 控 件 需 要 客 户 机 安 装 Windows98 及 以 上 操 作 系 统 ， Internet Explorer 5.0 及 以 上 版 本 ， 以 及 正 确 安 装 Microsoft Office 97 以 上 版 本 。5、 支 持 的 Web 服 务 器支 持 所 有 的 支 持 HTTP/1.1 标 准 的 Web 服 务 器 。6、 HTML Object 标 识 符第 3 章 主 要 属 性 参 考3.1、 一般界面相关1、 StatusbarStatusbar： 布 尔 型 。 读 写 。 是 否 显 示 状 态 栏
31、 。2、 CaptionCaption： 标 题 栏 的 左 边 的 标 题 ， 可 读 写 ；设 置 ： Obj.Caption = “欢 迎 使 用 ”3、 BackColor， ForeColorBackColor： 背 景 颜 色 ； 可 读 写 ； 缺 省 值 ： 系 统 窗 口 背 景 颜 ；ForeColor： 前 景 颜 色 ； 可 读 写 ； 缺 省 值 ： 系 统 窗 口 字 体 颜 色 ；设 置 ： Obj.BackColor = OLE_COLOR说 明 ： OLE_COLOR 是 一 个 BGR (Blue, Green, Red)数 值 。BGR value = (blue * 65536) + (green * 256) + red NTKO OFFICE 文 档 控 件 开 发 接 口 参 考 V3.0.0.8 6 4、 BorderColorBorderColor： 边 框 颜 色 ， 可 读 写 ； 缺 省 值 ： 系 统 按 钮 颜 色 ；设 置 ： Obj
