Lodop技術手冊

1、WEB打印控件Lodop技術手冊Ver 6.1.1.8Email: QQ: 932131686夢泰爾軟件工作室MTSoftware(CN)目 錄一、概述3二、系統(tǒng)文件4install_lodop.exe4LodopFuncs.js5三、控件參數(shù)7Caption7Color7Border7四、功能函數(shù)71、基本函數(shù)8VERSION8PRINT_INIT8SET_PRINT_PAGESIZE8ADD_PRINT_HTM9ADD_PRINT_TABLE10ADD_PRINT_URL12ADD_PRINT_TEXT12ADD_PRINT_IMAGE13ADD_PRINT_RECT14ADD_PRINT

2、_ELLIPSE15ADD_PRINT_LINE15ADD_PRINT_BARCODE16ADD_PRINT_CHART17SET_PRINT_STYLE18PREVIEW20PRINT20PRINT_SETUP20PRINT_DESIGN21NEWPAGE21GET_PRINTER_COUNT21GET_PRINTER_NAME22SET_PRINTER_INDEX22SELECT_PRINTER22SET_SHOW_MODE23SET_PRINT_MODE26SET_PRINT_COPIES27SET_PREVIEW_WINDOW27ADD_PRINT_SETUP_BKIMG28SEND_

3、PRINT_RAWDATA28WRITE_PORT_DATA28READ_PORT_DATA29GET_PRINT_INIFFNAME29GET_PAGESIZES_LIST30WRITE_FILE_TEXT30GET_FILE_TEXT30GET_FILE_TIME31IS_FILE_EXIST31GET_SYSTEM_INFO31GET_VALUE32FORMAT35GET_DIALOG_VALUE362、擴展函數(shù)37PRINT_INITA37ADD_PRINT_HTML37ADD_PRINT_TBURL38ADD_PRINT_TEXTA38SET_PRINT_STYLEA38SAVE_T

4、O_FILE42SET_SAVE_MODE42ADD_PRINT_SHAPE44SET_PRINTER_INDEXA45NEWPAGEA45PREVIEWA46PREVIEWB46PRINTA46PRINTB46SHOW_CHART47DO_ACTION47SET_LICENSES48五、軟件使用權注冊48CompanyName48License49LicenseA49LicenseB49六、打印維護和打印設計49七、使用樣例50八、計量單位51一、概述Lodop是一款專業(yè)的WEB打印控件，其設計目標是簡單易用、功能足夠強大，開創(chuàng)WEB打印開發(fā)的新局面。Lodop設計者對WEB下的打印開發(fā)任務

5、進行了分類匯總，高度抽象，設計出僅用幾個功能函數(shù)，就可實現(xiàn)復雜的打印任務，盡量減少使用者的知識累贅?？丶l(fā)布包有3個系統(tǒng)文件組成，全部功能用幾個控件參數(shù)和2組功能函數(shù)來實現(xiàn)。盡管我們有個理想化的目標，那就是您不用詳細了解這些參數(shù)或函數(shù)，僅僅看懂幾個樣例文件就能很輕松地開始使用本控件，為此Lodop提供了一個足夠完善的設計界面，用它可以實現(xiàn)大多數(shù)打印開發(fā)任務，但事實上了解這些參數(shù)和函數(shù)總還是有好處的，特別是當您的開發(fā)任務很復雜時，這就是本文目的，但愿本文檔足夠詳細且簡單明了。如果此前曾看過lodop的入門樣例程序，本文會更容易理解！二、系統(tǒng)文件Lodop發(fā)布包內主要有如下幾個文件：install

6、_lodop.exe該文件是控件安裝和升級的主文件，有install_lodop32.exe(適用于32位瀏覽器)和install_lodop64.exe(適用于64位瀏覽器)兩個程序，提供給用戶或開發(fā)者下載安裝，如果不特意攔截一般都能100%安裝，對“網(wǎng)頁插件安裝難”有徹底改善。如果將其復制或改名為uninstall_lodop32.exe (名前加un)就可用其卸載控件。Lodop安裝后，在操作系統(tǒng)Program FilesMountTaiSoftwareLodop目錄下會生成兩個實體文件：CAOSOFT_WEB_PRINT_LODOP.OCX和NPCAOSOFT_WEB_PRINT_LO

7、DOP.DLL前一個文件是OCX文件，后者是NPplugin文件，其作用是實現(xiàn)多瀏覽器支持。目前Lodop支持IE系列、IE內核系列(遨游、360、世界之窗、騰訊TT、搜狗等)瀏覽器，以及Firefox(火狐)系列、Chrome(谷歌)系列、Opera系列、Safari系列等Windows下幾乎所有的瀏覽器。安裝程序文件有幾個預定參數(shù)：-waitXX 該參數(shù)設置安裝程序運行完畢后自動關閉窗口，這里的XX表示關閉前等待的秒數(shù)，如果是0秒則安裝（或卸載）成功后立即關閉，例如： wait8-nowindow 該參數(shù)設置安裝程序運行時不出現(xiàn)窗口。-un 該參數(shù)使程序執(zhí)行卸載操作，參數(shù)優(yōu)先于文件名。-i

