NTKO - OFFICE文档控件开发接口参考V4061 - 图文

在WEB中使用OFFICE文档！ V4.0版 NTKO OFFICE文档控件开发接口参考V4.0 Build 4,0,6,1

更新时间：2009年5月16日

开发接口 千航网络【NTKO SOFTWARE】

重庆软航科技有限公司 电子邮件：SUPPORT@NTKO.COM WEB：HTTP://WWW.NTKO.COM/ 技术开发网站：HTTP://DEV.NTKO.COM TEL-FAX：023-62943208/07

? COPYRIGHT 2003-2007，BY NTKO? SOFTWARE

ALL RIGHTS RESERVED

?版权所有：千航网络, 重庆软航科技有限公司

保留所有权利

未经许可,请勿分发本文档的部分或全部

目 录

目录

第1章 软件最终用户许可协议 ················· 1 第2章 功能介绍（Features） ·············· 1

1、 功能简介 ···························································· 1 2、 4.0版本的新功能 ·············································· 2 3、 详细功能列表 ···················································· 2 4、 需要的软件 ························································ 5 5、 支持的Web服务器 ·········································· 5 6、 HTML Object标识符 ········································ 5

第3章 主要属性参考 ······························ 5

3.1、 一般界面相关 ················································ 5 1、 Statusbar ··························································· 6 2、 Caption······························································· 6 3、 BackColor，ForeColor ···································· 6 4、 BorderColor ······················································· 6 5、 TitlebarColor，TitlebarTextColor··················· 6 6、 TitleBar······························································· 6 7、 BorderStyle························································ 6 3.2、 工具栏相关属性 ············································ 7 1、 ToolBars ···························································· 7 2、 IsResetToolbarsOnOpen ································ 7 3.3、 菜单控制相关属性 ········································ 7 1、 Menubar····························································· 7 2、 MenubarColor ··················································· 7 3、 MenuBarStyle ··················································· 7 4、 MenuButtonColor ············································· 8 5、 MenuButtonStyle ·············································· 8 6、 MenuButtonFrameColor·································· 8 7、 CustomMenuCaption[已过时]························· 8 8、 MenuItemCount[已过时]·································· 9 9、 FileMenuItemCount·········································· 9 10、 IsShowToolMenu ··········································· 9 11、 IsShowHelpMenu··········································· 9 12、 IsShowInsertMenu ········································· 9 13、 IsShowEditMenu ············································ 9 14、 FileNew，FileOpen，FileClose，FileSave，FileSaveAs，FilePrint，FilePrintPreview，FilePageSetup，FileProperties······························ 9 15、 EnableFileCommand [已过时] ··················· 10 3.4、 文档信息和行为控制相关属性 ·················· 10

1、 ActiveDocument ············································· 10 2、 WebFileName ················································· 10 3、 IsShowFileErrorMsg ······································ 11 4、 DocType ·························································· 11 5、 DocSize···························································· 11 6、 IsNoCopy ························································· 11 7、 IsStrictNoCopy················································ 11 8、 Data ·································································· 11 9、 NCOData ························································· 12 10、 StatusMessage············································· 12 11、 StatusCode ··················································· 12 12、 SignCursorType ··········································· 12 3.5、 网络传输控制相关属性 ······························ 12 1、 MaxUploadSize ·············································· 12 2、 IsUseUTF8URL ·············································· 12 3、 IsUseUTF8Data·············································· 12 4、 IsShowNetErrorMsg······································· 12 5、 IsUseControlAgent ········································· 13 6、 IsDirectConnect ·············································· 13 7、 IsOpenURLReadOnly···································· 13 3.6、 全屏手写签名/绘图相关属性 ····················· 13 1、 HandSign2Color ············································· 13 2、 HandSign2PenWidth ····································· 13 3、 HandSign2Relative ········································ 13 4、 HandSign2BelowText ···································· 14 3.7、 数字证书签名相关属性 ······························ 14 1、 IsSaveDocExtention ······································ 14 2、 IsSaveDataIfHasVDS ···································· 14 3.8、 控件密钥相关属性 ······································ 14 1、 ProductCaption，ProductKey ······················ 14 3.9、 与事件处理相关的属性 ······························ 14 1、 CancelLastCommand ···································· 14 2、 CancelSheetDoubleClick ······························ 15 3、 CancelSheetRightClick ································· 15 4、 CancelWordRightClick ·································· 15 5、 CancelPPTRightClick ···································· 15

第4章 主要方法参考····························· 15

4.1、 新建、打开和保存文档相关方法 ·············· 15 1、 CreateNew ······················································ 16 2、 SaveToURL····················································· 16

目 录

