點(diǎn)聚WebOffice開(kāi)發(fā)接口SDK及其開(kāi)發(fā)指南

1、點(diǎn)聚WebOffice開(kāi)發(fā)接口 SDK及其開(kāi)發(fā)指南文檔編制序號(hào)：KKIDT-LLE0828-LLETD298-POI08WebOffice文檔控件開(kāi)發(fā)文檔北京點(diǎn)聚信息技術(shù)有限公司2008/05/08北京點(diǎn)聚信息技術(shù)有限公司（以下簡(jiǎn)稱“點(diǎn)聚”）盡最大努力使這篇文章中的內(nèi)容完善且 正確二點(diǎn)聚對(duì)于由這篇文檔導(dǎo)致的任何形式的直接或間接損失不負(fù)有責(zé)任。這篇文章的內(nèi) 容會(huì)跟隨產(chǎn)品的升級(jí)而有所變化。標(biāo)記名稱：WebOffice開(kāi)發(fā)文檔狀態(tài)：發(fā)布部門：研發(fā)部文檔 ID:WebOffice-Ol-OOl更新記錄版本時(shí)間 備注2009-081 .增加了 “2007屬性，判斷當(dāng)前版本是否0ffice2007。2 .

2、增加了 IContinue屬性，可以在Word、excel事件處理中終 止該事件操作。3 .增加了 HideMenuAction方法，能夠?qū)?ffice2007菜單進(jìn)行 控制。4 .修改了新建、打開(kāi)文檔閃的問(wèn)題?，F(xiàn)在直接打開(kāi)，沒(méi)有閃 爍。5 .修改了 EXCEL打開(kāi)無(wú)菜單項(xiàng)的BUG2009-026 .增加了工具欄按鈕事件7 .擴(kuò)展了 GetDocumentObject 接口導(dǎo)出 PPT 的QISPPT:Presentation對(duì)象8 .增加SaveAsPDF方法，無(wú)須安裝Adobe即可直接輸出PDF9 .增加IsModify屬性，判斷文檔是否修改10 .增加GetFileSize方法，判斷文檔

3、的大小11 .增加了譚。rd中的事件捕獲。2008-101 .增加了工具欄2 .增加了 WPS的支持3 .增加了上傳文件的壓縮和加密2008-051 .設(shè)置了對(duì)文檔安全的控制2 .清除了對(duì)Word模板的修改b008-03L支持自定義的菜單.并跟Javascript綁定2007-101 .可以設(shè)置文檔打開(kāi)密碼和可寫密碼，支持Word、Excel2 .設(shè)置Word中的變量，可以更新關(guān)聯(lián)的域3 .擴(kuò)展了這個(gè)接口，支持Http下的相對(duì)路徑軟件開(kāi)發(fā)協(xié)議北京點(diǎn)聚信息技術(shù)有限公司（以下簡(jiǎn)稱點(diǎn)聚）的所有產(chǎn)品，包括但不限于：開(kāi)發(fā)工具 包，磁盤，光盤，硬件設(shè)備和文檔，以及未來(lái)的所有定單都受本協(xié)議的制約。如果您不愿

4、 接受這些條款，請(qǐng)?jiān)谑盏胶蟮?天內(nèi)將開(kāi)發(fā)工具包寄回點(diǎn)聚，預(yù)付郵資和保險(xiǎn)。我們會(huì)把 貨款退還給您，但要扣除運(yùn)費(fèi)和適當(dāng)?shù)氖掷m(xù)費(fèi)。1 .許可使用您可以將本軟件合并、連接到您的計(jì)算機(jī)程序中，但其目的只是如開(kāi)發(fā)指南中描 述的那樣保護(hù)該程序。您可以以存檔為目的復(fù)制合理數(shù)量的拷貝。2 .禁止使用除在條款1中特別允許的之外，不得復(fù)制、反向工程、反匯編、反編譯、修改、 增加、改進(jìn)軟件、硬件和產(chǎn)品的其它部分。禁止對(duì)軟件和產(chǎn)品的任何部分進(jìn)行反向工 程，或企圖推導(dǎo)軟件的源代碼。禁止使用產(chǎn)品中的磁性或光學(xué)介質(zhì)來(lái)傳遞、存儲(chǔ)非本 產(chǎn)品的原始程序或由點(diǎn)聚提供的產(chǎn)品升級(jí)的任何數(shù)據(jù)。禁止將軟件放在服務(wù)器上傳 播。3 .有限擔(dān)保點(diǎn)