8、n 該參數(shù)使程序執(zhí)行安裝操作，參數(shù)優(yōu)先于文件名。安裝界面如下：LodopFuncs.js該文件是用來引導安裝控件的一個JS文件，是個樣例，但建議直接采用。其中getLodop的任務是判斷當前瀏覽器的類型并決定采用哪個對象實例，并檢測控件是否安裝、是否最新版本、并引導安裝或升級。文件內容如下：function getLodop(oOBJECT,oEMBED)/* 本函數(shù)根據(jù)瀏覽器類型決定采用哪個對象作為控件實例： IE系列、IE內核系列的瀏覽器采用oOBJECT， 其它瀏覽器(Firefox系列、Chrome系列、Opera系列、Safari系列等)采用oEMBED, 對于64位瀏覽器指向64位

9、的安裝程序install_lodop64.exe。*/var strHtmInstall="<br><font color='#FF00FF'>打印控件未安裝!點擊這里<a href='install_lodop32.exe'>執(zhí)行安裝</a>,安裝后請刷新頁面或重新進入。</font>"var strHtmUpdate="<br><font color='#FF00FF'>打印控件需要升級!點擊這里<a href='i

10、nstall_lodop32.exe'>執(zhí)行升級</a>,升級后請重新進入。</font>"var strHtm64_Install="<br><font color='#FF00FF'>打印控件未安裝!點擊這里<a href='install_lodop64.exe'>執(zhí)行安裝</a>,安裝后請刷新頁面或重新進入。</font>"var strHtm64_Update="<br><font color=&#

11、39;#FF00FF'>打印控件需要升級!點擊這里<a href='install_lodop64.exe'>執(zhí)行升級</a>,升級后請重新進入。</font>"var strHtmFireFox="<br><br><font color='#FF00FF'>注意：<br>1：如曾安裝過Lodop舊版附件npActiveXPLugin,請在【工具】->【附加組件】->【擴展】中先卸它。" var LODOP=oEMBED;t

12、ry if (navigator.appVersion.indexOf("MSIE")>=0) LODOP=oOBJECT; if (LODOP=null)|(typeof(LODOP.VERSION)="undefined") if (navigator.userAgent.indexOf('Firefox')>=0) document.documentElement.innerHTML=strHtmFireFox+document.documentElement.innerHTML; if (navigator.userA

13、gent.indexOf('Win64')>=0) if (navigator.appVersion.indexOf("MSIE")>=0) document.write(strHtm64_Install); else document.documentElement.innerHTML=strHtm64_Install+document.documentElement.innerHTML; else if (navigator.appVersion.indexOf("MSIE")>=0) document.write(

14、strHtmInstall); else document.documentElement.innerHTML=strHtmInstall+document.documentElement.innerHTML; return LODOP; else if (LODOP.VERSION<"6.1.0.9") if (navigator.userAgent.indexOf('Win64')>=0) if (navigator.appVersion.indexOf("MSIE")>=0) document.write(strH

15、tm64_Update); else document.documentElement.innerHTML=strHtm64_Update+document.documentElement.innerHTML; else if (navigator.appVersion.indexOf("MSIE")>=0) document.write(strHtmUpdate); else document.documentElement.innerHTML=strHtmUpdate+document.documentElement.innerHTML; return LODOP

