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

C-Lodop技術(shù)手冊(cè)VerEmail:QQ:夢(mèng)泰爾軟件(中國)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安裝后的歡迎頁面 6三、調(diào)用： 8加載云打印JS文獻(xiàn)的簡樸辦法 8動(dòng)態(tài)加載云打印JS文獻(xiàn) 8云打印JS文獻(xiàn)的優(yōu)先級(jí) 8加載多個(gè)云打印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功效語句為基礎(chǔ)，開創(chuàng)了JS語句實(shí)現(xiàn)遠(yuǎn)程打印的先河，為“移動(dòng)設(shè)備+Wifi+普通打印機(jī)+集中打印”奠定了編程基礎(chǔ)。C-Lodop對(duì)客戶端瀏覽器規(guī)定很低，幾乎支持任何當(dāng)代瀏覽器，除了Windows平臺(tái)上的Chrome(谷歌)、FireFox(火狐)、Opera、Safari、IE、edge幾大系列及其外殼瀏覽器（如QQ瀏覽器、搜狗、360、UC等等）之外，客戶端還支持“平板電腦”和“智能手機(jī)(無需安裝APP)”以及Linux、OS(Mac)上的瀏覽器。C-Lodop可扮演兩種角色，第一種是在Windows客戶端PC本機(jī)上安裝，從而替代Lodop控件功效，這也是常見基本使用方法；另一種角色是單獨(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可同時(shí)在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)很核心，建議盡量弄懂它。安裝后的設(shè)立窗口正常安裝成功后，首先會(huì)彈出以下提示窗口：（圖3）這也是管理設(shè)立窗口，后來能夠從Windows以下菜單重新進(jìn)入以上界面。（圖4）在管理設(shè)立界面中，通過“設(shè)立->端口設(shè)立”菜單進(jìn)入下面的對(duì)話窗口進(jìn)行端口設(shè)立，默認(rèn)端口是8000：（圖5）安裝后的歡迎頁面點(diǎn)擊以上圖3圈定的按鈕鏈接，進(jìn)入以下歡迎頁面：（圖6）三、調(diào)用：加載云打印JS文獻(xiàn)的簡樸辦法調(diào)用C-Lodop很簡樸，在頁面head中添加以下途徑的js文獻(xiàn)，就能夠向其發(fā)打印請(qǐng)求了，以下幾個(gè)例子都能夠在歡迎頁面或Lodopfuncs.js這個(gè)樣例文獻(xiàn)里找到：<scriptsrc=”http://Host地址:8000/CLodopfuncs.js”></script>這里的紅色部分是固定內(nèi)容，Host地址是指安裝C-Lodop的主機(jī)地址，能夠是其IP地址或域名，如果是本地(第二種角色)打印，該值用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)語句替代，效果同樣：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開始的阿拉伯?dāng)?shù)字，數(shù)字越大，優(yōu)先級(jí)越高，默認(rèn)是0。當(dāng)一種頁面按后續(xù)章節(jié)同時(shí)引用多個(gè)云主機(jī)時(shí)，優(yōu)先級(jí)設(shè)立很核心，否則會(huì)按下載次序來解決。加載多個(gè)云打印JS文獻(xiàn)<scriptsrc=”http://:8000/CLodopfuncs.js”></script><scriptsrc=”http://Localhost:8000/CLodopfuncs.js?priority=1”></script>如果一種頁面通過以上語句同時(shí)引用了倆云主機(jī)，那么這個(gè)頁面既能夠讓之外的全部客戶端通過該主機(jī)進(jìn)行集中打印，也能夠讓那些本身也安裝了C-Lodop的PC電腦上的瀏覽器優(yōu)先通過自己的C-Lodop進(jìn)行打印，而不是全靠這個(gè)云主機(jī)。這也是C-Lodop默認(rèn)安裝例子演示時(shí)，既能夠讓手機(jī)瀏覽器訪問，也能夠讓電腦訪問的神奇因素。獲取LODOP對(duì)象引用以上js文獻(xiàn)后，就能夠在頁面程序里通過getCLodop(注意：如果C-Lodop與Lodop按圖1搭配使用，要使用Lodopfuncs.js示中的getLodop，其中就包含了getCLodop語句的調(diào)用)函數(shù)獲取主對(duì)象，賦值給一種普通JS變量，為了兼容已經(jīng)開發(fā)好的打印程序，仍然統(tǒng)一用LODOP這個(gè)變量名：varLODOP=getCLodop();有了該對(duì)象之后，就能夠調(diào)用云打印功效語句了，如LODOP.PRINT();