5、聚保證在自產(chǎn)品交給您之日起的12個(gè)月內(nèi)，在正常的使用情況下，硬件和軟件 存儲(chǔ)介質(zhì)沒(méi)有重大的工藝和材料上的缺陷。4 .修理限度當(dāng)根據(jù)本協(xié)議提出索賠時(shí)，點(diǎn)聚唯一的責(zé)任就是根據(jù)點(diǎn)聚的選擇，免費(fèi)進(jìn)行替換 或維修。點(diǎn)聚對(duì)更換后的任何產(chǎn)品部件都享有所有權(quán)。保修索賠單必須在擔(dān)保期內(nèi)寫好，在發(fā)生故障14天內(nèi)連同令人信服的證據(jù)交給點(diǎn) 聚。當(dāng)將產(chǎn)品返還給點(diǎn)聚或點(diǎn)聚的授權(quán)代理商時(shí)，須預(yù)付運(yùn)費(fèi)和保險(xiǎn)。除了在本協(xié)議中保證的擔(dān)保之外，點(diǎn)聚不再提供特別的或隱含的擔(dān)保，也不再對(duì) 本協(xié)議中所描述的產(chǎn)品負(fù)責(zé)，包括它們的質(zhì)量，性能和對(duì)某一特定目的的適應(yīng)性。 5.責(zé)任限度不管因?yàn)槭裁丛?，不管是因合同中的?guī)定還是由于刑事的原因，包括

6、疏忽的原 因，而使您及任何一方受到了損失，由我方產(chǎn)品所造成的損失或該產(chǎn)品是起訴的原因 或與起訴有間接關(guān)系，點(diǎn)聚對(duì)您及任何一方所承擔(dān)的全部責(zé)任不超出您購(gòu)買該產(chǎn)品所 支付的貨款。在任何情況下，點(diǎn)聚對(duì)于由于您不履行責(zé)任所導(dǎo)致的損失，或?qū)τ跀?shù) 據(jù)、利潤(rùn)、儲(chǔ)蓄或其它的后續(xù)的和偶然的損失，即使點(diǎn)聚被建議有這種損失的可能 性，或您根據(jù)第3方的索賠而提出的任何索賠均不負(fù)責(zé)任。6 .協(xié)議終止當(dāng)您不能遵守本協(xié)議所規(guī)定的條款時(shí)，將終止您的許可和本協(xié)議。但條款2, 3,4, 5將繼續(xù)有效。7.針對(duì)WebOffice的特別條款WebOffice為免費(fèi)版本軟件，可以使用于個(gè)人開(kāi)發(fā)和商業(yè)用途中。點(diǎn)聚將提供有 限的技術(shù)服務(wù)。

7、一、工作原理點(diǎn)聚WebOffice是基于客戶端的“X控件，它的功能是將Office文檔(Word. Excel、WPS)嵌入到瀏覽器中，并調(diào)用Office中各種接口，完成文檔 編輯工作，然后使用控件的Http接口模擬表單提交，發(fā)送到數(shù)據(jù)處理頁(yè)面(此 文檔舉例為頁(yè)，代碼見(jiàn)演示文件)，完成文檔的存檔工作。1.1開(kāi)發(fā)流程 裝載控件. . . F觸發(fā)初始化方法! W ebOf f i c e1_No t i fyCt r1Re ady() AboutBox ();2. 1. 1A cceptAHRe vi si ons原 型：long AcceptAllRevisions ();功 能：接受當(dāng)前文檔所

8、有修訂返回值：0：接受修訂成功非零：接受修訂失敗示例：.AcceptAllRevisions();2.1. 2 AddMenu原 形：AddMenu (LPCTSTR cMenuName, LPCTSTR cChildName, longiIndex, LPCTSTR cBindJSFun)功能：(保留)參數(shù)：返回值：示例：2.1. 3 BookMarkOpt原 型：long BookMarkOpt(BSTR strBookMarks, long IType);功 能：獲取文檔書簽列表(保留)參數(shù)：返回值：示例：2.1. 4Clos eDoc原 型：long CloseDoc(long blR

9、eqSaved);功能：關(guān)閉當(dāng)前文檔參數(shù)：blReqSaved：0：關(guān)閉文檔，不保存當(dāng)前修改。1 ：關(guān)閉文檔，保存當(dāng)前修改。2 ：如果文檔已經(jīng)被修改,顯示保存文檔對(duì)話框,否則直接關(guān)閉。其它：關(guān)閉文檔，保存當(dāng)前修改。返回值:失敗非零： 成功示例：=vType;delete obj;2.1. 5 GetFieldValue原 型：BSTR GetFieldValue(BSTR strFieldName, BSTR strSheetName);功 能：獲得書簽位置的數(shù)值參數(shù)：strFieldName ：書簽的名字strSheetName ：預(yù)留字段(值為空)返回值：返回書簽的值示例：取修訂的用戶vU

