云打印CLodop技術(shù)手冊(cè)

C-Lodop技術(shù)手冊(cè)VerEmail:QQ:夢(mèng)泰爾軟件(中國(guó))MTSoftware(CN)目錄TOC\o"1-3"\h\z一、概述 3二、安裝 5C-Lodop的32位安裝文獻(xiàn)： 5C-Lodop的64位安裝文獻(xiàn)： 5安裝后的運(yùn)行文獻(xiàn)： 5安裝后的設(shè)置窗口 5安裝后的歡迎頁(yè)面 6三、調(diào)用： 8加載云打印JS文獻(xiàn)的簡(jiǎn)樸措施 8動(dòng)態(tài)加載云打印JS文獻(xiàn) 8云打印JS文獻(xiàn)的優(yōu)先級(jí) 8加載多種云打印JS文獻(xiàn) 9獲取LODOP對(duì)象 9四、功能函數(shù) 10Create_Printer_List 10Create_PageSize_List 10On_Return 10On_Return_Remain 11demoCreateCLodopJSscript 11PREVIEW 11五、布署及升級(jí) 13六、特注 15一、概述C-Lodop云打印是夢(mèng)泰爾軟件（MTSoftware）推出的一款精致快捷的云打印服務(wù)產(chǎn)品，以Lodop功能語(yǔ)句為基礎(chǔ)，開(kāi)創(chuàng)了JS語(yǔ)句實(shí)現(xiàn)遠(yuǎn)程打印的先河，為“移動(dòng)設(shè)備+Wifi+一般打印機(jī)+集中打印”奠定了編程基礎(chǔ)。C-Lodop對(duì)客戶(hù)端瀏覽器規(guī)定很低，幾乎支持任何現(xiàn)代瀏覽器，除了Windows平臺(tái)上的Chrome(google)、FireFox(火狐)、Opera、Safari、IE、edge幾大系列及其外殼瀏覽器（如QQ瀏覽器、搜狗、360、UC等等）之外，客戶(hù)端還支持“平板電腦”和“智能手機(jī)(無(wú)需安裝APP)”以及Linux、OS(Mac)上的瀏覽器。C-Lodop可飾演兩種角色，第一種是在Windows客戶(hù)端PC本機(jī)上安裝，從而替代Lodop控件功能，這也是常見(jiàn)基本使用方法；另一種角色是單獨(dú)布署云服務(wù)器，適合后臺(tái)集中打印。在第一種角色中，提議“云打印+控件”組合搭配使用。1）C-Lodop與Lodop搭配示意圖：(圖1)2）C-Lodop獨(dú)立布署示意圖：(圖2)二、安裝C-Lodop的32位安裝文獻(xiàn)：文獻(xiàn)名是CLodopPrint_Setup_for_Win32NT.exe可同步在32位和64位Windows操作系統(tǒng)上安裝，適應(yīng)面較廣。C-Lodop的64位安裝文獻(xiàn)：文獻(xiàn)名是CLodopPrint_Setup_for_Win64NT.exe只能在64位Windows操作系統(tǒng)上安裝，性能較高，適合單獨(dú)布署。安裝后的運(yùn)行文獻(xiàn)：以32位文獻(xiàn)為例： 1、文獻(xiàn)途徑： ProgramFiles(x86)\MountTaiSoftware\CLodop32 2、云打印服務(wù)主文獻(xiàn)： CLodopPrint32.exe 3、免登錄啟動(dòng)服務(wù)文獻(xiàn)： CLodopService32.exe 4、管理設(shè)置文獻(xiàn)： CLodopSetup32.exe 5：樣例目錄 ProgramFiles(x86)\MountTaiSoftware\CLodop32\Rootdir\CLodopDemos樣例中有一種LodopFuncs.js文獻(xiàn)很關(guān)鍵，提議盡量弄懂它。安裝后的設(shè)置窗口正常安裝成功后，首先會(huì)彈出如下提醒窗口：（圖3）這也是管理設(shè)置窗口，后來(lái)可以從Windows如下菜單重新進(jìn)入以上界面。（圖4）在管理設(shè)置界面中，通過(guò)“設(shè)置->端口設(shè)置”菜單進(jìn)入下面的對(duì)話窗口進(jìn)行端口設(shè)置，默認(rèn)端口是8000：（圖5）安裝后的歡迎頁(yè)面點(diǎn)擊以上圖3圈定的按鈕鏈接，進(jìn)入如下歡迎頁(yè)面：（圖6）三、調(diào)用：加載云打印JS文獻(xiàn)的簡(jiǎn)樸措施調(diào)用C-Lodop很簡(jiǎn)樸，在頁(yè)面head中添加如下途徑的js文獻(xiàn)，就可以向其發(fā)打印祈求了，如下幾種例子都可以在歡迎頁(yè)面或Lodopfuncs.js這個(gè)樣例文獻(xiàn)里找到：<scriptsrc=”http://Host地址:8000/CLodopfuncs.js”></script>這里的紅色部分是固定內(nèi)容，Host地址是指安裝C-Lodop的主機(jī)地址，可以是其IP地址或域名，假如是當(dāng)?shù)?第二種角色)打印，該值用localhost、或主機(jī)名替代，端口默認(rèn)是8000(單獨(dú)布署時(shí)，可以自行指定自己的端口），如：<scriptsrc=”:8000/CLodopfuncs.js”></script><scriptsrc=”http://Localhost:8000/CLodopfuncs.js”></script>動(dòng)態(tài)加載云打印JS文獻(xiàn)為了以便控制或兼容老程序，以上靜態(tài)措施可以用如下動(dòng)態(tài)語(yǔ)句替代，效果同樣：varoscript=document.createElement("script");oscript.src="http://localhost:8000/CLodopfuncs.js?priority=1";varhead=document.head||document.getElementsByTagName("head")[0]||document.documentElement;head.insertBefore(oscript,head.firstChild);云打印JS文獻(xiàn)的優(yōu)先級(jí)<scriptsrc=”http://Localhost:8000/CLodopfuncs.js?priority=1”></script>以上引用措施的參數(shù)priority設(shè)置的是優(yōu)先級(jí)，優(yōu)先級(jí)值是從0開(kāi)始的阿拉伯?dāng)?shù)字，數(shù)字越大，優(yōu)先級(jí)越高，默認(rèn)是0。當(dāng)一種頁(yè)面按后續(xù)章節(jié)同步引用多種云主機(jī)時(shí)，優(yōu)先級(jí)設(shè)置很關(guān)鍵，否則會(huì)按下載次序來(lái)處理。加載多種云打印JS文獻(xiàn)<scriptsrc=”http://:8000/CLodopfuncs.js”></script><scriptsrc=”http://Localhost:8000/CLodopfuncs.js?priority=1”></script>假如一種頁(yè)面通過(guò)以上語(yǔ)句同步引用了倆云主機(jī)，那么這個(gè)頁(yè)面既可以讓之外的所有客戶(hù)端通過(guò)該主機(jī)進(jìn)行集中打印，也可以讓那些自身也安裝了C-Lodop的PC電腦上的瀏覽器優(yōu)先通過(guò)自己的C-Lodop進(jìn)行打印，而不是全靠這個(gè)云主機(jī)。這也是C-Lodop默認(rèn)安裝例子演示時(shí)，既可以讓手機(jī)瀏覽器訪問(wèn)，也可以讓電腦訪問(wèn)的神奇原因。獲取LODOP對(duì)象引用以上js文獻(xiàn)后，就可以在頁(yè)面程序里通過(guò)getCLodop(注意：假如C-Lodop與Lodop按圖1搭配使用，要使用Lodopfuncs.js示中的getLodop，其中就包括了getCLodop語(yǔ)句的調(diào)用)函數(shù)獲取主對(duì)象，賦值給一種一般JS變量，為了兼容已經(jīng)開(kāi)發(fā)好的打印程序，仍然統(tǒng)一用LODOP這個(gè)變量名：varLODOP=getCLodop();有了該對(duì)象之后，就可以調(diào)用云打印功能語(yǔ)句了，如LODOP.PRINT();