LODOP.PREVIEW();LODOP.PRINT_DESIGN();更多語句參考背面的功效函數(shù)介紹。四、功效函數(shù) C-Lodop的功效函數(shù)幾乎涵蓋了Lodop的全部語句，它們的具體功效闡明參考《WEB打印控件Lodop技術(shù)手冊(cè)》。除此之外，新增了部分與頁面整合有關(guān)的函數(shù)和屬性，尚有個(gè)別語句的參數(shù)值有所擴(kuò)展，詳解以下：Create_Printer_List作用：C-Lodop函數(shù)之一，獲得云主機(jī)鏈接的全部打印機(jī)名單，并添加到現(xiàn)在頁面某個(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ī)所擁有的紙張類型名單，并添加到現(xiàn)在頁面某個(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開始)舉例：CLODOP.Create_PageSize_List(document.getElementById('Select03'),2);On_Return作用：C-Lodop屬性之一，設(shè)立那些需要返回成果的動(dòng)作語句在獲得成果時(shí)觸發(fā)的回調(diào)函數(shù)格式：On_Return=function(TaskID,Value){...};闡明：和Lodop相比，C-Lodop的動(dòng)作語句不再立刻返回執(zhí)行成果，而是返回一種任務(wù)編號(hào)，頁面程序在回調(diào)函數(shù)中通過該編號(hào)來分辨是哪個(gè)語句返回的成果，并根據(jù)成果值在該回調(diào)函數(shù)中進(jìn)行下一步的解決。參數(shù)：TaskID后續(xù)動(dòng)作語句的任務(wù)編號(hào)，進(jìn)一步參考背面On_Return_Remain的使用。Value該動(dòng)作語句返回的成果值，類型為邏輯真假值或字符串值。舉例：LODOP.On_Return=function(TaskID,Value){if(Value)alert("已發(fā)出實(shí)際打印命令！");elsealert("放棄打?。?);}; LODOP.PRINTA();//這是一種典型的動(dòng)作語句On_Return_Remain作用：C-Lodop屬性之一，讓所設(shè)立的回調(diào)函數(shù)持續(xù)保存，對(duì)后續(xù)多個(gè)動(dòng)作都有效格式：On_Return_Remain=真假值;闡明：正常狀況下，回調(diào)函數(shù)執(zhí)行完畢后會(huì)自動(dòng)銷毀（也就是本屬性默認(rèn)值是false），而本屬性設(shè)立為真值就能夠制止其銷毀，從而讓背面的全部動(dòng)作語句都觸發(fā)同一種回調(diào)函數(shù)，在回調(diào)函數(shù)中用TaskID的值來分辨是哪個(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名稱：C-Lodop典型例子函數(shù)之一，在現(xiàn)在頁面動(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>也能夠僅是src值部分：http://Host地址:端口//CLodopfuncs.js舉例：demoCreateCLodopJSscript("<scriptsrc=':8000/CLodopfuncs.js'></script>");或demoCreateCLodopJSscript(":8000/CLodopfuncs.js");與前面說的在頁面能同時(shí)引用多個(gè)云主機(jī)相比，本函數(shù)的動(dòng)態(tài)選擇比較常見，畢竟客戶輸出的目的打印機(jī)往往是很明確的。PREVIEW作用：打印預(yù)覽語句擴(kuò)展了三個(gè)參數(shù)oView,iW,iH格式：PREVIEW(oView,iW,iH)功效：以某種樣式進(jìn)行打印預(yù)覽。參數(shù)：參數(shù)值及其含義oView：讓預(yù)覽窗口內(nèi)含在現(xiàn)在頁面內(nèi)（而不是彈窗），這里的“內(nèi)含”不同于插件“內(nèi)嵌”模式，進(jìn)一步的內(nèi)含樣式有以下幾個(gè)可選：_dialog:彈出對(duì)話框_blank:新窗口_self:在本窗口_top:新窗口_parent:本窗口具體ID值:在某個(gè)現(xiàn)有iframe元素內(nèi)（需要提前在頁面內(nèi)增加該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)（見圖1），如果單獨(dú)布署只需這一種文獻(xiàn)。由于云打印兼容控件傳統(tǒng)語句，因此開發(fā)者要把自己的web系統(tǒng)由Lodop6.1xx升級(jí)到新版本(6.2xx+云打印)還是比較容易的，升級(jí)重要環(huán)節(jié)有三個(gè)：第一、更新Lodopfuncs.js這個(gè)文獻(xiàn)。這雖說是一種js例子，但對(duì)多數(shù)人來說最佳直接使用它，以前已經(jīng)自行編寫getLodop過程的開發(fā)者需要理解本次變化后充實(shí)改善一下。其變化重要是增加了判斷哪些瀏覽器調(diào)用傳統(tǒng)控件，哪些瀏覽器調(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-Lod