3、 BeginOpenFromURL ····································· 18 4、 OpenFromURL ··············································· 19 5、 OpenLocalFile················································· 20 6、 SaveToLocal ··················································· 20 7、 PublishAsHTMLToURL ································· 20 8、 SaveAsHTMLFile ··········································· 21 9、 SaveAsOtherFormatToURL ························· 21 10、 SaveAsOtherFormatFile ····························· 22 11、 SaveAsPDFFile ············································ 22 12、 PublishAsPDFToURL·································· 23 13、 OpenFromODBCds ····································· 24 14、 SaveToODBCds··········································· 24 15、 OpenNCOFromLocal··································· 25 16、 SaveNCOToLocal ········································ 25 17、 OpenNCOFromURL ···································· 25 18、 SaveNCOToURL·········································· 25 4.2、 文档通用方法 ·············································· 26 1、 SetReadOnly··················································· 26 2、 Activate ···························································· 26 3、 ShowCommandBar········································ 26 4、 ShowDialog ····················································· 26 5、 PrintOut···························································· 27 6、 PrintPreview ···················································· 27 7、 Close ································································ 27 8、 GetOfficeVer ··················································· 27 9、 GetWPSVer····················································· 27 4.3、 自定义菜单相关方法 ·································· 27 1、 AddCustomMenu2 ········································· 28 2、 AddCustomMenuItem2 ································· 28 3、 EnableCustomMenuItem2 ···························· 31 4、 RemoveCustomMenu2 ································· 32 5、 AddCustomMenuItem[已过时] ····················· 32 6、 RemoveCustomMenuItem[已过时]·············· 33 7、 ClearAllCustomMenuItems[已过时]············· 33 8、 AddFileMenuItem ··········································· 33 9、 RemoveFileMenuItem ··································· 34 10、 ClearAllFileMenuItems ································ 34 4.4、 手写签名，电子印章和图片操作相关方法34 1、 AddPicFromLocal ··········································· 34 2、 AddPicFromURL ············································ 35 3、 AddPicFromScanner······································ 36 4、 AddSignFromLocal ········································ 37 5、 AddSignFromURL ·········································· 38

6、 DoHandSign2·················································· 39 7、 DoHandDraw2 ················································ 40 8、 DoCheckSign ·················································· 41 9、 SetAutoCheckSignKey ·································· 42 10、 SetSignsVisible ············································ 42 11、 ClearSigns····················································· 42 12、 DoHandSign【请使用DoHandSign2】···· 42 13、 DoHandDraw【请使用DoHandDraw2】 · 44 4.5、 文档控件调用安全签章系统的相关方法 ·· 45 1、 IsNTKOSecSignInstalled ······························ 45 2、 AddSecHandSign··········································· 45 3、 AddSecKeyBoardComment ························· 46 4、 AddSecSignFromEkey ·································· 47 5、 AddSecSignFromLocal ································· 48 6、 AddSecSignFromURL ··································· 49 4.6、 数字证书签名相关方法 ······························ 50 1、 AddDigitalSignature ······································· 50 2、 ReDigitalSignature ········································· 51 3、 VerifyDigitalSignature ···································· 51 4、 GetDSCount···················································· 51 5、 GetValidDSCount ··········································· 51 6、 DS_CSPProviderName································· 51 4.7、 适用于WORD文档的简化方法 ··············· 51 1、 AddTemplateFromLocal································ 51 2、 GetBookmarkValue········································ 51 3、 SetBookmarkValue ········································ 52 4、 AddTemplateFromURL ································· 52 5、 AddNCOTemplateFromURL ························ 52 6、 AddNCOTemplateFromLocal······················· 52 4.8、 适用于EXCEL的简化方法 ······················· 52 1、 AddSheet ························································· 53 2、 GetSheetsCount ············································· 53 3、 GetRangeValue ·············································· 53 4、 SetRangeValue ·············································· 53 5、 GetRangeFormula·········································· 53 6、 SetRangeFormula ·········································· 53 7、 SetRangeLocked············································ 54 4.9、 自定义通讯相关方法 ·································· 54 1、 DoWebGet······················································· 54 2、 DoWebExecute··············································· 54 3、 DoWebExecute2 ············································ 54 4、 AddHTTPHeader············································ 54 5、 HTTPHeaderReset ········································ 55

目 录

2、 软航?，千航?，NTKO?商标说明 ··········· 74

第5章 主要事件参考 ···························· 55

5.1、 文档相关事件 ·············································· 55 1、 AfterOpenFromURL ······································· 55 2、 AfterPublishAsPDFToURL ··························· 55 3、 OnDocumentOpened····································· 55 4、 OnDocumentClosed ······································ 56 5、 OnDocActivated·············································· 56 5.2、 菜单相关事件 ·············································· 56 1、 OnFileCommand ············································ 56 2、 OnCustomMenuCmd2··································· 56 3、 OnCustomMenuCmd[已过时]······················· 57 4、 OnCustomFileMenuCmd ······························ 57 5.3、 安全签章系统相关事件 ······························ 58 1、 OnBeforeDoSecSign ····································· 58 2、 OnBeforeDoSecSignFromEkey ··················· 58 3、 OnSecSignSetInfo ········································· 59 5.4、 签名印章相关事件 ······································ 62 1、 AfterHandSignOrDraw··································· 62 2、 AfterCheckSign··············································· 62 3、 OnSignSelect ·················································· 62 5.5、 WORD及WPS事件 ································· 63 1、 OnWordWPSSelChange······························· 63 2、 OnWordBeforeRightClick······························ 63 5.6、 EXCEL事件 ················································ 63 1、 OnSheetSelectionChange ···························· 63 2、 OnSheetBeforeDoubleClick ························· 63 3、 OnSheetBeforeRightClick····························· 63 5.7、 PPT相关事件 ············································· 64 1、 OnPPTBeforeRightClick ······························· 64

第6章 JavaScript/Jscript代码········ 64

1、 使用JavaScript响应控件事件······················ 64 2、 其他示例请参考 ·············································· 65

第7章 常见问题（FAQs）··················· 65

1、 SaveToURL方法出错···································· 65 2、 如何调用Word自己的对话框？ ··················· 66 3、 如何设置禁止拷贝文档数据？ ······················ 73 4、 如果控件不能运行怎么办？ ·························· 73 5、 如何在