LODOP.PREVIEW();LODOP.PRINT_DESIGN();更多語(yǔ)句參照背面的功能函數(shù)簡(jiǎn)介。四、功能函數(shù) C-Lodop的功能函數(shù)幾乎涵蓋了Lodop的所有語(yǔ)句，它們的詳細(xì)功能闡明參照《WEB打印控件Lodop技術(shù)手冊(cè)》。除此之外，新增了部分與頁(yè)面整合有關(guān)的函數(shù)和屬性，尚有個(gè)別語(yǔ)句的參數(shù)值有所擴(kuò)展，詳解如下：Create_Printer_List作用：C-Lodop函數(shù)之一，獲得云主機(jī)鏈接的所有打印機(jī)名單，并添加到目前頁(yè)面某個(gè)Select標(biāo)簽元素中格式：Create_Printer_List(oElement);參數(shù)：oElement目的對(duì)象(已經(jīng)存在的某個(gè)Select標(biāo)簽元素)舉例：CLODOP.Create_Printer_List(document.getElementById('Select01'));Create_PageSize_List作用：C-Lodop函數(shù)之一，獲得目的打印機(jī)所擁有的紙張類(lèi)型名單，并添加到目前頁(yè)面某個(gè)Select標(biāo)簽對(duì)象元素中格式：Create_PageSize_List(oElement,iPrintIndex);參數(shù)：oElement目的對(duì)象(已經(jīng)存在的某個(gè)Select標(biāo)簽元素)iPrintIndex目的打印機(jī)在windows系統(tǒng)內(nèi)的序號(hào)(操作系統(tǒng)對(duì)所添加打印機(jī)的次序編號(hào)，從0開(kāi)始)舉例：CLODOP.Create_PageSize_List(document.getElementById('Select03'),2);On_Return作用：C-Lodop屬性之一，設(shè)置那些需要返回成果的動(dòng)作語(yǔ)句在獲得成果時(shí)觸發(fā)的回調(diào)函數(shù)格式：On_Return=function(TaskID,Value){...};闡明：和Lodop相比，C-Lodop的動(dòng)作語(yǔ)句不再立即返回執(zhí)行成果，而是返回一種任務(wù)編號(hào)，頁(yè)面程序在回調(diào)函數(shù)中通過(guò)該編號(hào)來(lái)辨別是哪個(gè)語(yǔ)句返回的成果，并根據(jù)成果值在該回調(diào)函數(shù)中進(jìn)行下一步的處理。參數(shù)：TaskID后續(xù)動(dòng)作語(yǔ)句的任務(wù)編號(hào)，深入?yún)⒄毡趁鍻n_Return_Remain的使用。Value該動(dòng)作語(yǔ)句返回的成果值，類(lèi)型為邏輯真假值或字符串值。舉例：LODOP.On_Return=function(TaskID,Value){if(Value)alert("已發(fā)出實(shí)際打印命令！");elsealert("放棄打?。?);}; LODOP.PRINTA();//這是一種經(jīng)典的動(dòng)作語(yǔ)句On_Return_Remain作用：C-Lodop屬性之一，讓所設(shè)置的回調(diào)函數(shù)持續(xù)保留，對(duì)后續(xù)多種動(dòng)作均有效格式：On_Return_Remain=真假值;闡明：正常狀況下，回調(diào)函數(shù)執(zhí)行完畢后會(huì)自動(dòng)銷(xiāo)毀（也就是本屬性默認(rèn)值是false），而本屬性設(shè)置為真值就可以制止其銷(xiāo)毀，從而讓背面的所有動(dòng)作語(yǔ)句都觸發(fā)同一種回調(diào)函數(shù)，在回調(diào)函數(shù)中用TaskID的值來(lái)辨別是哪個(gè)動(dòng)作觸發(fā)的回調(diào)。舉例：varTaskID1，TaskID2LODOP.On_Return_Remain=true;LODOP.On_Return=function(TaskID,Value){if(TaskID==TaskID1){alert("判斷與否打印成功的成果是："+Value)}elseif(TaskID==TaskID2){alert("判斷打印任務(wù)與否還存在的成果是："+Value)};};TaskID1=LODOP.GET_VALUE("PRINT_STATUS_OK",P_ID); TaskID2=LODOP.GET_VALUE("PRINT_STATUS_EXIST",P_ID);

demoCreateCLodopJSscript名稱(chēng)：C-Lodop經(jīng)典例子函數(shù)之一，在目前頁(yè)面動(dòng)態(tài)引入C-Lodop的js文獻(xiàn)CLodopfuncs.js,引入時(shí)清理掉此前的其他引用，從而唯一選擇云主機(jī)。格式：demoCreateCLodopJSscript(strSrc);參數(shù)：strSrc參數(shù)值為目的云主機(jī)的script標(biāo)簽，其格式為：<scriptsrc='http://Host地址:端口/CLodopfuncs.js'></script>也可以?xún)H是src值部分：http://Host地址:端口//CLodopfuncs.js舉例：demoCreateCLodopJSscript("<scriptsrc=':8000/CLodopfuncs.js'></script>");或demoCreateCLodopJSscript(":8000/CLodopfuncs.js");與前面說(shuō)的在頁(yè)面能同步引用多種云主機(jī)相比，本函數(shù)的動(dòng)態(tài)選擇比較常見(jiàn)，畢竟客戶(hù)輸出的目的打印機(jī)往往是很明確的。PREVIEW作用：打印預(yù)覽語(yǔ)句擴(kuò)展了三個(gè)參數(shù)oView,iW,iH格式：PREVIEW(oView,iW,iH)功能：以某種樣式進(jìn)行打印預(yù)覽。參數(shù)：參數(shù)值及其含義oView：讓預(yù)覽窗口內(nèi)含在目前頁(yè)面內(nèi)（而不是彈窗），這里的“內(nèi)含”不一樣于插件“內(nèi)嵌”模式，深入的內(nèi)含樣式有如下幾種可選：_dialog:彈出對(duì)話框_blank:新窗口_self:在本窗口_top:新窗口_parent:本窗口詳細(xì)ID值:在某個(gè)既有iframe元素內(nèi)（需要提前在頁(yè)面內(nèi)增長(zhǎng)該iframe）iW：預(yù)覽窗口顯示時(shí)的寬度值(px)；iH：預(yù)覽窗口顯示時(shí)的高度值(px)；舉例：LODOP.PREVIEW("_blank");//在新的瀏覽器窗口顯示打印預(yù)覽(注意瀏覽器制止設(shè)置對(duì)其仍然有效)LODOP.PREVIEW("001");//在ID等于“001”的iframe元素內(nèi)顯示打印預(yù)覽升級(jí)Lodop6203發(fā)行包里包括“install_lodop32.exe”、“install_lodop64.exe”、“CLodopPrint_Setup_for_Win32NT.exe”這3個(gè)安裝文獻(xiàn)和50個(gè)小例子及其JS文獻(xiàn)。文獻(xiàn)“CLodopPrint_Setup_for_Win32NT.exe”是云打印“C-Lodop”的主安裝文獻(xiàn)，假如是配合布署需三個(gè)文獻(xiàn)（見(jiàn)圖1），假如單獨(dú)布署只需這一種文獻(xiàn)。由于云打印兼容控件老式語(yǔ)句，因此開(kāi)發(fā)者要把自己的web系統(tǒng)由Lodop6.1xx升級(jí)到新版本(6.2xx+云打印)還是比較輕易的，升級(jí)重要環(huán)節(jié)有三個(gè)：第一、更新Lodopfuncs.js這個(gè)文獻(xiàn)。這雖說(shuō)是一種js例子，但對(duì)多數(shù)人來(lái)說(shuō)最佳直接使用它，此前已經(jīng)自行編寫(xiě)getLodop過(guò)程的開(kāi)發(fā)者需要理解本次變化后充實(shí)改善一下。其變化重要是增長(zhǎng)了判斷哪些瀏覽器調(diào)用老式控件，哪些瀏覽器調(diào)用C-Lodop云打印，并動(dòng)態(tài)添加支持云打印的新js文獻(xiàn)。 假如升級(jí)為全面采用云打?。ú辉偈褂每丶?，即單獨(dú)布署C-Lodop云打印,可修改如下函數(shù)直接返回true源代碼如下（注意紅色代碼變化）：//====判斷與否需要安裝CLodop云打印服務(wù)器:====functionneedCLodop(){try{ varua=navigator.userAgent; if(ua.match(/Windows\sPhone/i)!=null)returntrue; if(ua.match(/iPhone|iPod/i)!=null)returntrue; };returnfalse;}catch(err){returntrue;};};修改后如下：//====判斷與否需要安裝CLodop云打印服務(wù)器:====functionneedCLodop(){try{ returntrue;}catch(err){returntrue;};};第二、C-Lodop