16、; /*如下空白位置適合調用統(tǒng)一功能:* /* return LODOP; catch(err)if (navigator.userAgent.indexOf('Win64')>=0)document.documentElement.innerHTML="Error:"+strHtm64_Install+document.documentElement.innerHTML;elsedocument.documentElement.innerHTML="Error:"+strHtmInstall+document.documentEl

17、ement.innerHTML; return LODOP; 其中的關鍵點是VERSION函數(shù)，Lodop提供了這個“讀版本號”功能，這樣控件的安裝和升級任務就交給JS來實現(xiàn)，以下是控件在頁面內的調用代碼，其中包含getLodop的使用：<head><title></title><script language="javascript" src="LodopFuncs.js"></script><object  id="LODOP_OB" classid=&q

18、uot;clsid:2105C259-1E0C-4534-8141-A753534CB4CA" width=0 height=0> <embed id="LODOP_EM" type="application/x-print-lodop" width=0 height=0></embed></object></head><body><script language="javascript"> var LODOP=getLodop(docu

19、ment.getElementById('LODOP_OB'),document.getElementById('LODOP_EM');</script></body>以上兩段代碼相互配合實現(xiàn)了Lodop的安裝、調用和升級。之所以將LodopFuncs.js作為一個資源文件來部署，既可以利用瀏覽器的緩存減少頁面內容的重復下載，同時還實現(xiàn)了控件發(fā)布統(tǒng)一管理，整個應用系統(tǒng)中只要這一個地方發(fā)布Lodop。其它頁面直接拷貝嵌入第2段代碼就可以了。三、控件參數(shù)Lodop有如下控件參數(shù),以頁面object對象元素的參數(shù)形式使用：Caption名稱：設

20、置控件的顯示標題格式：<param name="Caption" value="我是打印控件lodop">功能： 控件在頁面內一般是以object元素形式被引用。可以通過設置元素的width和height等于0來隱藏控件，不隱藏時可以為控件設置一個標題，以便于看到控件是否被正確安裝，以及控件對象在頁面內的位置。希望打印預覽界面或設計界面內嵌到網(wǎng)頁內時，本參數(shù)很有用。Color名稱：設置控件的顯示區(qū)域顏色格式：<param name="Color" value="#C0C0C0">功能：通過該

21、參數(shù)設置控件顯示區(qū)域的底色，對于希望打印預覽界面或設計界面內嵌到網(wǎng)頁內時，本參數(shù)可以讓控件容易融于整體頁面。參數(shù)值采用超文本顏色形式，可以是三色16進制值組合，也可以是英文顏色名。Border名稱：設置控件的顯示區(qū)域邊界格式：<param name="Border" value="1">功能：通過該參數(shù)設置控件顯示區(qū)域的邊界，值等于1表示有邊界，否則無邊界。本參數(shù)可以讓控件更融于整體頁面。另外，控件還有三個用于注冊的輔助參數(shù)，參考后面軟件使用權注冊一節(jié)。四、功能函數(shù)Lodop的功能函數(shù)不多，但參數(shù)比較復雜。全部函數(shù)分“基本函數(shù)”和“擴展函數(shù)”

22、兩類，兩類函數(shù)有類似性，基本函數(shù)使用簡單，達不到要求時請使用擴展函數(shù)，二者無本質區(qū)別。1、基本函數(shù)VERSION 名稱：獲得軟件版本號格式：VERSION結果：返回字符型結果版本號有四個數(shù)字組成，樣式為：XPRINT_INIT名稱：打印初始化格式：PRINT_INIT(strTaskName)功能：初始化運行環(huán)境，清理異常打印遺留的系統(tǒng)資源，設定打印任務名。參數(shù)：strTaskName：打印任務名，字符型參數(shù)，由開發(fā)者自主設定，未限制長度，字符要求符合Windows文件起名規(guī)則，Lodop會根據(jù)該名記憶相關的打印設置、打印維護信息。若strTaskName空，控件則不保存本地化信息，打印全部由

23、頁面程序控制。結果：返回邏輯值返回邏輯真表示初始化成功，邏輯假表示初始化失敗，失敗原因有：前一個打印事務沒有完成；操作系統(tǒng)沒有添加打印機(驅動)等。建議或要求：該函數(shù)與PRINT_INITA都有初始化功能，每個打印事務至少初始化一次，建議打印程序首先調用該函數(shù)。任務名要盡量區(qū)別于其它打印任務，譬如用“XX單位_XX管理信息系統(tǒng)_XX子系統(tǒng)_XX模塊_XX打印作業(yè)”字樣。不希望最終用戶更改打印布局時，則設strTaskName空。SET_PRINT_PAGESIZE名稱：設定紙張大小格式：SET_PRINT_PAGESIZE(intOrient, PageWidth,PageHeight,str

24、PageName)功能：設定打印紙張為固定紙張或自適應內容高，并設定相關大小值或紙張名及打印方向。參數(shù)：intOrient：打印方向及紙張類型，數(shù)字型，1-縱(正)向打印，固定紙張； 2-橫向打印，固定紙張；  3-縱(正)向打印，寬度固定，高度按打印內容的高度自適應；0(或其它)-打印方向由操作者自行選擇或按打印機缺省設置；PageWidth：設定自定義紙張寬度，整數(shù)或字符型，整數(shù)時缺省長度單位為0.1mm, 譬如該參數(shù)值為45，則表示4.5毫米。字符型時可包含單位名：in(英寸)、cm(厘米) 、mm(毫米) 、pt(磅)、px(1/96英寸)，如“10mm”

25、表示10毫米。 不是數(shù)值或數(shù)值小于等于0時本參數(shù)無效。PageHeight：固定紙張時設定紙張高；高度自適應時設定紙張底邊的空白高。整數(shù)或字符型，整數(shù)時缺省長度單位為0.1毫米。字符型時可包含單位名：in(英寸)、cm(厘米) 、mm(毫米) 、pt(磅)、px(1/96英寸)，如“10mm”表示10毫米。不是數(shù)值或數(shù)值小于等于0時本參數(shù)無效。寬或高無效時下面的strPageName才起作用。strPageName：所選紙張類型名，字符型。不同打印機所支持的紙張可能不一樣，這里的名稱同操作系統(tǒng)內打印機屬性中的紙張名稱，支持操作系統(tǒng)內的自定義紙張。關鍵字“CreateCustomPage”會按以

26、上寬度和高度自動建立一個自定義紙張，所建立的紙張名固定為“LodopCustomPage”，多次建立則刷新該紙張的大小值。注：PageWidth、PageHeight 和strPageName都無效時，本函數(shù)對紙張大小不起作用，控件則采用所選打印機的默認紙張，但intOrient仍可起作用。如果打印程序未采用擴展方式（PRINT_INITA）初始化，本函數(shù)的固定紙張功能所定制的紙張大小，會起到PRINT_INITA中Width和Height的相同功能。實際打印時，控件按如下優(yōu)先級順序確定紙張大?。旱?優(yōu)先是打印維護里紙張屬性（“本機自行定義紙張”）設置的紙張大小。第2優(yōu)先是SET_PRINT_

27、PAGESIZE指定的紙張大?。?第3優(yōu)先是上次打印時在預覽界面設置里選擇的紙張類型；第4是按所選打印機的默認紙張；結果：無建議或要求：打印初始化之后調用。如果打印紙張不固定，希望由操作者自主選擇紙張時，則不要調用本函數(shù)。ADD_PRINT_HTM名稱：增加超文本打印項(普通模式)格式：ADD_PRINT_HTM(Top,Left,Width,Height,strHtmlContent)功能：增加超文本打印項，設定該打印項在紙張內的位置和區(qū)域大小，實現(xiàn)超文本控制打印。參數(shù)：Top：所增打印項在紙張內的上邊距，整數(shù)或字符型，整數(shù)時缺省長度單位為px。字符型時可包含單位名：in(英寸)、cm(厘米

28、) 、mm(毫米) 、pt(磅)、px(1/96英寸)、%(百分比)，如“10mm”表示10毫米。Left：所增打印項在紙張內的左邊距，整數(shù)或字符型，整數(shù)時缺省長度單位為px。字符型時可包含單位名：in(英寸)、cm(厘米) 、mm(毫米) 、pt(磅)、px(1/96英寸) 、%(百分比)，如“10mm”表示10毫米。Width：打印區(qū)域的寬度，整數(shù)或字符型，整數(shù)時缺省長度單位為px。字符型時可包含單位名：in(英寸)、cm(厘米) 、mm(毫米) 、pt(磅)、px(1/96英寸) 、%(百分比)，如“10mm”表示10毫米。本參數(shù)可以用RightMargin關鍵字轉義為打印區(qū)域相對于紙張

29、的“右邊距”。Height：打印區(qū)域的高度，整數(shù)或字符型，整數(shù)時缺省長度單位為px。字符型時可包含單位名：in(英寸)、cm(厘米) 、mm(毫米) 、pt(磅)、px(1/96英寸) 、%(百分比)，如“10mm”表示10毫米，控件按這個值自動分頁。本參數(shù)可以用BottomMargin關鍵字轉義為打印區(qū)域相對于紙張的“下邊距”。strHtmlContent：超文本代碼內容，字符型，未限制長度?？梢允且粋€完整的頁面超文本代碼，或者是一個代碼段落，也可以是URL:web地址形式的URL地址。Lodop專有樣式和屬性有：代碼中若包含style="page-break-after:alwa

30、ys"或style="page-break-before:always"，該元素稱為“強制分頁元素”，控件會在該元素處分頁。代碼中的標簽IMG如果有transcolor屬性，則可以實現(xiàn)透明打印圖片。例如屬性格式為：transcolor="#FFFFFF" 表示用白色作為透明底色，這里的顏色值可以是“#”加三色16進制值組合，也可以是英文顏色名。這個專有屬性再配合IMG的position: absolute可以實現(xiàn)“先字后章”的公章打印效果。代碼中的元素如果包含borderthin屬性，如果屬性值等于true,則該元素的border在合并單元格時

31、會采用單細線模式。結果：無建議或要求：要求在打印初始化后使用，建議在畫線類函數(shù)之后調用。注意“強制分頁元素”要符合xhtml規(guī)范，建議用跨整行的元素，內容不能空，內容可以是“&nbsp;”。強制分頁符對其它Lodop函數(shù)無效，僅適用本函數(shù)。ADD_PRINT_TABLE名稱：增加表格打印項（超文本模式）格式：ADD_PRINT_TABLE(Top,Left,Width,Height,strHtml)功能：用超文本增加一個表格打印項，設定該表格在每個紙張內的位置和區(qū)域大小。打印時只輸出首個頁面元素table的顯示內容，當table內包含thead或tfoot時，一旦表格被分頁，則每個打印

32、頁都輸出表頭(thead)或表尾(tfoot)。參數(shù)：Top：表格數(shù)據(jù)頭(頁頭thead)在紙張內的上邊距，整數(shù)或字符型，整數(shù)時缺省長度單位為px。字符型時可包含單位名：in(英寸)、cm(厘米) 、mm(毫米) 、pt(磅)、px(1/96英寸) 、%(百分比)，如“10mm”表示10毫米。Left：表格數(shù)據(jù)頭(頁頭thead)在紙張內的左邊距，整數(shù)或字符型，字符型時可包含單位名：in(英寸)、cm(厘米) 、mm(毫米) 、pt(磅)、px(1/96英寸) 、%(百分比)，如“10mm”表示10毫米。Width：打印區(qū)域的寬度，整數(shù)或字符型，整數(shù)時缺省長度單位為px。字符型時可包含單位名：

33、in(英寸)、cm(厘米) 、mm(毫米) 、pt(磅)、px(1/96英寸) 、%(百分比)，如“10mm”表示10毫米。本參數(shù)可以用RightMargin關鍵字轉義為打印區(qū)域相對于紙張的“右邊距”。Height：表格數(shù)據(jù)體(tbody)區(qū)域的高度，整數(shù)或字符型，整數(shù)時缺省長度單位為px。字符型時可包含單位名：in(英寸)、cm(厘米) 、mm(毫米) 、pt(磅)、px(1/96英寸) 、%(百分比)，如“10mm”表示10毫米?？丶催@個值自動分頁，每頁至少打印一個TR行(由于table可以嵌套多層子table，這里的TR行是指首層TR)。本參數(shù)可以用BottomMargin關鍵字轉義為

34、打印區(qū)域相對于紙張的“下邊距”。strHtml：超文本代碼內容，字符型，未限制長度?？梢允且粋€完整的頁面超文本代碼，或者是一個代碼段落，也可以是URL:web地址形式的URL地址。要求實際內容中至少包含一個table元素。 特別說明：本函數(shù)能識別的超文本專有元素屬性有tdata、format、tclass、tindex等四個，它們主要用來實現(xiàn)分頁小計、分類合計等統(tǒng)計功能，這四個屬性可以用在table內的任何元素上，包含tdata屬性的超文本元素下面稱為“統(tǒng)計結果元素”，被統(tǒng)計的超文本元素稱為“數(shù)據(jù)元素”，它們的屬性值及其含義如下：tdata：設置統(tǒng)計類型，其值和含義為：subCount-本頁行

35、數(shù)，即本頁該數(shù)據(jù)列的單元格行數(shù)；subSum-本頁合計，即本頁該數(shù)據(jù)列的數(shù)值合計；subAverage-本頁平均數(shù)，即本頁合計除以本頁行數(shù)；Count-累計行數(shù)，即從第一頁到本頁的該列行數(shù)的累加值；Sum-累計數(shù)，即從第一頁到本頁的該列數(shù)值的累加值；Average-累計平均數(shù)，即累計數(shù)除以累計行數(shù)；allCount-總行數(shù)，即該列全表的行數(shù)；allSum-總計數(shù)，即該列全表的數(shù)值總和；allAverage-總平均數(shù)，即全表總計數(shù)除以總行數(shù)； pageNO-頁號，即本table頁的序號（與打印紙張的頁號不一定相同）；pageCount-總頁數(shù)，即全（table）表被分成的總頁數(shù)；format：設

36、置統(tǒng)計結果的顯示格式，其值如下樣式：   “0”“0.00”“#.#” “#,#0.00”“0.000E+00”“#.#E-0 ” “UpperMoney(大寫金額)”等等,其中的“#”表示當數(shù)據(jù)為0時不顯示。tclass：設置分類統(tǒng)計的“類名”，其值可任意設置，在分類統(tǒng)計時，“統(tǒng)計結果元素”和“數(shù)據(jù)元素”的tclass值必須一致。不設置類名時則全表統(tǒng)計。tindex：一般要求“統(tǒng)計結果元素”的位置與“數(shù)據(jù)元素”的列位置一致或內含在“數(shù)據(jù)元素”列內，如果位置無法一致，可以用tindex指定對應的數(shù)據(jù)列，該值是數(shù)字型的列序號，從1起始。占位符：一個要顯示統(tǒng)計結果的“統(tǒng)計結果元

37、素”必須要包含占位符，占位符是任意個“#”組成的字符串，占位符可以與其它內容混合在一起，當統(tǒng)計結果值較大時，開發(fā)者需要注意占位符要占用足夠多的位置，除非占位符周圍有合理的空白區(qū)，以避免統(tǒng)計結果與普通內容重疊。結果：無建議或要求：要求在打印初始化后調用，建議在畫線類函數(shù)之后調用。ADD_PRINT_URL名稱：增加超文本打印項（URL模式）格式：ADD_PRINT_URL(Top,Left,Width,Height,strURL)功能：按URL地址增加超文本打印項，設定該打印項在紙張內的位置和區(qū)域大小。參數(shù)：Top：所增打印項在紙張內的上邊距，整數(shù)或字符型，整數(shù)時缺省長度單位為px。字符型時可包

38、含單位名：in(英寸)、cm(厘米) 、mm(毫米) 、pt(磅)、px(1/96英寸) 、%(百分比)，如“10mm”表示10毫米。Left：所增打印項在紙張內的左邊距，整數(shù)或字符型，整數(shù)時缺省長度單位為px。字符型時可包含單位名：in(英寸)、cm(厘米) 、mm(毫米) 、pt(磅)、px(1/96英寸) 、%(百分比)，如“10mm”表示10毫米。Width：打印區(qū)域的寬度，整數(shù)或字符型，整數(shù)時缺省長度單位為px。字符型時可包含單位名：in(英寸)、cm(厘米) 、mm(毫米) 、pt(磅)、px(1/96英寸) 、%(百分比)，如“10mm”表示10毫米。本參數(shù)可以用RightMar

39、gin關鍵字轉義為打印區(qū)域相對于紙張的“右邊距”。Height：打印區(qū)域的高度，整數(shù)或字符型，整數(shù)時缺省長度單位為px。字符型時可包含單位名：in(英寸)、cm(厘米) 、mm(毫米) 、pt(磅)、px(1/96英寸) 、%(百分比)，如“10mm”表示10毫米。控件按這個值自動分頁，每頁至少打印一個TR行(由于table可以嵌套多層子table，這里的TR行是指首層TR)。本參數(shù)可以用BottomMargin關鍵字轉義為打印區(qū)域相對于紙張的“下邊距”。strURL：頁面URL地址，字符型，未限制長度。結果：無建議或要求：要求在打印初始化后調用，建議在畫線類函數(shù)之后調用。ADD_PRINT_

40、TEXT名稱：增加純文本打印項格式：ADD_PRINT_TEXT(Top,Left,Width,Height,strContent)功能：增加純文本打印項，設定該打印項在紙張內的位置和區(qū)域大小，文本內容在該區(qū)域內自動折行，當內容超出區(qū)域高度時，如果對象被設為“多頁文檔”則會自動分頁繼續(xù)打印，否則內容被截取。參數(shù)：Top：打印項在紙張內的上邊距，整數(shù)或字符型，整數(shù)時缺省長度單位為px。字符型時可包含單位名：in(英寸)、cm(厘米) 、mm(毫米) 、pt(磅)、px(1/96英寸) 、%(百分比)，如“10mm”表示10毫米。當上邊距超過紙張高度時，打印項被輸出在下一頁(或更下頁)。Left：

41、打印項在紙張內的左邊距，整數(shù)或字符型，整數(shù)時缺省長度單位為px。字符型時可包含單位名：in(英寸)、cm(厘米) 、mm(毫米) 、pt(磅)、px(1/96英寸) 、%(百分比)，如“10mm”表示10毫米。Width：打印區(qū)域的寬度，整數(shù)或字符型，整數(shù)時缺省長度單位為px。字符型時可包含單位名：in(英寸)、cm(厘米) 、mm(毫米) 、pt(磅)、px(1/96英寸) 、%(百分比)，如“10mm”表示10毫米。本參數(shù)可以用RightMargin關鍵字轉義為打印區(qū)域相對于紙張的“右邊距”。Height：打印區(qū)域的高度，整數(shù)或字符型，整數(shù)時缺省長度單位為px。字符型時可包含單位名：in(

42、英寸)、cm(厘米) 、mm(毫米) 、pt(磅)、px(1/96英寸) 、%(百分比)，如“10mm”表示10毫米。本參數(shù)可以用BottomMargin關鍵字轉義為打印區(qū)域相對于紙張的“下邊距”。strContent：純文本內容，字符型，未限制長度。結果：無建議或要求：要求在打印初始化后調用，建議在畫線類函數(shù)之后調用。ADD_PRINT_IMAGE名稱：增加圖片打印項格式：ADD_PRINT_IMAGE(Top,Left,Width,Height,strHtmlContent)功能：增加圖片打印項，設定該打印項在紙張內的位置和區(qū)域大小。參數(shù)：Top：所增打印項在紙張內的上邊距，整數(shù)或字符型，

43、整數(shù)時缺省長度單位為px。字符型時可包含單位名：in(英寸)、cm(厘米) 、mm(毫米) 、pt(磅)、px(1/96英寸) 、%(百分比)，如“10mm”表示10毫米。Left：所增打印項在紙張內的左邊距，整數(shù)或字符型，整數(shù)時缺省長度單位為px。字符型時可包含單位名：in(英寸)、cm(厘米) 、mm(毫米) 、pt(磅)、px(1/96英寸) 、%(百分比)，如“10mm”表示10毫米。Width：圖片的寬度，整數(shù)或字符型，整數(shù)時缺省長度單位為px。字符型時可包含單位名：in(英寸)、cm(厘米) 、mm(毫米) 、pt(磅)、px(1/96英寸) 、%(百分比)，如“10mm”表示10

44、毫米。本參數(shù)可以用RightMargin關鍵字轉義為打印區(qū)域相對于紙張的“右邊距”。Height：圖片的高度，整數(shù)或字符型，整數(shù)時缺省長度單位為px。字符型時可包含單位名：in(英寸)、cm(厘米) 、mm(毫米) 、pt(磅)、px(1/96英寸) 、%(百分比)，如“10mm”表示10毫米。圖片大時被截取，不會分到下頁。本參數(shù)可以用BottomMargin關鍵字轉義為打印區(qū)域相對于紙張的“下邊距”。strHtmlContent：本參數(shù)是字符型，有三種情況：一是超文本代碼內容；二是本地文件名內容；第三是WEB地址。第一種情況一般是用IMG標簽組成的超文本代碼段落。第二種情況是本地文件名全路徑

45、，格式如“C:/test.jpg”。第三種情況是是URL:web地址形式的URL地址。結果：無建議或要求：要求在打印初始化后調用，建議在畫線類函數(shù)之后調用。本函數(shù)可用ADD_PRINT_HTM代替，但區(qū)別是其僅取超文本第一個圖片元素，邊距是0，而且打印時不因為設計區(qū)域小于圖片而被分頁，適合與純文本組合打印的插圖。ADD_PRINT_RECT名稱：增加矩形線格式：ADD_PRINT_RECT(Top, Left, Width, Height,intLineStyle, intLineWidth)功能：增加矩形線打印項，設定該矩形在紙張內的位置和大小，設定線條的類型和線條寬度。參數(shù)：Top：該矩形

46、在紙張內的上邊距，整數(shù)或字符型，整數(shù)時缺省長度單位為px。字符型時可包含單位名：in(英寸)、cm(厘米) 、mm(毫米) 、pt(磅)、px(1/96英寸) 、%(百分比)，如“10mm”表示10毫米。當上邊距超過紙張高度時，打印項被輸出在下一頁(或更下頁)。Left：該矩形在紙張內的左邊距，整數(shù)或字符型，整數(shù)時缺省長度單位為px。字符型時可包含單位名：in(英寸)、cm(厘米) 、mm(毫米) 、pt(磅)、px(1/96英寸) 、%(百分比)，如“10mm”表示10毫米。Width：該矩形的寬度，整數(shù)或字符型，整數(shù)時缺省長度單位為px。字符型時可包含單位名：in(英寸)、cm(厘米) 、

47、mm(毫米) 、pt(磅)、px(1/96英寸) 、%(百分比)，如“10mm”表示10毫米。本參數(shù)可以用RightMargin關鍵字轉義為打印區(qū)域相對于紙張的“右邊距”。Height：該矩形的高度，整數(shù)或字符型，整數(shù)時缺省長度單位為px。字符型時可包含單位名：in(英寸)、cm(厘米) 、mm(毫米) 、pt(磅)、px(1/96英寸) 、%(百分比)，如“10mm”表示10毫米。寬和高相等時是正方形。本參數(shù)可以用BottomMargin關鍵字轉義為打印區(qū)域相對于紙張的“下邊距”。intLineStyle：線條類型，數(shù)字型，0-實線 1-破折線 2-點線 3-點劃線 4-雙點劃線缺省線條是實

48、線。intLineWidth：線條寬，整數(shù)型，單位是(打印)像素，缺省值是1，非實線的線條寬也是0。結果：無建議或要求：要求在打印初始化后調用，建議在文本類函數(shù)之前調用。ADD_PRINT_ELLIPSE名稱：增加橢圓線格式：ADD_PRINT_ELLIPSE(Top, Left,Width, Height, intLineStyle, intLineWidth)功能：增加橢圓線打印項，設定該橢圓在紙張內的位置和大小，設定線條的類型和線條寬度。參數(shù)：Top：該橢圓的外緣矩形在紙張內的上邊距，整數(shù)或字符型，整數(shù)時缺省長度單位為px。字符型時可包含單位名：in(英寸)、cm(厘米) 、mm(毫米)

49、 、pt(磅)、px(1/96英寸) 、%(百分比)，如“10mm”表示10毫米。當上邊距超過紙張高度時，打印項被輸出在下一頁(或更下頁)。Left：該橢圓的外緣矩形在紙張內的左邊距，整數(shù)或字符型，整數(shù)時缺省長度單位為px。字符型時可包含單位名：in(英寸)、cm(厘米) 、mm(毫米) 、pt(磅)、px(1/96英寸) 、%(百分比)，如“10mm”表示10毫米。Width：該橢圓的外緣矩形的寬度，整數(shù)或字符型，整數(shù)時缺省長度單位為px。字符型時可包含單位名：in(英寸)、cm(厘米) 、mm(毫米) 、pt(磅)、px(1/96英寸) 、%(百分比)，如“10mm”表示10毫米。本參數(shù)可

50、以用RightMargin關鍵字轉義為打印區(qū)域相對于紙張的“右邊距”。Height：該橢圓的外緣矩形的高度，整數(shù)或字符型，整數(shù)時缺省長度單位為px。字符型時可包含單位名：in(英寸)、cm(厘米) 、mm(毫米) 、pt(磅)、px(1/96英寸) 、%(百分比)，如“10mm”表示10毫米，寬和高相等時是圓。本參數(shù)可以用BottomMargin關鍵字轉義為打印區(qū)域相對于紙張的“下邊距”。intLineStyle：線條類型，數(shù)字型，0-實線 1-破折線 2-點線 3-點劃線 4-雙點劃線缺省線條是實線。intLineWidth：線條寬，整數(shù)型，單位是（打?。┫袼兀笔≈凳?，非實線的線條寬也是

51、0。結果：無建議或要求：要求在打印初始化后調用，建議在文本類函數(shù)之前調用。ADD_PRINT_LINE名稱：增加直線格式：ADD_PRINT_LINE(Top1,Left1, Top2, Left2,intLineStyle, intLineWidth)功能：增加直線，設定直線的兩個端點，設定直線的線條類型和線寬。參數(shù)：Top1：端點1的上邊距，整數(shù)或字符型，整數(shù)時缺省長度單位為px。字符型時可包含單位名：in(英寸)、cm(厘米) 、mm(毫米) 、pt(磅)、px(1/96英寸) 、%(百分比)，如“10mm”表示10毫米。當上邊距超過紙張高度時，打印項被輸出在下一頁(或更下頁)。Left

52、1：端點1的左邊距，整數(shù)或字符型，整數(shù)時缺省長度單位為px。字符型時可包含單位名：in(英寸)、cm(厘米) 、mm(毫米) 、pt(磅)、px(1/96英寸) 、%(百分比)，如“10mm”表示10毫米。Top2：端點2的上邊距，整數(shù)或字符型，整數(shù)時缺省長度單位為px。字符型時可包含單位名：in(英寸)、cm(厘米) 、mm(毫米) 、pt(磅)、px(1/96英寸) 、%(百分比)，如“10mm”表示10毫米。本參數(shù)可以用BottomMargin關鍵字轉義為端點2相對于紙張的“下邊距”。Left2：端點2的左邊距，整數(shù)或字符型，整數(shù)時缺省長度單位為px。字符型時可包含單位名：in(英寸)、

53、cm(厘米) 、mm(毫米) 、pt(磅)、px(1/96英寸) 、%(百分比)，如“10mm”表示10毫米。本參數(shù)可以用RightMargin關鍵字轉義為端點2相對于紙張的“右邊距”。intLineStyle：線條類型，數(shù)字型，0-實線 1-破折線 2-點線 3-點劃線 4-雙點劃線缺省線條是實線。intLineWidth：線條寬，整數(shù)型，單位是(打印)像素，缺省值是1，非實線的線條寬也是0。結果：無建議或要求：要求在打印初始化后調用，建議在文本類函數(shù)之前調用。ADD_PRINT_BARCODE名稱：增加條形碼格式：ADD_PRINT_BARCODE(Top, Left,Width, Hei

54、ght, CodeType, CodeValue)功能：增加條形碼打印項，設定該條形碼在紙張內的位置和大小，指定條形碼的類型和條碼值，控件在打印機上直接繪制條碼圖。參數(shù)：Top：該條碼圖在紙張內的上邊距，整數(shù)或字符型，整數(shù)時缺省長度單位為px。字符型時可包含單位名：in(英寸)、cm(厘米) 、mm(毫米) 、pt(磅)、px(1/96英寸) 、%(百分比)，如“10mm”表示10毫米。Left：該條碼圖在紙張內的左邊距，整數(shù)或字符型，整數(shù)時缺省長度單位為px。字符型時可包含單位名：in(英寸)、cm(厘米) 、mm(毫米) 、pt(磅)、px(1/96英寸) 、%(百分比)，如“10mm”表

55、示10毫米。Width：該條碼圖的總寬度，整數(shù)或字符型，整數(shù)時缺省長度單位為px。字符型時可包含單位名：in(英寸)、cm(厘米) 、mm(毫米) 、pt(磅)、px(1/96英寸) 、%(百分比)，如“10mm”表示10毫米。條碼密度會根據(jù)寬度自動調整，直到最小密度，也就是單條寬等于1px時。本參數(shù)可以用RightMargin關鍵字轉義為打印區(qū)域相對于紙張的“右邊距”。Height：該條碼圖的高度，整數(shù)或字符型，整數(shù)時缺省長度單位為px。字符型時可包含單位名：in(英寸)、cm(厘米) 、mm(毫米) 、pt(磅)、px(1/96英寸) 、%(百分比)，如“10mm”表示10毫米，寬和高相等

56、時是圓。本參數(shù)可以用BottomMargin關鍵字轉義為打印區(qū)域相對于紙張的“下邊距”。CodeType：條碼類型，字符型。目前支持的類型（條碼規(guī)制）主要是一維條碼，有如下幾種：128A，128B，128C，EAN8，EAN13，EAN128A，EAN128B，EAN128C，Code39，39Extended，2_5interleaved，2_5industrial，2_5matrix，UPC_A，UPC_E0，UPC_E1，UPCsupp2，UPCsupp5，Code93，93Extended，MSI，PostNet，Codaba，QRCode。其中QRCode二維碼，其它為一維碼。默認情

57、況下QRCode的版本會根據(jù)寬度和高度自動調整，頁面程序也可以直接設置具體版本（有1、3、7、14四個簡約版本可選），版本固定時會按寬度和高度自動縮放條碼大小。CodeValue：條碼值。結果：無建議或要求：要求在初始化之后，打印或預覽之前調用。ADD_PRINT_CHART名稱：增加圖表格式：ADD_PRINT_CHART(Top, Left,Width, Height, ChartType, strHtml)功能：增加圖表打印項，設定該圖表在紙張內的位置和大小，指定圖表的類型和生成圖表的數(shù)據(jù)來源，一般數(shù)據(jù)來源于一個超文本的Table,本函數(shù)可以快速清晰的生成任何復雜的圖表。參數(shù)：Top：該圖表在紙張內的上邊距，整數(shù)或字符型，整數(shù)時缺省長度單位為px。字符型時可包含單位名：in(英寸)、cm(厘米) 、mm(毫米) 、pt(磅)、px(1/96英寸) 、%(百分比)，如“10mm”表示10毫米。Left：該圖表在紙張內的左邊距，整數(shù)或字符型，整數(shù)時缺省長度單位為px。字符型時可包含單位名：in(英寸)、cm(厘米) 、mm(毫米) 、pt(