10、serName =取修訂的時(shí)間vDate = new String獲取修訂的動(dòng)作var vRet=二：表示插入的操作vRet = 2：表示刪除的操作取修訂的內(nèi)容vUserName =總體的例子代碼var vCount;var vOpt = 0;var vDate;for (var i=l; i= vCount; i+) vOpt = dif(1 = vOpt)vOpt = 插入；)else if (2 = vOpt)vOpt =刪除；elsevOpt = 未知操作；)vDate = parseFloat(vDate);dateObj = new Date(vDate);alert ()+ 年

11、+ () + 1 + 月 + () +曰 + () + 時(shí) + ()+分+ 0 + 秒)；2.2. 6 GetFileSize原 型：long GetFileSize (LPCTSTR strFilePath);功 能：獲取本地文件的大小參數(shù)：返回值：示例：var vLen = (c：);2. 1. 7Ge tBookMarkCoun t原 型：long GetBookMarkCount();功 能：獲取文檔中書簽的總數(shù)量參數(shù)：返回值：示例：GetFileSize2. 1. 8Ge tBookMarklnfo原 型：BSTR GetBookMarklnfo(long 1Index, long

12、IType);功 能：獲取各書簽的信息(名稱和變量)參數(shù)：返回值：示例：var vBKCount;var iIndex;var vName;var vValue;var vShowInfo;vShowInfo =for(ilndex = 1; iIndex = vBKCount; ilndex+)vShowInfo += BK+iIndex+：+vName+=+vValue+”;、T vName =;vValue =alert (vShowInfo);ttpInitO ;2. 1. 9Ht tpA ddPos tFil e原 型：long HttpAddPostFile (BSTR strNa

13、me, BSTR strFile);功能：Http上傳相關(guān)(保留)返回值：示例：ttpAddPostFileClll*, *c：W)2.1.10 HttpAddPostBuffer原 型：long HttpAddPostBuffer(BSTR strName, BSTR strRelateFile, BSTR pbBuffer, long ILen);功 能：Http上傳相關(guān)(保留)參數(shù)：返回值：示例：2.1.11 HttpAddPost Vai ue原 型：long HttpAddPostValue(BSTR strName, long IValue);功 能：Http上傳相關(guān)(保留)參數(shù)：

14、返回值：示例：2.1.12 Ht tpA ddPos tS tring原 型：long HttpAddPostString(BSTR strName, BSTR strValue);功 能：添加要上傳的表單域參數(shù)：strName：表單域的名稱strValue ：表單域的值返回值:示例：者Ftp路徑nCurPos :位置和圖片控制符。nCurPos或者nCurPos -80：當(dāng)前位置1：文件開(kāi)頭2：文件末尾如果第四位為1:表示插入的是圖片返回值：0 ：正確其他：錯(cuò)誤示例：者Ftp路徑nCurPos :位置和圖片控制符。nCurPos或者nCurPos-80：當(dāng)前位置1：文件開(kāi)頭2:文件末尾如果第

15、四位為1:表示插入的是圖片返回值：0：插入成功非。：插入失敗pcType:doc:打開(kāi)、新建Word文件 xls:打開(kāi)、新建Excel文件PPt:打開(kāi)、新建PPT文件 wps:打開(kāi)、新建WPS文件返回值：0 ：失敗非0：成功示例：id=8， doc)； rintDoc (1);2. L 13 PutSaved原 型：long PutSaved(boolean bSaved);功 能：設(shè)置當(dāng)前文檔的修改狀態(tài)參數(shù)：0：處于修改狀態(tài) 1:處于保存狀態(tài)返回值：示例：(Standard”, 1, 1);(Standard”, 1,4);(Formatting。1, 1);(Formatting”, 1,

16、 4);HideMenuAction(1, 4096) ;HideMenuAction(5, 0) ;HideMenuAction(1, 4096);.HideMenuAction(5, 0);H i deMenuAc t i on(1,1048576);.HideMenuAction(5,0);HideMenuActiond, 1048576+2097152+4194304);.HideMenuAction(5, 0);HideMenuAction(6, 0);2. 1. 14 SetCurrTime原 型：short SetCurrTime (BSTR dateAndTime);功 能：設(shè)

17、置客戶端的修訂時(shí)間，防止客戶端和服務(wù)端的時(shí)間誤差參數(shù)：dateAndTime ：參數(shù)的形式必須為yyyymm-dd hh-mm-ss的形式返回值：示例：-02-07 11:11:11*)；2. 1.15 SetKeyCtrl原 型：long SetKeyCtrl(long ICtrl, long IChar, long IType);功能：屏蔽、運(yùn)行Office的快捷鍵參數(shù)：ICtrl ：要屏蔽、運(yùn)行的快捷鍵的值。Ctrl=512 Shift=256Alt=1024例：Ctrl + S = 512 + 83 (大寫 S 的 ASCII 碼值)二 595例：Ctrl + 0 = 512 + 79

18、 = 591例：Ctrl + Shift + E = 512 + 256 + 69 = 837注意：字母使用大寫的ASCII碼值IChar ：控制類型L -1 ：屏蔽快捷鍵L 1:執(zhí)行快捷鍵命令u 0：恢復(fù)快捷鍵lTyp：擴(kuò)展接口，目前暫設(shè)為0返回值：示例：nProtectDoc (“12345);2.1.16 ZipFile原 型：short ZipFile (BSTR cSourceFile, BSTR cAimFile, long wFileType, long bEnc);功能：壓縮文檔(保留)參數(shù)：返回值：2.2屬性2. 2.1 DocType原 型：long DocType;說(shuō)明：

19、文件類型，只讀數(shù)值：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 = 1272. 2. 2 Version原型：BSTR Version;說(shuō) 明：打開(kāi)文件的版本號(hào)，只讀數(shù)值：2. 2. 3 AppVersion原 型：BSTR Version;說(shuō) 明：打開(kāi)文件的版本號(hào)，只讀數(shù)值：2. 2. 41 Event Ret原型：BOOL LEvent

20、Ret;說(shuō) 明：見(jiàn)事件NotifyToolBarClick事件數(shù)值：2.2.5 IsModify原型：BOOL IsModify;說(shuō) 明：判斷文檔是否被修改，需要在LoadOrigarFile之前設(shè)置 OptionFlag |= 0x0400 才有效。2. 2. 6 ShowToolBar原 型：BOOL ShowToolBar;說(shuō) 明：是否顯示工具欄。數(shù)值：1 ：顯示工具欄；0：隱藏工具欄2. 2. 7 OptionFlag原 型：long OptionFlag;說(shuō)明：系統(tǒng)標(biāo)志位，可讀寫。此屬性比較重要，可以作為各種控制開(kāi) 關(guān)。數(shù)值：OPTIONFLAG_WORD_07SAVETO030x0

21、00 l（0ffice2007 保存為兼容格式）OPTIONFLAG_EXCEL_07SAVETO03 0x0002（0ffice2007 保存為兼容格式）OPTIONFLAG.HTTPSAVEENC0x0004（HttpPost 時(shí)候文件加密壓縮）OPTIONFLAG_SETFILEDVALUE0x0008（書簽操作后刪除蓋書簽）OPTIONFLAG_NODELWORDNORMAL 0x0010（清除 Word 的模板文件）OPTIONFLAG.NOENCOUDEURL0x0020（設(shè)置 URL 的是否 UTF8 編碼）OPTIONFLAG_SHOWPRESS0x0080（是否顯示進(jìn)度條）OPTIONFLAG.DOCSHA10x0400（設(shè)置此項(xiàng)貝Modify 有效）示例：用LoadOriginalFile打開(kāi)URL上路徑的時(shí)候上傳和下載的時(shí)候上傳時(shí)候設(shè)置是否對(duì)文件加密和壓縮定義事件處理函數(shù),通過(guò)接口把文件和表單元素發(fā)送到保 存記錄的頁(yè)面(過(guò)程類似表單的提交)O 主要上傳接口： HttpInitQ;該方法用于初始化上傳接口，不需要設(shè)置參數(shù) HttpAddPostString(String FieldName, String someValue);添加要提交的裝單域,FieldName是要上彳專表單域名稱，someVakie是表 單域值例一：HttpAddPostStri