天天看點

雲列印Lodop屬性和方法詳解

LOPOP

 C-Lodop安裝程式可通過官網www.c-lodop.com下載下傳最新版。 

Lodop釋出包内主要有如下幾個檔案:

install_lodop.exe

該檔案是控件安裝和更新的主檔案,提供給使用者或開發者下載下傳安裝,如果不特意攔截一般都能100%安裝,對“網頁插件安裝難”有一定改善。如果将其複制或改名為uninstall_lodop.exe (名前加un)就可用其解除安裝控件。

Lodop安裝後,在作業系統目錄WINDOWS\system32下會安裝兩個實體檔案:CAOSOFT_WEB_PRINT_LODOP.OCX和NPCAOSOFT_WEB_PRINT_lodop.dll,前一個檔案是OCX檔案,後者是Npplugin檔案,其作用是實作多浏覽器支援。目前Lodop支援IE系列、IE核心系列(遨遊、360、世界之窗、騰訊TT、搜狗等)浏覽器,以及Firefox(火狐)系列、Chrome(谷歌)系列、Opera系列、Safari系列等Windows下幾乎所有的浏覽器。

程式檔案有幾個預定參數:

-waitXX該參數設定安裝程式運作完畢後自動關閉視窗,這裡的XX表示關閉前等待的秒數,如果是0秒則安裝(或解除安裝)成功後立即關閉,例如:–wait8

-nowindow 該參數設定安裝程式運作時不出現視窗。

-un 該參數使程式執行解除安裝操作,參數優先于檔案名。

-in 該參數使程式執行安裝操作,參數優先于檔案名。

安裝界面如下:

LodopFuncs.js

該檔案是用來引導安裝控件的一個JS檔案,是個樣例,但建議直接采用。其中getLodop的任務是判斷浏覽器的類型并決定采用哪個對象執行個體,并檢測控件是否安裝、是否最新版本、并引導安裝或更新。檔案内容如下:

func tion getLodop(oOBJECT,oEMBED){

var strHtml1="

< fo nt color="#FF00FF">列印控件未安裝!點選這裡執行安裝,安裝後請重新整理頁面或重新進入。";

var strHtml2="

< fo nt color="#FF00FF">列印控件需要更新!點選這裡執行更新,更新後請重新進入。";

var strHtml3="

< fo nt color="#FF00FF">(注:如曾安裝過Lodop舊版附件npActiveXPLugin,請在【工具】->【附加元件】中先解除安裝它)";

var LODOP=oEMBED;

try{

if (navigator.appVersion.indexOf("MSIE")>=0) LODOP=oOBJECT;

if ((LODOP==null)||(typeof(LODOP.VERSION)=="undefined")) {

if (navigator.userAgent.indexOf(\'Firefox\')>=0)

docu ment.docu mentElement.innerHTML=strHtml3+docum ent.docum entElement.innerHTML;

if (navigator.appVersion.indexOf("MSIE")>=0) document.write(strHtml1); else

docu ment.docume ntElement.innerHTML=strHtml1+docu ment.docume ntElement.innerHTML;

} else if (LODOP.VERSION<"6.0.0.1") {

if (navigator.appVersion.indexOf("MSIE")>=0) document.write(strHtml2); else

docu ment.docum entElement.innerHTML=strHtml2+docu ment.docume ntElement.innerHTML;

}

//*****如下空白位置适合調用統一功能:*********

//*******************************************

return LODOP;

}catch(err){

docu ment.documen tElement.innerHTML="Error:"+strHtml1+docum ent.docume ntElement.innerHTML;

return LODOP;

}

}

其中的關鍵點是VERSION函數,Lodop提供了這個“讀版本号”功能,這樣控件的安裝和更新任務就交給JS來實作,以下是控件在頁面内的調用代碼,其中包含getLodop的使用:

< scri pt lang uage="javas cript" src="Lodop Funcs.js">

< object id="LODOP" classid="clsid:2105C259-1E0C-4534-8141-A753534CB4CA" width="0" height="0" >

< emb ed id="LODOP_EM" type="application/x-print-lodop" width="0" height="0" >

< scr ipt="" language="javascript" >

var LODOP=getL odop( document.getEle mentById(\'LODOP\'),docu ment.getElem entById(\'LODOP_EM\')) ;

< /sc ript >

以上兩段代碼互相配合實作了Lodop的安裝、調用和更新。之是以将LodopFuncs.js作為一個資源檔案來部署,既可以利用浏覽器的緩存減少頁面内容的重複下載下傳,同時還實作了控件釋出統一管理,整個應用系統中隻要這一個地方釋出Lodop。其它頁面直接拷貝嵌入第2段代碼就可以了。

三、控件參數

Lodop有如下控件參數,以頁面object對象元素的參數形式使用:

Caption

名稱:設定控件的顯示标題

格式: < pa ram name="Caption" value="我是列印控件lodop" >

功能: 控件在頁面内一般是以object元素形式被引用。可以通過設定元素的width和height等于0來隐藏控件,不隐藏時可以為控件設定一個标題,以便于看到控件是否被正确安裝,以及控件對象在頁面内的位置。希望列印預覽界面或設計界面内嵌到網頁内時,本參數很有用。

Color

名稱:設定控件的顯示區域顔色

格式: < par am name="Color" value="#C0C0C0" >

功能:通過該參數設定控件顯示區域的底色,對于希望列印預覽界面或設計界面内嵌到網頁内時,本參數可以讓控件容易融于整體頁面。

參數值采用超文本顔色形式,可以是三色16進制值組合,也可以是英文顔色名。

Border

名稱:設定控件的顯示區域邊界

格式: < par am name="Border" value="1" >

功能:通過該參數設定控件顯示區域的邊界,值等于1表示有邊界,否則無邊界。本參數可以讓控件更融于整體頁面。

另外,控件還有三個用于注冊的輔助參數,參考後面《軟體使用權注冊》一節。

四、功能函數

Lodop的功能函數不多,但參數比較複雜。全部函數分“基本函數”和“擴充函數”兩類,兩類函數有類似性,基本函數使用簡單,達不到要求時請使用擴充函數,二者無本質差別。

1、基本函數

VERSION

名稱:獲得軟體版本号

格式:VERSION

結果:傳回字元型結果

版本号有四個數字組成,樣式為:X.X.X.X

PRINT_INIT

名稱:列印初始化

格式:PRINT_INIT(strTaskName)

功能:初始化運作環境,清理異常列印遺留的系統資源,設定列印任務名。

參數:

strTaskName:

列印任務名,字元型參數,由開發者自主設定,未限制長度,字元要求符合Windows檔案起名規則,Lodop會根據該名記憶相關的列印設定、列印維護資訊。

若strTaskName空,控件則不儲存本地化資訊,列印全部由頁面程式控制。

結果:傳回邏輯值

傳回邏輯真表示初始化成功,邏輯假表示初始化失敗,失敗原因有:前一個列印事務沒有完成;作業系統沒有列印機(驅動)等。

建議或要求:

該函數與PRINT_INITA都有初始化功能,每個列印事務至少初始化一次,建議列印程式首先調用該函數。任務名要盡量差別于其它列印任務,譬如用“XX機關_XX管理資訊系統_XX子系統_XX子產品_XX列印作業”字樣。

不希望最終使用者更改列印布局時,則設strTaskName空。

SET_PRINT_PAGESIZE

名稱:設定紙張大小

格式:SET_PRINT_PAGESIZE(intOrient, PageWidth,PageHeight,strPageName)

功能:設定列印紙張為固定紙張或自适應内容高,并設定相關大小值或紙張名及列印方向。

參數:

intOrient:

列印方向及紙張類型,數字型,

1---縱(正)向列印,固定紙張;

2---橫向列印,固定紙張;

3---縱(正)向列印,寬度固定,高度按列印内容的高度自适應;

0(或其它)----列印方向由操作者自行選擇或按列印機預設設定;

PageWidth:

設定自定義紙張寬度,整數或字元型,整數時預設長度機關為0.1毫米。字元型時可包含機關名:in(英寸)、cm(厘米)、mm(毫米)、pt(磅)、px(1/96英寸),如“10mm”表示10毫米。

紙張寬,機關為0.1mm譬如該參數值為45,則表示4.5mm,計量精度是0.1mm。

PageHeight:

固定紙張時設定紙張高;高度自适應時設定紙張底邊的空白高。整數或字元型,整數時預設長度機關為0.1毫米。字元型時可包含機關名:in(英寸)、cm(厘米)、mm(毫米)、pt(磅)、px(1/96英寸),如“10mm”表示10毫米。

高小于等于0時strPageName才起作用。

strPageName:

所選紙張類型名,字元型。不同列印機所支援的紙張可能不一樣,這裡的名稱同作業系統内列印機屬性中的紙張名稱,支援作業系統内的自定義紙張。如”A4”、"信封 #9"

關鍵字“CreateCustomPage”會按以上寬度和高度自動建立一個自定義紙張,所建立的紙張名固定為“LodopCustomPage”,多次建立則重新整理該紙張的大小值。

注:PageWidth、PageHeight和strPageName都無效時,本函數對紙張大小不起作用,控件則采用所選列印機的預設紙張,但intOrient仍可起作用。

如果列印程式未采用擴充方式(PRINT_INITA)初始化,本函數的固定紙張功能所定制的紙張大小,會起到PRINT_INITA中Width和Height的相同功能。

實際列印時,控件按如下優先級順序确定紙張大小:

第1優先是列印維護裡紙張屬性(“本機自行定義紙張”)設定的紙張大小。

第2優先是SET_PRINT_PAGESIZE指定的紙張大小;

第3優先是上次列印時在預覽界面設定裡選擇的紙張類型;

第4是按所選列印機的預設紙張;

結果:無

建議或要求:

列印初始化之後調用。

如果列印紙張不固定,希望由操作者自主選擇紙張時,則不要調用本函數。

ADD_PRINT_HTM

名稱:增加超文本列印項(普通模式)

格式:ADD_PRINT_HTM(Top,Left,Width,Height,strHtmlContent)

功能:增加超文本列印項,設定該列印項在紙張内的位置和區域大小,實作超文本控制列印。

參數:

Top:

所增列印項在紙張内的上邊距,整數或字元型,整數時預設長度機關為px。字元型時可包含機關名:in(英寸)、cm(厘米)、mm(毫米)、pt(磅)、px(1/96英寸)、%(百分比),如“10mm”表示10毫米。

Left:

所增列印項在紙張内的左邊距,整數或字元型,整數時預設長度機關為px。字元型時可包含機關名:in(英寸)、cm(厘米)、mm(毫米)、pt(磅)、px(1/96英寸)、%(百分比),如“10mm”表示10毫米。

Width:

列印區域的寬度,整數或字元型,整數時預設長度機關為px。字元型時可包含機關名:in(英寸)、cm(厘米)、mm(毫米)、pt(磅)、px(1/96英寸)、%(百分比),如“10mm”表示10毫米。本參數可以用RightMargin關鍵字轉義為列印區域相對于紙張的“右邊距”。

Height:

列印區域的高度,整數或字元型,整數時預設長度機關為px。字元型時可包含機關名:in(英寸)、cm(厘米)、mm(毫米)、pt(磅)、px(1/96英寸)、%(百分比),如“10mm”表示10毫米,控件按這個值自動分頁。本參數可以用BottomMargin關鍵字轉義為列印區域相對于紙張的“下邊距”。

strHtmlContent:

超文本代碼内容,字元型,未限制長度。可以是一個完整的頁面超文本代碼,或者是一個代碼段落,也可以是URL:web位址形式的URL位址。

Lodop專有樣式和屬性有:

●代碼中若包含style="page-break-after:always"或style="page-break-before:always",該元素稱為“強制分頁元素”,控件會在該元素處分頁。

●代碼中的标簽IMG如果有transcolor屬性,則可以實作透明列印圖檔。例如屬性格式為:transcolor="#FFFFFF"表示用白色作為透明底色,這裡的顔色值可以是“#”加三色16進制值組合,也可以是英文顔色名。這個專有屬性再配合IMG的position: absolute可以實作“先字後章”的公章列印效果。

●代碼中的元素如果包含borderthin屬性,如果屬性值等于true,則該元素的border在合并單元格時會采用單細線模式。

結果:無

建議或要求:

要求在列印初始化後使用,建議在畫線類函數之後調用。注意“強制分頁元素”要符合xhtml規範,建議用跨整行的元素,内容不能空,内容可以是“ ”。強制分頁符對其它Lodop函數無效,僅适用本函數。

ADD_PRINT_TABLE

名稱:增加表格列印項(超文本模式)

格式:ADD_PRINT_TABLE(Top,Left,Width,Height,strHtml)

功能:用超文本增加一個表格列印項,設定該表格在每個紙張内的位置和區域大小。列印時隻輸出首個頁面元素table的顯示内容,當table内包含thead或tfoot時,一旦表格被分頁,則每個列印頁都輸出表頭(thead)或表尾(tfoot)。

參數:

Top:

表格資料頭(頁頭thead)在紙張内的上邊距,整數或字元型,整數時預設長度機關為px。字元型時可包含機關名:in(英寸)、cm(厘米)、mm(毫米)、pt(磅)、px(1/96英寸)、%(百分比),如“10mm”表示10毫米。

Left:

表格資料頭(頁頭thead)在紙張内的左邊距,整數或字元型,字元型時可包含機關名:in(英寸)、cm(厘米)、mm(毫米)、pt(磅)、px(1/96英寸)、%(百分比),如“10mm”表示10毫米。

Width:

列印區域的寬度,整數或字元型,整數時預設長度機關為px。字元型時可包含機關名:in(英寸)、cm(厘米)、mm(毫米)、pt(磅)、px(1/96英寸)、%(百分比),如“10mm”表示10毫米。本參數可以用RightMargin關鍵字轉義為列印區域相對于紙張的“右邊距”。

Height:

表格資料體(tbody)區域的高度,整數或字元型,整數時預設長度機關為px。字元型時可包含機關名:in(英寸)、cm(厘米)、mm(毫米)、pt(磅)、px(1/96英寸)、%(百分比),如“10mm”表示10毫米。控件按這個值自動分頁。本參數可以用BottomMargin關鍵字轉義為列印區域相對于紙張的“下邊距”。

strHtml:

超文本代碼内容,字元型,未限制長度。可以是一個完整的頁面超文本代碼,或者是一個代碼段落,也可以是URL:web位址形式的URL位址。要求實際内容中至少包含一個table元素。

特别說明:本函數能識别的超文本專有元素屬性有tdata、format、tclass、tindex等四個,它們主要用來實作分頁小計、分類合計等統計功能,這四個屬性可以用在table内的任何元素上,包含tdata屬性的超文本元素下面稱為“統計結果元素”,被統計的超文本元素稱為“資料元素”,它們的屬性值及其含義如下:

①tdata:設定統計類型,其值和含義為:

subCount---本頁行數,即本頁該資料列的單元格行數;

subSum---本頁合計,即本頁該資料列的數值合計;

subAverage---本頁平均數,即本頁合計除以本頁行數;

Count---累計行數,即從第一頁到本頁的該列行數的累加值;

Sum---累計數,即從第一頁到本頁的該列數值的累加值;

Average---累計平均數,即累計數除以累計行數;

allCount---總行數,即該列全表的行數;

allSum---總計數,即該列全表的數值總和;

allAverage---總平均數,即全表總計數除以總行數;

pageNO---頁号,即本table頁的序号(與列印紙張的頁号不一定相同);

pageCount---總頁數,即全(table)表被分成的總頁數;

②format:設定統計結果的顯示格式,其值如下樣式:

“0”“0.00””“#.##”“#,##0.00”“0.000E+00”“#.###E-0”“UpperMoney(大寫金額)”等等,其中的“#”表示當資料為0時不顯示。

③tclass:設定分類統計的“類名”,其值可任意設定,在分類統計時,“統計結果元素”和“資料元素”的tclass值必須一緻。

④tindex:一般要求“統計結果元素”的位置與“資料元素”的列位置一緻或内含在“資料元素”列内,如果位置無法一緻,可以用tindex指定對應的資料列,該值是數字型的列序号,從1起始。

⑤占位符:一個要顯示統計結果的“統計結果元素”必須要包含占位符,占位符是任意個“#”組成的字元串,占位符可以與其它内容混合在一起,當統計結果值較大時,開發者需要注意占位符要占用足夠多的位置,除非占位符周圍有合理的空白區,避免統計結果與普通内容重疊。

結果:無

建議或要求:

要求在列印初始化後調用,建議在畫線類函數之後調用。

ADD_PRINT_URL

名稱:增加超文本列印項(URL模式)

格式:ADD_PRINT_URL(Top,Left,Width,Height,strURL)

功能:按URL位址增加超文本列印項,設定該列印項在紙張内的位置和區域大小。

參數:

Top:

所增列印項在紙張内的上邊距,整數或字元型,整數時預設長度機關為px。字元型時可包含機關名:in(英寸)、cm(厘米)、mm(毫米)、pt(磅)、px(1/96英寸)、%(百分比),如“10mm”表示10毫米。

Left:

所增列印項在紙張内的左邊距,整數或字元型,整數時預設長度機關為px。字元型時可包含機關名:in(英寸)、cm(厘米)、mm(毫米)、pt(磅)、px(1/96英寸)、%(百分比),如“10mm”表示10毫米。

Width:

列印區域的寬度,整數或字元型,整數時預設長度機關為px。字元型時可包含機關名:in(英寸)、cm(厘米)、mm(毫米)、pt(磅)、px(1/96英寸)、%(百分比),如“10mm”表示10毫米。本參數可以用RightMargin關鍵字轉義為列印區域相對于紙張的“右邊距”。

Height:

列印區域的高度,整數或字元型,整數時預設長度機關為px。字元型時可包含機關名:in(英寸)、cm(厘米)、mm(毫米)、pt(磅)、px(1/96英寸)、%(百分比),如“10mm”表示10毫米。控件按這個值自動分頁。本參數可以用BottomMargin關鍵字轉義為列印區域相對于紙張的“下邊距”。

strURL:

頁面URL位址,字元型,未限制長度。

結果:無

建議或要求:

要求在列印初始化後調用,建議在畫線類函數之後調用。

ADD_PRINT_TEXT

名稱:增加純文字列印項

格式:ADD_PRINT_TEXT(Top,Left,Width,Height,strContent)

功能:增加純文字列印項,設定該列印項在紙張内的位置和區域大小,文本内容在該區域内自動折行,當内容超出區域高度時,如果對象被設為“多頁文檔”則會自動分頁繼續列印,否則内容被截取。

參數:

Top:

列印項在紙張内的上邊距,整數或字元型,整數時預設長度機關為px。字元型時可包含機關名:in(英寸)、cm(厘米)、mm(毫米)、pt(磅)、px(1/96英寸)、%(百分比),如“10mm”表示10毫米。當上邊距超過紙張高度時,列印項被輸出在下一頁(或更下頁)。

Left:

列印項在紙張内的左邊距,整數或字元型,整數時預設長度機關為px。字元型時可包含機關名:in(英寸)、cm(厘米)、mm(毫米)、pt(磅)、px(1/96英寸)、%(百分比),如“10mm”表示10毫米。

Width:

列印區域的寬度,整數或字元型,整數時預設長度機關為px。字元型時可包含機關名:in(英寸)、cm(厘米)、mm(毫米)、pt(磅)、px(1/96英寸)、%(百分比),如“10mm”表示10毫米。本參數可以用RightMargin關鍵字轉義為列印區域相對于紙張的“右邊距”。

Height:

列印區域的高度,整數或字元型,整數時預設長度機關為px。字元型時可包含機關名:in(英寸)、cm(厘米)、mm(毫米)、pt(磅)、px(1/96英寸)、%(百分比),如“10mm”表示10毫米。本參數可以用BottomMargin關鍵字轉義為列印區域相對于紙張的“下邊距”。

strContent:

純文字内容,字元型,未限制長度。

結果:無

建議或要求:

要求在列印初始化後調用,建議在畫線類函數之後調用。

ADD_PRINT_IMAGE

名稱:增加圖檔列印項

格式:ADD_PRINT_IMAGE(Top,Left,Width,Height,strHtmlContent)

功能:增加圖檔列印項,設定該列印項在紙張内的位置和區域大小。

參數:

Top:

所增列印項在紙張内的上邊距,整數或字元型,整數時預設長度機關為px。字元型時可包含機關名:in(英寸)、cm(厘米)、mm(毫米)、pt(磅)、px(1/96英寸)、%(百分比),如“10mm”表示10毫米。

Left:

所增列印項在紙張内的左邊距,整數或字元型,整數時預設長度機關為px。字元型時可包含機關名:in(英寸)、cm(厘米)、mm(毫米)、pt(磅)、px(1/96英寸)、%(百分比),如“10mm”表示10毫米。

Width:

圖檔的寬度,整數或字元型,整數時預設長度機關為px。字元型時可包含機關名:in(英寸)、cm(厘米)、mm(毫米)、pt(磅)、px(1/96英寸)、%(百分比),如“10mm”表示10毫米。本參數可以用RightMargin關鍵字轉義為列印區域相對于紙張的“右邊距”。

Height:

圖檔的高度,整數或字元型,整數時預設長度機關為px。字元型時可包含機關名:in(英寸)、cm(厘米)、mm(毫米)、pt(磅)、px(1/96英寸)、%(百分比),如“10mm”表示10毫米。圖檔大時被截取,不會分到下頁。本參數可以用BottomMargin關鍵字轉義為列印區域相對于紙張的“下邊距”。

strHtmlContent:

本參數是字元型,有三種情況:一是超文本代碼内容;二是本地檔案名内容;第三是WEB位址。第一種情況一般是用IMG标簽組成的超文本代碼段落。第二種情況是本地檔案名全路徑,格式如“C:/test.jpg”。第三種情況是是URL:web位址形式的URL位址。

結果:無

建議或要求:

要求在列印初始化後調用,建議在畫線類函數之後調用。

本函數可用ADD_PRINT_HTM代替,但差別是其僅取超文本第一個圖檔元素,邊距是0,而且列印時不因為設計區域小于圖檔而被分頁,适合與純文字組合列印的插圖。

ADD_PRINT_RECT

名稱:增加矩形線

格式:ADD_PRINT_RECT(Top, Left, Width, Height,intLineStyle, intLineWidth)

功能:增加矩形線列印項,設定該矩形在紙張内的位置和大小,設定線條的類型和線條寬度。

參數:

Top:

該矩形在紙張内的上邊距,整數或字元型,整數時預設長度機關為px。字元型時可包含機關名:in(英寸)、cm(厘米)、mm(毫米)、pt(磅)、px(1/96英寸)、%(百分比),如“10mm”表示10毫米。當上邊距超過紙張高度時,列印項被輸出在下一頁(或更下頁)。

Left:

該矩形在紙張内的左邊距,整數或字元型,整數時預設長度機關為px。字元型時可包含機關名:in(英寸)、cm(厘米)、mm(毫米)、pt(磅)、px(1/96英寸)、%(百分比),如“10mm”表示10毫米。

Width:

該矩形的寬度,整數或字元型,整數時預設長度機關為px。字元型時可包含機關名:in(英寸)、cm(厘米)、mm(毫米)、pt(磅)、px(1/96英寸)、%(百分比),如“10mm”表示10毫米。本參數可以用RightMargin關鍵字轉義為列印區域相對于紙張的“右邊距”。

Height:

該矩形的高度,整數或字元型,整數時預設長度機關為px。字元型時可包含機關名:in(英寸)、cm(厘米)、mm(毫米)、pt(磅)、px(1/96英寸)、%(百分比),如“10mm”表示10毫米。寬和高相等時是正方形。本參數可以用BottomMargin關鍵字轉義為列印區域相對于紙張的“下邊距”。

intLineStyle:

線條類型,數字型,0--實線 1--破折線 2--點線 3--點劃線 4--雙點劃線

預設線條是實線。

intLineWidth:

線條寬,整數型,機關是(列印)像素,預設值是1,非實線的線條寬也是0。

結果:無

建議或要求:

要求在列印初始化後調用,建議在文本類函數之前調用。

ADD_PRINT_ELLIPSE

名稱:增加橢圓線

格式:

ADD_PRINT_ELLIPSE(Top, Left,Width, Height, intLineStyle, intLineWidth)

功能:增加橢圓線列印項,設定該橢圓在紙張内的位置和大小,設定線條的類型和線條寬度。

參數:

Top:

該橢圓的外緣矩形在紙張内的上邊距,整數或字元型,整數時預設長度機關為px。字元型時可包含機關名:in(英寸)、cm(厘米)、mm(毫米)、pt(磅)、px(1/96英寸)、%(百分比),如“10mm”表示10毫米。

當上邊距超過紙張高度時,列印項被輸出在下一頁(或更下頁)。

Left:

該橢圓的外緣矩形在紙張内的左邊距,整數或字元型,整數時預設長度機關為px。字元型時可包含機關名:in(英寸)、cm(厘米)、mm(毫米)、pt(磅)、px(1/96英寸)、%(百分比),如“10mm”表示10毫米。

Width:

該橢圓的外緣矩形的寬度,整數或字元型,整數時預設長度機關為px。字元型時可包含機關名:in(英寸)、cm(厘米)、mm(毫米)、pt(磅)、px(1/96英寸)、%(百分比),如“10mm”表示10毫米。本參數可以用RightMargin關鍵字轉義為列印區域相對于紙張的“右邊距”。

Height:

該橢圓的外緣矩形的高度,整數或字元型,整數時預設長度機關為px。字元型時可包含機關名:in(英寸)、cm(厘米)、mm(毫米)、pt(磅)、px(1/96英寸)、%(百分比),如“10mm”表示10毫米,寬和高相等時是圓。本參數可以用BottomMargin關鍵字轉義為列印區域相對于紙張的“下邊距”。

intLineStyle:

線條類型,數字型,0--實線 1--破折線 2--點線 3--點劃線 4--雙點劃線

預設線條是實線。

intLineWidth:

線條寬,整數型,機關是(列印)像素,預設值是1,非實線的線條寬也是0。

結果:無

建議或要求:

要求在列印初始化後調用,建議在文本類函數之前調用。

ADD_PRINT_LINE

名稱:增加直線

格式:

ADD_PRINT_LINE(Top1,Left1, Top2, Left2,intLineStyle, intLineWidth)

功能:增加直線,設定直線的兩個端點,設定直線的線條類型和線寬。

參數:

Top1:

端點1的上邊距,整數或字元型,整數時預設長度機關為px。字元型時可包含機關名:in(英寸)、cm(厘米)、mm(毫米)、pt(磅)、px(1/96英寸)、%(百分比),如“10mm”表示10毫米。

當上邊距超過紙張高度時,列印項被輸出在下一頁(或更下頁)。

Left1:

端點1的左邊距,整數或字元型,整數時預設長度機關為px。字元型時可包含機關名:in(英寸)、cm(厘米)、mm(毫米)、pt(磅)、px(1/96英寸)、%(百分比),如“10mm”表示10毫米。

Top2:

端點2的上邊距,整數或字元型,整數時預設長度機關為px。字元型時可包含機關名:in(英寸)、cm(厘米)、mm(毫米)、pt(磅)、px(1/96英寸)、%(百分比),如“10mm”表示10毫米。本參數可以用BottomMargin關鍵字轉義為端點2相對于紙張的“下邊距”。

Left2:

端點2的左邊距,整數或字元型,整數時預設長度機關為px。字元型時可包含機關名:in(英寸)、cm(厘米)、mm(毫米)、pt(磅)、px(1/96英寸)、%(百分比),如“10mm”表示10毫米。本參數可以用RightMargin關鍵字轉義為端點2相對于紙張的“右邊距”。

intLineStyle:

線條類型,數字型,0--實線 1--破折線 2--點線 3--點劃線 4--雙點劃線

預設線條是實線。

intLineWidth:

線條寬,整數型,機關是(列印)像素,預設值是1,非實線的線條寬也是0。

結果:無

建議或要求:

要求在列印初始化後調用,建議在文本類函數之前調用。

ADD_PRINT_BARCODE

名稱:增加條形碼

格式:

ADD_PRINT_BARCODE(Top, Left,Width, Height, CodeType, CodeValue)

功能:增加條形碼列印項,設定該條形碼在紙張内的位置和大小,指定條形碼的類型和條碼值,控件在列印機上直接繪制條碼圖。

參數:

Top:

該條碼圖在紙張内的上邊距,整數或字元型,整數時預設長度機關為px。字元型時可包含機關名:in(英寸)、cm(厘米)、mm(毫米)、pt(磅)、px(1/96英寸)、%(百分比),如“10mm”表示10毫米。

Left:

該條碼圖在紙張内的左邊距,整數或字元型,整數時預設長度機關為px。字元型時可包含機關名:in(英寸)、cm(厘米)、mm(毫米)、pt(磅)、px(1/96英寸)、%(百分比),如“10mm”表示10毫米。

Width:

該條碼圖的總寬度,整數或字元型,整數時預設長度機關為px。字元型時可包含機關名:in(英寸)、cm(厘米)、mm(毫米)、pt(磅)、px(1/96英寸)、%(百分比),如“10mm”表示10毫米。條碼密度會根據寬度自動調整,直到最小密度,也就是單條寬等于1px時。本參數可以用RightMargin關鍵字轉義為列印區域相對于紙張的“右邊距”。

Height:

該條碼圖的高度,整數或字元型,整數時預設長度機關為px。字元型時可包含機關名:in(英寸)、cm(厘米)、mm(毫米)、pt(磅)、px(1/96英寸)、%(百分比),如“10mm”表示10毫米,寬和高相等時是圓。本參數可以用BottomMargin關鍵字轉義為列印區域相對于紙張的“下邊距”。

CodeType:

條碼類型,字元型。目前支援的類型(條碼規制)主要是一維條碼,有如下幾種:

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二維碼,其它為一維碼。預設情況下QRCode的版本會根據寬度和高度自動調整,頁面程式也可以直接設定具體版本(有1、3、7、14四個簡約版本可選),版本固定時會按寬度和高度自動縮放條碼大小。

CodeValue:

條碼值。

結果:無

建議或要求:

要求在初始化之後,列印或預覽之前調用。

ADD_PRINT_CHART

名稱:增加圖表

格式:

ADD_PRINT_CHART(Top, Left,Width, Height, ChartType, strHtml)

功能:增加圖表列印項,設定該圖表在紙張内的位置和大小,指定圖表的類型和生成圖表的資料來源,一般資料來源于一個超文本的Table,本函數可以快速清晰的生成任何複雜的圖表。

參數:

Top:

該圖表在紙張内的上邊距,整數或字元型,整數時預設長度機關為px。字元型時可包含機關名:in(英寸)、cm(厘米)、mm(毫米)、pt(磅)、px(1/96英寸)、%(百分比),如“10mm”表示10毫米。

Left:

該圖表在紙張内的左邊距,整數或字元型,整數時預設長度機關為px。字元型時可包含機關名:in(英寸)、cm(厘米)、mm(毫米)、pt(磅)、px(1/96英寸)、%(百分比),如“10mm”表示10毫米。

Width:

該圖表的總寬度,整數或字元型,整數時預設長度機關為px。字元型時可包含機關名:in(英寸)、cm(厘米)、mm(毫米)、pt(磅)、px(1/96英寸)、%(百分比),如“10mm”表示10毫米。本參數可以用RightMargin關鍵字轉義為列印區域相對于紙張的“右邊距”。

Height:

該圖表的高度,整數或字元型,整數時預設長度機關為px。字元型時可包含機關名:in(英寸)、cm(厘米)、mm(毫米)、pt(磅)、px(1/96英寸)、%(百分比),如“10mm”表示10毫米。本參數可以用BottomMargin關鍵字轉義為列印區域相對于紙張的“下邊距”。

ChartType:

圖表類型代碼,整數型,目前支援的圖表類型有如下幾種:

0--折線圖;1--柱狀圖;2--條形圖;3--面積圖;4--散點圖;5--餅圖;

6--直線圖;7--甘特圖;8--箭頭圖;9--氣泡圖;10—幾何圖;

strHtml:

table的超文本代碼,用該table的資料來生成圖表,資料結構定義如下幾種:

一是“通用table”結構,這種結構的第一行提供圖表的Label,第一列提供圖表的圖例名稱,其它行列單元提供圖表的Value,多數情況下Label作為X軸資料、Value作為Y軸資料來建立圖表,本結構适合前7種圖表;

二是“甘特圖table”結構,這種結構僅适合甘特圖,該Table的第一列是甘特圖的階段名稱,可任意起名,第二列是“計劃開始時間”,第三列是“計劃完成時間”,第四列是“實際開始時間”,第五列是“實際完成時間”。注意第一行第二列和第一行第三列的“名稱相同部分”會與第一列的内容組合成圖表的“開始階段的标注”,第一行第四列和第一行第五列的“名稱相同部分”會與第一列的内容組合成圖表的“實際階段的标注”,。

三是“箭頭圖table”結構,這種結構僅适合箭頭圖,該Table的第一列是每個箭頭的名稱,可任意起名,第二列是“箭頭起點X值”,第三列是“箭頭起點Y值”,第四列是“箭頭終點X值”,第五列是“箭頭終點Y值”。

四是“氣泡圖table”結構,這種結構僅适合氣泡圖,該Table的第一列是每個氣泡的名稱,可任意起名,第二列是“氣泡圓心X值”,第三列是“氣泡圓心Y值”,第四列是“氣泡圓的半徑值”。

五是“幾何圖table”結構,這種結構僅适合幾何圖,該Table的第一列是每個幾何圖的名稱,可任意起名,第二列是“左下角位置X值”,第三列是“左下角位置Y值”,第四列是“幾何圖的寬”,第五列是“幾何圖的高”,第六列是“幾何圖的圖形代碼”,第七列是“幾何圖的顔色”,第八列是“幾何圖是否透明”,1代表透明,0代表不透明。其中圖形代碼如下:0-矩形;1--圓形;2--豎線;3--橫線;4--三角形;5--倒三角形;6--斜線;7--菱形;8--立方體;9--十字線;10--斜十字線;11--米字線;12--三角錐;13--倒三角錐。顔色有RGB值、16進制組合值或英文名三種描述法。

結果:無

建議或要求:

要求在初始化之後,列印或預覽之前調用。

SET_PRINT_STYLE

名稱:設定列印項風格

格式:

SET_PRINT_STYLE(strStyleName,varStyleValue)

功能:設定列印項的輸出風格,成功執行該函數,此後再增加的列印項按此風格輸出。

參數:

strStyleName:列印風格名,風格名稱及其含義如下:

“FontName”:設定純文字列印項的字型名稱。

“FontSize”:設定純文字列印項的字型大小。

“FontColor”:設定純文字列印項的字型顔色。

“Bold”:設定純文字列印項是否粗體。

“Italic”:設定純文字列印項是否斜體。

“Underline”:設定純文字列印項是否下滑線。

“Alignment”:設定純文字列印項的内容左右靠齊方式。

“Angle”:設定純文字列印項的旋轉角度。

“ItemType”:設定列印項的基本屬性。

“HOrient”:設定列印項在紙張内的水準位置鎖定方式。

“VOrient”:設定列印項在紙張内的垂直位置鎖定方式。

“PenWidth”:線條寬度。

“PenStyle”:線條風格。

“Stretch”:圖檔截取縮放模式。

“PreviewOnly”:内容僅僅用來預覽。

“ReadOnly”:純文字内容在列印維護時,是否禁止修改。

varStyleValue:列印風格值,相關值如下:

FontName的值:字元型,與作業系統字型名一緻,預設是“宋體”。

FontSize的值:數值型,機關是pt,預設值是9,可以含小數,如13.5。

FontColor的值:整數或字元型,整數時是顔色的十進制RGB值;字元時是超文本顔色值,可以是“#”加三色16進制值組合,也可以是英文顔色名;

Bold的值:數字型,1代表粗體,0代表非粗體,預設值是0。

Italic的值:數字型,1代表斜體,0代表非斜體,預設值是0。

Underline的值:數字型,1代表有下劃線,0代表無下劃線,預設值是0。

Alignment的值:數字型,1--左靠齊 2--居中 3--右靠齊,預設值是1。

Angle的值:數字型,逆時針旋轉角度數,機關是度,0度表示不旋轉。

ItemType的值:數字型,0--普通項 1--頁眉頁腳 2--頁号項 3--頁數項 4--多頁項

預設(不調用本函數時)值0。普通項隻列印一次;頁眉頁腳項則每頁都在固定位置重複列印;頁号項和頁數項是特殊的頁眉頁腳項,其内容包含目前頁号和全部頁數;多頁項每頁都列印,直到把内容列印完畢,列印時在每頁上的位置和區域大小固定一樣(多頁項隻對純文字有效)

在頁号或頁數對象的文本中,有兩個特殊控制字元:

“#”特指“頁号”,“&”特指“頁數”。

HOrient的值:數字型,0--左邊距鎖定 1--右邊距鎖定 2--水準方向居中 3--左邊距和右邊距同時鎖定(中間拉伸),預設值是0。

VOrient的值:數字型,0--上邊距鎖定 1--下邊距鎖定 2--垂直方向居中 3--上邊距和下邊距同時鎖定(中間拉伸),預設值是0。

PenWidth的值:整數型,機關是(列印)像素,預設值是1,非實線的線條寬也是0。

PenStyle的值:數字型,0--實線 1--破折線 2--點線 3--點劃線 4--雙點劃線

預設值是0。

Stretch的值:數字型,0--截取圖檔 1--擴充(可變形)縮放 2--按原圖長和寬比例(不變形)縮放。預設值是0。

PreviewOnly的值:字元或數字型,1或“true”代表僅預覽,否則為正常内容。

ReadOnly的值:字元或數字型,1或“true”代表“是”,其它表示“否”,預設值為“是”,即預設情況下,純文字内容在列印維護時是禁止修改的。

結果:無

建議或要求:

列印初始化後、增加列印項之前調用本函數。

NEWPAGE

名稱:強制分頁

格式:NEWPAGE()

功能:強制分頁。執行該函數之後所增加的内容會在前面内容的首頁之後建立一頁輸出,前面無内容時,仍然從第一頁開始。

參數:無

結果:傳回邏輯值

傳回邏輯真表示強制分頁成功,邏輯假表示強制分頁失敗。

建議或要求:

列印初始化後調用本函數。

PREVIEW

名稱:列印預覽

格式:PREVIEW()

功能:列印預覽輸出頁。

參數:無

結果:顯示列印預覽界面。如果預覽界面沒有被嵌入頁面中,而是被彈出視窗,那麼關閉視窗時會傳回數字結果值,該數字大于0時表示被實際列印的次數。

建議或要求:

建立列印頁之後運作。

PRINT

名稱:直接列印

格式:PRINT()

功能:不經列印預覽的直接列印。

參數:無

結果:列印機開始實際列印,傳回邏輯結果,正确列印時傳回真,列印出錯時傳回假。

建議或要求:

建立列印頁之後運作。

PRINT_SETUP

名稱:列印維護

格式:PRINT_SETUP()

功能:對整頁的列印布局和列印風格進行界面維護,它與列印設計的差別是不具有列印項增删功能,目标使用者是最終使用者。

參數:無

結果:顯示列印維護界面。如界界面沒有被嵌入頁面中,而是被彈出視窗,那麼關閉視窗時會傳回數字結果值,該數字大于0時表示被實際列印的次數,這裡的實打次數包括列印維護界面“列印”按鈕的直接列印和“預覽”按鈕進入預覽後的列印。

建議或要求:

建立列印頁之後運作。

PRINT_DESIGN

名稱:列印設計

格式:PRINT_DESIGN ()

功能:對整頁的列印布局和列印風格進行界面設計,它與列印維護的差別是具有列印項增删功能,目标使用者是軟體開發者。

參數:無

結果:顯示列印設計界面,設計完畢關閉視窗後,傳回生成的程式代碼。

建議或要求:

建立列印頁之後運作。

GET_PRINTER_COUNT

名稱:獲得列印裝置個數

格式:GET_PRINTER_COUNT()

功能:獲得作業系統内列印裝置的個數。

參數:無

結果:傳回數字

傳回數字結果表示作業系統内的列印裝置個數,0表示失敗或無列印裝置。

建議或要求:

任何時間調用均可。

GET_PRINTER_NAME

名稱:獲得列印裝置名稱

格式:GET_PRINTER_NAME(intPrinterNO)

功能:按列印裝置序号獲得其名稱。

參數:

intPrinterNO:

列印裝置序号,數字型,序号從0開始,最大序号是GET_PRINTER_COUNT()減1。

結果:傳回字元

傳回字元結果表示作業系統内的列印裝置的名稱,空表示失敗或無該裝置。

建議或要求:

任何時間調用均可。

SET_PRINTER_INDEX

名稱:指定列印裝置

格式:SET_PRINTER_INDEX(oIndexOrName)

功能:按名稱或序号指定要進行列印輸出的裝置,指定後禁止重新選擇。。

參數:

oIndexOrName:

列印機名稱或序号,字元或數字型。數字表示列印機的序号,從0開始,最大序号是GET_PRINTER_COUNT()減1。-1特指作業系統内設定的預設列印機。

字元代表列印機的名稱,與作業系統内的列印機名稱一緻。

注:用本函數指定列印機後,在預覽界面不允許重新選擇列印機,而用另外一個函數SET_PRINTER_INDEXA指定後則允許重新選擇。

結果:傳回邏輯值

傳回邏輯真表示指定成功,邏輯假表示指定失敗,失敗原因有:該列印裝置不存在。

建議或要求:

要求在初始化之後、列印或預覽之前調用。

SELECT_PRINTER

名稱:選擇列印裝置

格式:SELECT_PRINTER

功能:彈出界面標明某列印裝置為固定輸出裝置。

參數:無

結果:傳回數字

傳回數字結果表示標明的裝置序号,傳回-1表示放棄選擇,沒有任何動作。

建議或要求:

直接列印前或列印預覽前調用。本函數與SET_PRINTER_INDEX的功能效果一樣。

SET_SHOW_MODE

名稱:設定顯示模式

格式:

SET_SHOW_MODE (strModeType,varModeValue)

功能:設定列印預覽、列印維護和列印設計的顯示模式,設定列印預覽時是否包含背景圖等。

參數:

strModeType顯示模式的名稱,字元型,如下是類型名及其含義:

“PREVIEW_IN_BROWSE”:列印預覽界面是否内嵌到網頁内部。

“SETUP_IN_BROWSE”: 列印維護界面是否内嵌到網頁内部。

“DESIGN_IN_BROWSE”:列印設計界面是否内嵌到網頁内部。

“BKIMG_IN_PREVIEW”:列印預覽時是否包含背景圖。

“BKIMG_IN_FIRSTPAGE”:列印預覽時是否僅首頁包含背景圖。

“SETUP_ENABLESS”:列印維護界面工具顯示控制(權限控制字串)

“SKIN_TYPE”:界面皮膚類型

“SKIN_CUSTOM_COLOR”:界面自定義皮膚顔色

“HIDE_PBUTTIN_PREVIEW”:隐藏預覽視窗的列印按鈕

“HIDE_SBUTTIN_PREVIEW”:隐藏預覽視窗的列印設定按鈕

“HIDE_QBUTTIN_PREVIEW”:隐藏預覽視窗的關閉按鈕

“HIDE_PBUTTIN_SETUP”:隐藏列印維護視窗的列印按鈕

“HIDE_VBUTTIN_SETUP”:隐藏列印維護視窗的預覽按鈕

“HIDE_ABUTTIN_SETUP”:隐藏列印維護視窗的應用按鈕

“HIDE_RBUTTIN_SETUP”:隐藏列印維護視窗的複原按鈕

“MESSAGE_GETING_URL”:URL對象下載下傳時的提示資訊

“MESSAGE_PARSING_URL”:URL對象解析時的提示資訊

“MESSAGE_PARSING_HTM”:HTM對象解析時的提示資訊

“MESSAGE_NOSET_PROPERTY”:列印維護界面企圖進入屬性設定的警示資訊

“HIDE_PAPER_BOARD”:隐藏列印預覽背景進紙版的圖案

“LANDSCAPE_DEFROTATED”:橫向列印的預覽預設旋轉90度(正向顯示)

“BKIMG_LEFT”:設定背景圖位置X值

“BKIMG_TOP”:設定背景圖位置Y值

“BKIMG_WIDTH”:設定背景圖寬度

“BKIMG_HEIGHT”:設定背景圖高度

“HIDE_PAGE_PERCENT”:隐藏整頁縮放(百分比)的下拉選擇框

“LANGUAGE”:設定界面文字的語言

varModeValue顯示模式的值,整數或字元型,相關值如下:

PREVIEW_IN_BROWSE的值:整數或字元型,1或“1”或“True”=是,否則不是。

SETUP_IN_BROWSE的值:整數或字元型,1或“1”或“True”=是,否則不是。

DESIGN_IN_BROWSE的值:整數或字元型,1或“1”或“True”=是,否則不是。

BKIMG_IN_PREVIEW的值:整數或字元型,1或“1”或“True”=是,否則不是。

BKIMG_IN_FIRSTPAGE的值:整數或字元型,1或“1”或“True”=是,否則不是。

SETUP_ENABLESS的值:字元型,由“1”和“0”組成的字元串,最多14個字元,

按如下順序控制列印維護的界面功能,“1”-允許,“0”-禁止:

位置移動和寬高調整1+顔色選擇2+字型名選擇3+字大小選擇4+旋角調整5+粗斜體功能條6+線型功能條7+對齊功能條8+删除功能9+頁眉設定10+頁腳設定11+位置鎖定功能12+屬性設定13+顯示關閉鈕(界面内嵌時)14

預設的SETUP_ENABLES值:“11111111000001”

例如:如想允許操作者“删除”對象,可以執行如下語句;

LODOP.SET_SHOW_MODE("SETUP_ENABLES","11111111100001");

SKIN_TYPE的值:數字型,固定皮膚如下:

0--銀灰色(預設);1--經典綠; 2--熏衣草紫;3--淡鋼青;4--茶色棕;5--茶色棕;

6--麥色;7--紫羅蘭;8--天藍;9--鍍銀;10--沙灘棕;11--鮮肉色;12--粉末藍;13--釩礦色;

14--淺綠;15--淺藍;16--卡其布; 17--秋麒麟;18--深海綠;19--深卡其布;20--番茄桔

SKIN_CUSTOM_COLOR的值:整數或字元型,整數時是顔色的十進制RGB值;字元時是超文本顔色值,可以是“#”加三色16進制值組合,也可以是英文顔色名。

HIDE_PBUTTIN_PREVIEW的值:整數或字元型,1或“1”或“True”=是,否則不是。

HIDE_SBUTTIN_PREVIEW的值:整數或字元型,1或“1”或“True”=是,否則不是。

HIDE_QBUTTIN_PREVIEW的值:整數或字元型,1或“1”或“True”=是,否則不是。

HIDE_PBUTTIN_SETUP的值:整數或字元型,1或“1”或“True”=是,否則不是。

HIDE_VBUTTIN_SETUP的值:整數或字元型,1或“1”或“True”=是,否則不是。

HIDE_ABUTTIN_SETUP的值:整數或字元型,1或“1”或“True”=是,否則不是。

HIDE_RBUTTIN_SETUP的值:整數或字元型,1或“1”或“True”=是,否則不是。

MESSAGE_GETING_URL的值:字元型,預設值是“正打開頁面下載下傳資料(限時5分鐘)...”。

MESSAGE_PARSING_URL的值:字元型,預設值是“下載下傳結束,正在準備列印資料...”。

MESSAGE_PARSING_HTM的值:字元型,預設值是空(不提示資訊),當超文本内容較多,有明顯等待時間時,建議設定該值。

MESSAGE_NOSET_PROPERTY的值:字元型,預設值是“隻有在設計模式下才能設定屬性...”。

HIDE_PAPER_BOARD的值:整數或字元型,1或“1”或“True”=是,否則不是。

LANDSCAPE_DEFROTATED的值:整數或字元型,1或“1”或“True”=是,否則不是。

BKIMG_LEFT的值:整數或字元型。整數的機關是PX,字元時可以包含具體計量機關。

BKIMG_TOP的值:同上;

BKIMG_WIDTH的值:同上;

BKIMG_HEIGHT的值:同上;

HIDE_PAGE_PERCENT的值:整數或字元型,1或“1”或“True”=是,否則不是。

LANGUAGE的值:數字,0-簡體中文 1-英文 2-繁體 3-BIG5(繁體)

結果:傳回邏輯結果,成功時傳回真,失敗時傳回假。

建議或要求:

初始化之後,進入功能(列印預覽、列印維護或列印設計)界面前調用本函數。

SET_PRINT_MODE

名稱:設定列印模式

格式:

SET_PRINT_MODE (strModeType,varModeValue)

功能:設定人工雙面列印模式等。

參數:

strModeType模式類型名,字元型,如下是類型名及其含義:

“DOUBLE_SIDED_PRINT”:設定是否人工雙面列印。

“PRINT_START_PAGE”:指定要列印的起始頁。

“PRINT_END_PAGE”:指定要列印的截止頁。

“PRINT_PAGE_PERCENT”:指定整頁縮放列印的比例。

“AUTO_CLOSE_PREWINDOW”:設定列印完畢是否自動關閉預覽視窗。

“PRINT_SETUP_PROGRAM”:設定列印維護視窗關閉後是否傳回程式代碼。

“NOCLEAR_AFTER_PRINT”:設定列印或預覽後内容不清空是否為真。

“CATCH_PRINT_STATUS”:設定是否進行對背景服務的列印狀态進行捕獲。

varModeValue模式類型值,整數或字元型,相關值如下:

DOUBLE_SIDED_PRINT的值:整數或字元型,1或“1”或“True”=是,否則不是。

PRINT_START_PAGE的值:整數,不設定本參數時,控件預設從1開始列印。适用列印部分頁時。

PRINT_END_PAGE的值:整數,不設定本參數時,控件預設列印到最後頁。适用列印部分頁時。

PRINT_PAGE_PERCENT的值:字元型,具體值有如下幾種:

“Full-Width” –寬度按紙張的整寬縮放;

“Full-Height”–高度按紙張的整高縮放:

“Full-Page” –按整頁縮放,也就是既按整寬又按整高縮放;

此外還可以按具體百分比例,格式為“Width:XX%;Height:XX%”或“XX%”

比值範圍是5%-800%,也就是最大縮小到原來的5%,最大放大8倍。

AUTO_CLOSE_PREWINDOW的值:整數或字元型,1或“1”或“True”=是,否則不是。

PRINT_SETUP_PROGRAM的值:整數或字元型,1或“1”或“True”=是,否則不是,列印維護視窗關閉後如果不傳回程式代碼,則傳回列印按鈕被點選的次數。

NOCLEAR_AFTER_PRINT的值:整數或字元型,1或“1”或“True”=是,否則不是,預設值是“否”,也就是說,預設情況下列印或預覽後會清空所有内容。

CATCH_PRINT_STATUS的值:整數或字元型,1或“1”或“True”=是,否則不是,預設值是“否”,也就是說,預設情況下列印時不對列印狀态進行捕獲,該捕獲動作會針對每個列印機開啟一個監控線程,對頁面性能有少許影響,開啟後用GET_VALUE獲得狀态值。

結果:傳回邏輯結果,成功時傳回真,失敗時傳回假。

建議或要求:

直接列印前或列印預覽前調用。

SET_PREVIEW_WINDOW

名稱:設定預覽視窗

格式:

SET_PREVIEW_WINDOW(intDispMode, intToolMode,blDirectPrint,inWidth,intHeight

, strTitleButtonCaptoin)

功能:設定預覽視窗的顯示模式和大小。

參數:

intDispMode預覽比例,數字型,0--适高1--正常大小2--适寬。

intToolMode工具條和按鈕,數字型 0--顯示工具條1--顯示按鈕 2--兩個都顯示 3--兩個都不顯示

blDirectPrint列印按鈕是否“直接列印” 1-是 0-否(彈出界面“選機列印”)

inWidth 視窗寬,整數型,機關是px

intHeight 視窗高,整數型,機關是px

當inWidth或intHeight小于等于0時視窗最大化。

strTitleButtonCaptoin 預覽視窗和列印按鈕的名稱組合,字元型,用“點”分隔,譬如“預覽檢視.開始列印”,表示預覽視窗的标題是“預覽檢視”,按鈕名是“開始列印”。

結果:無

建議或要求:

直接列印前或列印預覽前調用。

ADD_PRINT_SETUP_BKIMG

名稱:指定背景圖

格式:ADD_PRINT_SETUP_BKIMG(strImgHtml)

功能:用程式方式指定列印維護或列印設計的背景圖。

參數:

strImgHtml:

本參數是字元型,有兩種情況:一是超文本代碼内容;二是本地檔案名内容。第一種情況一般是用IMG标簽組成的超文本代碼段落。第二種情況是本地檔案名全路徑,格式如“C:/test.jpg”,圖檔檔案可以是jpg、jpeg、bmp、gif、ico、png、emf等格式。

結果:無

建議或要求:

初始化之後調用。

SEND_PRINT_RAWDATA

名稱:發送原始資料

格式:SEND_PRINT_RAWDATA(strRawData)

功能:向列印機發送原始資料或指令。

參數:

strRawData:資料或指令值,字元型,未限制長度。

結果:傳回邏輯結果,發送成功時傳回真,發送失敗時傳回假。

建議或要求:

任何時間調用。

WRITE_PORT_DATA

名稱:寫端口資料

格式:WRITE_PORT_DATA(strPortName,strData)

功能:直接向端口寫資料或指令。

參數:

strPortName:端口名,同作業系統的端口名,名稱如下:

LPT1、LPT2、LPT3、COM1、COM2、COM3…

strData:資料或指令值,字元型,未限制長度。

當設定端口通訊參數時strData格式如下:

mode com1:波特率,校驗,資料位,停止位,讀時限,寫時限

其中mode為固定關鍵字,com1要和strPortName保持一直。

校驗值有:N(noparity)O(oddparity) E(evenparity) M(markparity)S(spaceparity)

讀時限和寫時限的時間機關為毫秒,舉例如下:

WRITE_PORT_DATA(“com1”,“mode com1:2400,n,8,1”)

或WRITE_PORT_DATA(“com2”,“mode com2:2400,n,7,2,5000,2000”)

結果:傳回邏輯結果,發送成功時傳回真,發送失敗時傳回假。

建議或要求:

任何時間調用。

READ_PORT_DATA

名稱:讀端口資料

格式:READ_PORT_DATA(strPortName)

功能:直接從端口讀資料。

參數:

strPortName:端口名,同作業系統的端口名,名稱如下:

LPT1、LPT2、LPT3、COM1、COM2、COM3…

結果:傳回字元資料。

建議或要求:

任何時間調用。

GET_PRINT_INIFFNAME

名稱:獲得配置檔案名

格式:GET_PRINT_INIFFNAME (strPrintTask)

功能:獲得某列印任務的本地配置檔案全路徑名。

參數:

strPrintTask:

列印任務名,字元型,即初始化時所設的任務名。

結果:傳回字元

傳回字元結果表示本地配置檔案全路徑名(并非檔案内容),空表示失敗。

建議或要求:

在初始化之後調用。

GET_PAGESIZES_LIST

名稱:獲得紙張類型名清單

格式:GET_PAGESIZES_LIST(oPrinterName,strSplit)

功能:獲得某個列印機所支援的紙張類型名清單,傳回一個用分隔符連結的長字元串。

參數:

oPrinterName:

列印機名稱或序号,字元型或數字,序号從0開始,-1代表預設列印機。

strSplit:

分隔符,字元型,例如可以用“\n”代表換行控制符來分隔。

結果:傳回字元串。

建議或要求:

任何時候調用。

WRITE_FILE_TEXT

名稱:寫本地檔案内容

格式:WRITE_FILE_TEXT(intWriteMode,strFileName, strText)

功能:向本地檔案寫入文本内容。

參數:

intWriteMode:

寫入模式,數字型,0--檔案覆寫模式 1--檔案尾追加模式 2--檔案首插入模式。

strFileName:

本地檔案名,字元型,檔案名包含全路徑。

strText:

寫入的文本内容,字元型。

結果:調用函數後控件啟動安全提示,等待操作許可。

傳回字元值表示寫入情況:

“ok”-寫入成功

“file not exist”-檔案不存在

“do nothing”-未寫入,一般原因有:操作者禁止讀寫、檔案隻讀屬性等。

寫入時如果檔案不存在則自動建立。

建議或要求:

任何時間調用。

GET_FILE_TEXT

名稱:讀本地檔案内容

格式:GET_FILE_TEXT(strFileName)

功能:讀本地檔案文本内容。

參數:

strFileName:

本地檔案名,字元型,含全路徑。

結果:調用函數後控件啟動安全提示,等待操作許可。

傳回字元值,文本内容。

傳回空原因:檔案不存在;内容真實空;操作者禁止讀寫;

建議或要求:

任何時間調用。

GET_FILE_TIME

名稱:讀本地檔案時間

格式:GET_FILE_TIME (strFileName)

功能:讀本地檔案最後修改時間。

參數:

strFileName:

本地檔案名,字元型,含全路徑。

結果:傳回字元值,最後修改時間,時間樣式:yyyy-mm-dd hh:mm:ss。

傳回空原因:檔案不存在;

建議或要求:

任何時間調用。

IS_FILE_EXIST

名稱:判斷本地檔案是否存在

格式:IS_FILE_EXIST (strFileName)

功能:判斷本地檔案是否存在。

參數:

strFileName:

本地檔案名,字元型,含全路徑。

結果:傳回邏輯值,邏輯真表示檔案存在,邏輯假表示檔案不存在。

建議或要求:

任何時間調用。

GET_SYSTEM_INFO

名稱:獲得系統資訊

格式:GET_SYSTEM_INFO (strInfoType)

功能:獲得用戶端的系統資訊。

參數:strInfoType:

資訊類型,字元型,資訊類型是“裝置類型”和“裝置屬性”的名稱組合,用點(“.”)聯結。當有多個同類裝置存在時,裝置類型後加“點和序号”來指定某裝置。裝置類型和屬性的名稱見WMI(MicrosoftWindows管理規範),以下是一組典型資訊類型名:

Drive.Count ----全部驅動的個數

Drive.Labels ----所有驅動的盤符

DiskDrive.Count ---硬碟個數

DiskDrive.1.Label ---第一個硬碟的盤符

DiskDrive.1.SerialNumber ---主硬碟的序列号

CDROMDrive.Count --CD光牒的個數

CDROMDrive.1.Label ---第一個CD光牒的盤符

CDROMDrive.1.SerialNumber ----第一個CD光牒的序列号

RemovableDrive.Count ---優盤的個數

RemovableDrive.1.Label ---第一個優盤的盤符

RemovableDrive.1.SerialNumber ---第一個優盤的序列号

NetworkAdapter.Count ---網卡個數

NetworkAdapter.1.PhysicalAddress ---主網卡實體(MAC)位址

NetworkAdapter.1.IPAddress ---主網卡IP位址

NetworkAdapter.1.SubNetMask ---主網卡子網路遮罩(Mask)

BIOS.SerialNumber ---BIOS序列号

BaseBoard.SerialNumber ---主機闆序列号

其它資訊請查閱WMI資料。

結果:傳回字元

傳回字元或整數,表示系統資訊值,null表示讀取失敗。

建議或要求:

任何時間調用。

GET_VALUE

名稱:獲得資料值

格式:GET_VALUE (ValueType, ValueIndex)

功能:獲得程式代碼、列印項屬性等資料值。

參數:ValueType:

資料值類型,字元型,如下是類型名及其含義:

ProgramCodes ----目前列印設計或維護界面所有列印項生成的程式代碼

ItemTop ----列印項上邊距

ItemLeft----列印項左邊距

ItemWidth ----列印項寬度

ItemHeight ----列印項高度

ItemContent ----列印項内容

ItemClass(或ItemType) ----列印項對象類别

ItemClassName ----列印項對象類别名

ItemPageType ----列印項對象類型

ItemName ----列印項對象類名

ItemFontName ----列印項字型名稱

ItemFontSize ----列印項字型大小

ItemColor ----列印項字型顔色

ItemAlign ----列印項靠齊方式

Itembold ----列印項是否粗體

ItemItalic----列印項是否斜體

ItemUnderline ----列印項是否下劃線

ItemPenWidth ----列印項線條寬度

ItemPenStyle- ---列印項線條類型

ItemHorient ----列印項左右位置

ItemVorient ----列印項上下位置

ItemAngle----列印項旋轉角度

ItemStretch----列印項的圖檔縮放模式

ItemReadOnly ----列印項的列印維護内容隻讀

ItemPreviewOnly ----列印項是否僅預覽

ItemPageIndex ----列印項的目标輸出頁号

ItemNumberStartPage ----列印項的頁号起始頁号

ItemStartNumberValue----列印項頁号起始值

ItemLineSpacing ----列印項行間距

ItemLetterSpacing ----列印項字間距

ItemExist ----該列印項是否存在,增加又删除也算不存在。

ItemIsAdded ----該列印項是否被增加過,被删除也算增加過。

ItemIsDeleted ----該列印項是否增加過且已被删除;

其中ItemExist、ItemIsAdded、ItemIsDeleted一般用項目名來判斷,不适合用序号。

ItemGroundColor(或ItembackWallColor或GroundColor)----該列印項的背景色

ItemIndex----該列印項序号

ItemShowBarText ----該條碼列印項是否顯示條碼文字

ItemQRCodeVersion----該列印項QRCode版本号

ItemTextFrame ----該列印項邊框類型

ItemSpacePatch ----該列印項文本尾是否補空格

ItemAlignJustify ----該列印項文本兩端是否靠齊

ItemTranscolor ----該列印項圖檔透明背景色

ItemTop2Offset ----該列印項次頁上邊距偏移

ItemLeft2Offset ----該列印項次頁左邊距偏移

ItemTableHeightScope ----該列印項表格高是否含頭腳

ItemLinkedItem ----該列印項的關聯對象序号

BKIMG_CONTENT----背景圖位址

BKIMG_LEFT----背景圖的X坐标(顯示px)

BKIMG_TOP----背景圖的Y坐标(顯示px)

BKIMG_WIDTH----背景圖的寬度(顯示px)

BKIMG_HEIGHT----背景圖的高度(顯示px)

PrintInitTop ----整體上邊距

PrintInitLeft----整體左邊距

PrintInitWidth ----編輯區寬度

PrintInitHeight ----編輯區高度

PrintTaskName ----列印任務的名稱

PRINTED_TIMES或PRINTEDTIMES ---目前内容已列印次數(列印設計、維護和預覽界面内嵌時)

PREVIEW_PAGE_COUNT----列印預覽界面内嵌時,獲得總頁數

PREVIEW_PAGE_NUMBER----列印預覽界面内嵌時,獲得目前頁号

PREVIEW_ZOOM_STATE----列印預覽界面内嵌時,獲得顯示縮放代碼

代碼值含義如下:

0--适高 1--适寬 2--縮25% 3--縮50% 4--縮75% 5--正常

6--放150% 7--放200% 8--放300% 9--放500%

PREVIEW_PERCENT----列印預覽界面内嵌時,獲得縮放列印比例,該代碼及其含義參考函數DO_ACTION中同名參數的說明。

PREVIEW _ PRINTEDTIMES----列印預覽界面内嵌時,獲得被列印次數

PRINTSETUP_PAGE_WIDTH----列印設定的紙張寬度,機關是0.1mm

PRINTSETUP_PAGE_HEIGHT----列印設定的紙張高度,機關是0.1mm

PRINTSETUP_SIZE_WIDTH----所設紙張的可列印寬度,機關是0.1mm

PRINTSETUP_SIZE_HEIGHT----所設紙張的可列印高度,機關是0.1mm

PRINTSETUP_TOPMARGIN----所設紙張的不可打上邊距,機關是0.1mm

PRINTSETUP_LEFTMARGIN----所設紙張的不可打左邊距,機關是0.1mm

PRINTSETUP_PRINTER_NAME---目前選擇的列印機名稱

PRINTSETUP_ORIENT----目前設定的列印方向

PRINTSETUP_COPIES----目前設定的列印份數

PRINTSETUP_PAGESIZE_NAME----目前紙張類型名稱

PRINT_STATUS_JOBID ----最新JOB代碼(值有列印機序号和JOB序号組成)

PRINT_STATUS_ID----列印狀态代碼

PRINT_STATUS_TEXT----目前列印狀态描述

PRINT_STATUS_LIST----列印狀态變化記錄

PRINT_STATUS_TOTAL_PAGES----該任務需要列印的總頁數

PRINT_STATUS_PAGES_PRINTED----該任務已經列印的總頁數

PRINT_STATUS_DOCNAME----該列印任務的文檔名稱

PRINT_STATUS_ADDTIME----該列印任務的建立時間

PRINT_STATUS_EXIST---判斷該列印任務是否還處在隊列中

PRINT_STATUS_OK----該列印任務是否已經列印成功

PRINT_STATUS_SECONDS----該列印任務持續的時間(秒)

PRINT_STATUS_BUSY----該列印機是否處于忙碌狀态

ValueIndex:

數值對應的項目序号或項目名稱,數字或字元型,序号從1開始;有如下幾種特殊情況:

1:當ValueIndex等于selected時,代表列印設計或列印維護界面標明的對象;

2:當ValueIndex等于unSelected時,代表列印設計或列印維護界面沒有標明的對象;

3:當ValueIndex等于first或last時,分别代表第一對象和最後一個對象;

4:ValueType為列印狀态(各種PRINT_STATUS_XXX)時,ValueIndex是列印任務的JOB代碼,該代碼通過PRINT及PREVIEW指令傳回,或者本函數的PRINT_JOBID參數獲得;要使用各種PRINT_STATUS_XXX,必須用函數SET_PTINT_MODE打開其“CATCH_PRINT_STATU”模式。

結果:傳回字元

傳回對應的字元型、整數型或邏輯值,傳回空字元表示讀取失敗。

建議或要求:

列印設計或列印維護運作期間調用。

FORMAT

名稱:資料格式轉換

格式:FORMAT (oType, oValue)

功能:按一定的格式類型對資料進行轉換後,傳回轉換結果。

參數:

oType:

格式類型,字元型,目前可轉換的資料類型有“時間”“浮點數”“字元串”“檔案”“顔色”等幾大類:

1、日期時間通用格式:TIME:通用格式表達式

通用格式表達式可參考作業系統的日期時間格式,有日期和時間兩部分組成,在日期部分y代表年,m代表月,d代表日;在時間部分h代表小時,m或n代表分鐘,s代表秒,分隔符在這些字元之外任意設定,dddd表示星期。

例如:“TIME:yyyy-mm-dd hh:mm:ss” “TIME:yyyy年mm月dd日”

“TIME:yyyy/mm/dd hh:mm:ss”“TIME:yyyy年mm月dd日hh時nn分ss秒”

轉換後傳回的結果為字元串。

2、日期時間的浮點值:TIME: FloatValue

傳回日期時間資料的浮點值。

3、日期時間格式有效判斷:TIME: IsValidFormat

判斷時間資料有效與否,傳回的是邏輯真假值。

4、日期的星期序号:TIME: WeekIndex

表示星期幾。傳回的是0…6之間的數字,其中0表示星期天,6表示星期六。

5、浮點資料格式:FLOAT:數值格式表達式

數值格式表達式由0 # . , E 等五個字母組成描述資料樣式的字串,其中0表示有則顯示,無則補零,#表示有則顯示,無則不顯示,E用于科學計數法。

例如:“FLOAT:#,##0.00” “FLOAT:0.00”“FLOAT:#.##”

6、人民币大寫:UpperMoney

特指人民币大寫轉換,傳回漢字串。

7、字元格式一:CHAR: FirstPinYin

獲得漢字的漢語拼音首字母,傳回的是字元串。

8、字元格式二:CHAR: IsCharacter

判斷資料是否純英文字元,不包含漢字,傳回的是邏輯真假值。

9、字元格式三:CHAR: IsChinese

判斷資料是否純漢字,不包含英文字母,傳回的是邏輯真假值。

10、字元格式四:CHAR: EncodeBase64

獲得普通字元的BASE64國際通用編碼,該編碼有大小寫字母、數字和+/=等組成,傳回的是字元串。

11、字元格式五:CHAR: DecodeBase64

獲得BASE64編碼串的解碼字元,是CHAR: EncodeBase64的逆過程。傳回的是普通字元串。

12、檔案格式一:FILE:EncodeBase64

獲得普通檔案的BASE64國際通用編碼,該編碼有大小寫字母、數字和+/=等組成,傳回的是字元串。要求對應的oValue值是檔案名及其路徑,且檔案存在,可以是任何檔案。本操作會引起控件的使用者安全确認提示。

13、檔案格式二:FILE: DecodeBase64,檔案路徑及其名稱

獲得BASE64編碼串的解碼檔案,是FILE:EncodeBase64的逆過程。傳回的是生成檔案成功與否的邏輯結果。例如:“FILE:DecodeBase64,C:\test1.jpg”

本操作會引起控件的使用者安全确認提示。

14、顔色格式一:COLOR:Hex

獲得顔色的十六進制表達式,“#”字母打頭,傳回的是字元串。

15、顔色格式二:COLOR:Name

獲得顔色的英文名稱,識别164種顔色值的名稱,傳回的是字元串。

16、顔色格式三:COLOR:Decimal

獲得顔色的十進制值(RGB值),傳回的是整數值。

oValue:

要轉換的目标資料,一般是字元串形式的資料,也可以是時間浮點值,當otype是FILE:EncodeBase64時該值是檔案名及其路徑,oValue有如下幾個特殊字元值:

Now-目前日期及其時間、Date目前日期、Time目前時間

舉例如下:

FORMAT(“UpperMoney”,”45.82”);把45.82轉換成人民币大寫形式;

FORMAT(“TIME:yyyy-mm-dd hh:mm:ss”,”now”);傳回目前日期及其時間;

FORMAT(“TIME:yyyy/mm/dd”,new Date());傳回目前日期;

結果:傳回轉換後的結果,傳回的資料有字元串、浮點數、邏輯值等類型。

建議或要求:

任何時間調用。

GET_DIALOG_VALUE

名稱:獲得對話框結果值

格式:GET_DIALOG_VALUE (oType,oPreValue)

功能:彈出一個對話框視窗,并傳回對話結果。

參數:

oType:

對話類型,字元型,具體類型及其含義如下:

LocalFileFullName:彈出一個定位本地檔案的對話框,并傳回檔案的全路徑名。

Color:彈出一個顔色對話框,并傳回所選16進制顔色表達式,放棄則傳回空。

oPreValue

檔案類型或顔色原值

“LocalFileFullName”的PreValue值是指檔案類型,例如“*.bmp;*.jpg”“*.mdb”。

“Color”的PreValue是顔色對話框的預設值。

結果:傳回對話結果值,字元型。

建議或要求:

任何時間調用。

2、擴充函數

PRINT_INITA

名稱:(擴充型)列印初始化

格式:PRINT_INITA(Top,Left,Width,Height,strPrintName)

功能:列印初始化、設定紙張整體偏移量、設定可視編輯區域大小

參數:

Top:

整頁上邊距,整數或字元型,整數時預設長度機關為px。字元型時可包含機關名:in(英寸)、cm(厘米)、mm(毫米)、pt(磅)、px(1/96英寸)、%(百分比),如“10mm”表示10毫米,不設定時(用PRINT_INIT初始化)預設值為0。

Left:

整頁左邊距,整數或字元型,整數時預設長度機關為px。字元型時可包含機關名:in(英寸)、cm(厘米)、mm(毫米)、pt(磅)、px(1/96英寸)、%(百分比),如“10mm”表示10毫米,不設定時(用PRINT_INIT初始化)預設值為0。

Width:

可視編輯區域的寬度,整數或字元型,整數時預設長度機關為px。字元型時可包含機關名:in(英寸)、cm(厘米)、mm(毫米)、pt(磅)、px(1/96英寸),如“10mm”表示10毫米,不設定時(用PRINT_INIT初始化)預設為800px

Height:

可視編輯區域的高度,整數或字元型,整數時預設長度機關為px。字元型時可包含機關名:in(英寸)、cm(厘米)、mm(毫米)、pt(磅)、px(1/96英寸),如“10mm”表示10毫米,不設定時(用PRINT_INIT初始化)預設為600px

strPrintName:

列印任務名,同PRINT_INIT的strTaskName。

結果:傳回邏輯值

傳回邏輯真表示初始化成功,邏輯假表示初始化失敗,失敗原因有:前一個列印事務沒有完成;作業系統沒有列印機(驅動)等

建議或要求

該函數與PRINT_INIT都有初始化功能,建議和要求同PRINT_INIT。

如果列印頁有上邊距或左邊距要求,或可視編輯區域大小用實際紙張大小不合适時,調用本函數。

ADD_PRINT_HTML

名稱:增加超文本列印項(圖形模式)

格式:ADD_PRINT_HTML(Top,Left,Width,Height, strHtmlContent)

功能:增加超文本列印項,設定該列印項在紙張内的位置和區域大小,實作超文本控制列印。

參數:同ADD_PRINT_HTM

結果:無

建議或要求:

圖形模式列印速度快,但不适合要求文本列印品質高的情況,特别是要面對針式列印機。

但如果列印的内容在一個紙張頁内完成,也就是沒有被Lodop自動分頁時,本函數采用矢量快照模式,列印品質會和文本模式一樣高,速度會更快,是最佳推薦模式。

推薦頁面程式主動控制分頁,而不是讓LODOP被迫自動分頁。

ADD_PRINT_TBURL

名稱:(擴充型)增加表格列印項(URL模式)

格式:ADD_PRINT_TBURL(Top,Left,Width,Height,strURL)

功能:按URL位址增加一個超文本表格列印項,隻輸出第一個table元素顯示内容。

功能同ADD_PRINT_TABLE

參數:同ADD_PRINT_URL

結果:無

建議或要求:

要求在列印初始化後調用,建議在畫線類函數之後調用。

ADD_PRINT_TEXTA

名稱:(擴充型)增加純文字列印項

格式:ADD_PRINT_TEXTA(strItemName,Top,Left,Width,Height,strContent)

功能:同函數ADD_PRINT_TEXT。

參數:

strItemName:

所增純文字列印項的項目名,字元型,未限制長度。

其它參數同函數ADD_PRINT_TEXT。

結果:同函數ADD_PRINT_TEXT。

建議或要求:

建議和要求同函數ADD_PRINT_TEXT。當列印項序号比較難以控制時,用本函數。

SET_PRINT_STYLEA

名稱:(擴充型)設定列印項風格A

格式:

SET_PRINT_STYLEA(varItemNameID, strStyleName,varStyleValue)

功能:類似函數SET_PRINT_ STYLE的功能,二者的差別是本函數隻對某列印項有效。

參數:

varItemNameID:要設定的目标項序号或項目名,數字型或字元型。

l 數字型時,表示是序号,以其增加的先後自然順序為準,從1開始,所有列印對象都參與排序,包括超文本、純文字、圖檔、圖線、圖表、條碼等。

如果序号為0,代表目前(最後加入的那個)資料項;如果序号是負數,代表前面加入的資料項,該值為前移個數偏移量。

l 字元型時,是對象的類名或代表部分對象的關鍵字。

關鍵字有如下幾種:

Selected-代表在設計界面上用滑鼠所選的所有對象;

unSelected-代表在設計界面上所有沒有被滑鼠選擇的對象;

All-代表所有正常對象;

First-代表第一個正常對象;

Last-代表最後一個正常對象;

不是關鍵字的字元一般是類名,類名可以在ADD_PRINT_TEXTA

加入純文字時用strItemName來聲明,也可以在設計界面用菜單功能(Set TEXT Item Name)來設定。

strStyleName:列印風格名,風格名稱及其含義如下:

“PageIndex”:指定輸出頁的序号控制字。

“PreviewOnly”:指定内容僅僅用來預覽。

“ChartStyle”:圖表風格,字元形的控制串。

“ChartLeftTitle”:圖表的左标題,單行文本字元。

“ChartBottomTitle”:圖表的底标題

“ChartTopTitle”:圖表的上标題

“ChartRightTitle”:圖表的右标題

“ChartTitle”:圖表的主标題

“ChartFoot”:圖表的注腳

“ChartbkStartColor”:圖表的背景漸變的起始顔色

“ChartBKEndColor”:圖表的背景漸變的截止顔色

“ChartMarkColor”:圖表的标注顔色

“LeftWallColor”:圖表的左牆顔色

“BottomWallColor”:圖表的底牆顔色

“BackWallColor”:圖表的背牆顔色

“NumberStartPage”:頁号排序的起始頁

“LineSpacing”:純文字的行間距

“LetterSpacing”:純文字的字間距

“ItemName”:項目類名

“StartNumberValue”:列印頁号的初始值

“Content”:列印項的内容

“Deleted”:删除列印項或恢複被删除項;

“TransColor”:透明圖檔的底色

“PageUnIndex”:禁止輸出頁的序号控制字

“SpacePatch”:文本末尾補空格

“AlignJustify”:文本兩端對齊

“TextFrame”:文本的外框類型

“Offset2Top”:次頁開始的上邊距偏移量

“Offset2Left”:次頁開始的左邊距偏移量

“LinkedItem”:設定關聯内容項的項目編号

“TableHeightScope”:設定TABLE高度是否包含頁頭頁尾

其它見SET_PRINT_STYLE

varStyleValue:列印風格值,相關值如下:

PageIndex的值:字元型,用該序号字指定本資料項輸出到哪些頁。“First”第一頁;“Last”最後頁;“Odd”奇數頁;“Even”偶數頁;“具體數字”對應具體頁;空表示預設頁。預設值是空。

PreviewOnly的值:字元或數字型,1或“true”代表僅預覽,否則為正常列印内容。

ChartStyle的值:字元(串)型,該字元串的長度是19位,譬如:“00001-8008--2353312”每個位置的含義如下:

第1位控制“左邊坐标樣式”,樣式值為0到5之間的一個數字或字元“-”,其中0代表“Hidden”、1代表“Auto”、2代表“None”、3代表“Value”、4代表“Mark”、5代表“Text”,字元“-”代表不設定,用預設樣式;

第2位控制“底邊坐标樣式”,第3位控制“上邊坐标樣式”,第4位控制“右邊坐标樣式”,這三位的樣式值及其含義與第1位相同。

第5位控制“圖例樣式”,樣式值為0到6之間的一個數字或字元“-”,其中0代表“Hidden”、1代表“LeftValue”、2代表“LeftPercent”、3代表“XValue”、4代表“Plain”、5代表“RightValue”、6代表“RightPercent”,字元“-”代表不設定,用預設樣式。

第6位控制“圖例位置”,其值為0到3之間的一個數字或字元“-”,其中0代表“Left”、1代表“Right”、2代表“Top”、3代表“Bottom”,字元“-”代表不設定,用預設位置。

第7位控制“标注樣式”,樣式值為0到9之間的一個數字或字元“-”,其中0代表“Hidden”、1代表“Value”、2代表“Percent”、3代表“Label”、4代表“Label and Percent”、5代表“Label and Value”、6代表“Legend”、7代表“Percent Total”、8代表“Label and Percent Total”、9代表“XValue”,字元“-”代表不設定,用預設樣式。

第8位控制“标注是否透明”,其值為0到1之間的一個數字或字元“-”,其中0代表“不透明”、1代表“透明”,字元“-”代表不設定,預設不透明。

第9-10這兩位控制“三維深度(3D效果)”,其值為1到99之間的一個數值或兩個字元“-”,1-99代表3D效果的百分比例,字元“-”代表不設定,用預設的3D效果。

第11-12這兩位控制“左牆厚度”,其值為0到99之間的一個數值或兩個字元“-”,0代表隐藏左牆,1-99代表左牆的厚度,字元“-”代表不設定,用預設的厚度。

第13位控制“背景色漸變走向樣式”,樣式值為0到7之間的一個數字或字元“-”,其中0代表“Hidden”、1代表“Top->Bottom”、2代表“Bottom->Top”、3代表“Left->Right”、4代表“Right->Left”、5代表“From Center”、6代表“From TopLeft”、7代表“From BottomLeft”,字元“-”代表不設定,用預設樣式。

第14-16這三位控制“左右方向的旋轉角度”,其值為270到361之間的一個數值或三個字元“-”,270-360代表旋轉的角度,361代表恢複預設角度,字元“-”代表不設定,用預設的角度。

第17-19這三位控制“前後方向的翻轉角度”,其值為270到360之間的一個數值或三個字元“-”,270-360代表旋轉的角度,字元“-”代表不設定,用預設的角度。

ChartLeftTitle、ChartBottomTitle、ChartTopTitle、ChartRightTitle、ChartTitle、ChartFoot:這六個的值:都是單行文本字元,未限制長度。

ChartbkStartColor、ChartBKEndColor、ChartMarkColor、LeftWallColor、BottomWallColor、BackWallColor這六個的值:整數或字元型,整數時是顔色的十進制RGB值;字元時是超文本顔色值,可以是“#”加三色16進制值組合,也可以是英文顔色名。

NumberStartPage的值:整數型,代表頁号排序時的起始頁,預設是1,即從第一頁開始計算頁号,設定大于1時一般用于目錄或扉頁不排序。

LineSpacing、LetterSpacing的值:字元或整數型,整數時預設長度機關為px。字元型時可包含機關名:in(英寸)、cm(厘米)、mm(毫米)、pt(磅)、px(1/96英寸)。

ItemName的值:字元型,未限制長度,禁止包含關鍵字“ITEM”。

StartNumberValue的值,整數型,列印頁号時起始值,預設是1,即頁号從1開始累加,該值可以是0或負數。

“Content”的值:字元型,列印項的内容,未限制長度,在内容列印維護或列印設計時可動态設定列印項内容。

“Deleted”的值:字元或邏輯型,真表示删除該列印項, True或“True”或1或“1”==真,False或“False”或0或“0”=假,假表示恢複删除項。

“TransColor”的值:透明圖檔的底色,整數或字元型,整數時是顔色的十進制RGB值;字元時是超文本顔色值,可以是“#”加三色16進制值組合,也可以是英文顔色名。

PageUnIndex的值:字元型,用該序号字禁止本資料項輸出到哪些頁。“First”第一頁;“Last”最後頁;“Odd”奇數頁;“Even”偶數頁;“具體數字”對應具體頁;空表示不禁止。預設值是空。

“SpacePatch”的值:數字型,1代表文本末尾補空格,0代表不補。

“AlignJustify”的值:數字型,1代表文本兩端對齊,0代表不處理。

“TextFrame”的值:數字型,文本的外框類型如下:

0(None)--無 1(Uper)--上劃線 2(Under)--下劃線

3(Left)--左劃線 4(Right)--右劃線 5(Rect)-矩形圈框

6(Ellipse)-圓圈框 7(Luper)-整行上劃線 8(Lunder)-整行下劃線

9(Lleft)-整行左劃線 10(Lright)--整行右劃線11(Lrect)-整行矩形圈框 12(Lellipse)-整行圓圈框 13(Grid)-田字格 14(Divi)-分割線

“Offset2Top”的值:整數或字元型,可聲明機關或百分比,表示從次頁開始的上邊距偏移量。例如當對象的首頁内容不能從頂端開始列印時,本設定顯然很有用。

“Offset2Left” 的值:整數或字元型,可聲明機關或百分比,表示從次頁開始的左邊距偏移量。

“LinkedItem”的值:整數或字元型,整數代表被關聯項的序号,字元型代表被關聯項的項目名,内容項與别人關聯後,會緊跟被關聯者之後列印,位置和區域大小随被關聯項而定,此時其Top和left不再是上邊距和左邊距,而是與關聯項的間隔空隙及左邊距偏移。當兩者都是多頁内容項時,二者的每頁區域一樣大。

如果關聯者是頁眉頁腳對象,那麼不會每頁輸出,僅與被關聯對象同頁輸出。此時輸出的位置與被關聯對象的位置相對固定,也就是當上邊距小于被關聯對象的上邊距時,那麼其起點位置會與被關聯者的上邊線保持設計時的距離,否則與被關聯對象的下邊線保持設計時的距離。

“TableHeightScope” 的值:數字型, 0-代表不包含(預設),1-代表包含頭和尾 2-隻包含頁頭 3-隻包含頁尾。這個值僅對TABLE對象有效。

其它見SET_PRINT_STYLE

結果:同函數SET_PRINT_ STYLE。

建議或要求:

列印初始化後、增加列印項之後調用本函數。

SAVE_TO_FILE

名稱:導出資料到檔案

格式:SAVE_TO_FILE(strFileName)

功能:如果超文本對象中有表格(table元素)資料,可用該函數導成Excel等檔案

參數:strFileName要儲存的檔案名及其路徑。其擴充名指明要儲存的檔案類型,目前支援的擴充名:“.xls”---Excel檔案(電子表格檔案)

結果:傳回邏輯結果,儲存成功時傳回真,儲存失敗或放棄儲存時傳回假。

建議或要求:

Add資料後運作。

SET_SAVE_MODE

名稱:設定儲存模式

格式:SET_SAVE_MODE(varModeName,varModeValue)

功能:設定導出資料到Excel等檔案時的儲存模式。

參數:

varModeName模式名,字元型,如下是模式名及其含義:

“FILE_PROMPT”:儲存前是否進行檔案名及其路徑提示。

“TABLE_INDEX”:源table資料對象的序号。

“PAGE_TYPE”:儲存表格時的分頁方式。

“LINESTYLE”:Excel檔案中的表格是否有邊框

“CAPTION”:Excel檔案中的标題欄内容

“CENTERHEADER”:Excel檔案中的表格頁眉(中)内容

“LEFTHEADER”:Excel檔案中的表格頁眉(左)内容

“RIGHTHEADER”:Excel檔案中的表格頁眉(右)内容

“CENTERFOOTER”:Excel檔案中的表格頁腳(中)内容

“LEFTFOOTER”:Excel檔案中的表格頁腳(左)内容

“RIGHTFOOTER”:Excel檔案中的表格頁腳(右)内容

“QUICK_SAVE”:儲存表格時是否采用快速模式

“RETURN_FILE_NAME”:儲存後傳回檔案名稱

varModeValue模式值,整數或字元型,相關值如下:

FILE_PROMPT的值:整數或字元型,1或“1”或“True”=是,“0”或其它=否。

該值為“是”時,控件會在儲存前彈出視窗選擇檔案名及其路徑。該值為“否”時控件按程式指定的檔案名直接儲存,不再彈出檔案路徑框,但會彈出安全提示框(做初次确認)。預設值是“是”。

TABLE_INDEX的值:數字型,如果控件接受了多個超文本對象,在導出資料時可以用TABLE_INDEX指定某個對象被導出,否則就導出最後對象。該序号從1開始排序。

PAGE_TYPE的值:數字型,

0--表示不分頁;

1--儲存到同一個Sheet中,但會加入分頁符(PageBreak);

2--分頁到不同Sheet中

LINESTYLE的值: 數字型,1--表示有邊框,0--表示無邊框。

CAPTION的值: 字元型,标題欄的文本内容。

CENTERHEADER的值:字元型,表格(居中)頁眉的文本内容或控制字(見Excel相關資料)。

LEFTHEADER的值:字元型,表格(靠左)頁眉的文本内容或控制字(見Excel相關資料)。

RIGHTHEADER的值:字元型,表格(靠右)頁眉的文本内容或控制字(見Excel相關資料)。

CENTERFOOTER的值:字元型,表格(居中)頁腳的文本内容或控制字(見Excel相關資料)。

LEFTFOOTER的值:字元型,表格(靠左)頁腳的文本内容或控制字(見Excel相關資料)。

RIGHTFOOTER的值:字元型,表格(靠右)頁腳的文本内容或控制字(見Excel相關資料)。

QUICK_SAVE的值:整數或字元型,1或“1”或“True”=是,“0”或其它=否。

如果采用快速模式,在生成表格單元時将忽略樣式和本函數的其它設定,生成速度較快,适宜資料較多且不在乎表格樣式時。

RETURN_FILE_NAME的值:字元型。一般情況儲存後傳回成功與否的邏輯值,但該參數使SAVE_TO_FILE傳回所儲存檔案的全路徑名稱。

結果:傳回邏輯結果,成功時傳回真,失敗時傳回假。

建議或要求:

導出資料(SAVE_TO_FILE)前調用本函數。

ADD_PRINT_SHAPE

名稱:(擴充型)增加圖形

格式:

ADD_PRINT_SHAPE(intShapeType, Top, Left,Width,Height,intLineStyle,

intLineWidth, varColor)

功能:增加矩形框、橢圓、直線等圖形列印項,設定該圖形在紙張内的位置和大小,設定線條的類型和線條寬度。

參數:

intShapeType:

該圖形的類型,數字型參數。0--仰角直線 1--俯角直線 2--矩形框線 3--橢圓線 4--實心矩形 5--實心橢圓

Top:

該圖形在紙張内的上邊距,整數或字元型,整數時預設長度機關為px。字元型時可包含機關名:in(英寸)、cm(厘米)、mm(毫米)、pt(磅)、px(1/96英寸)、%(百分比),如“10mm”表示10毫米。

當上邊距超過紙張高度時,列印項被輸出在下一頁(或更下頁)。

Left:

該圖形在紙張内的左邊距,整數或字元型,整數時預設長度機關為px。字元型時可包含機關名:in(英寸)、cm(厘米)、mm(毫米)、pt(磅)、px(1/96英寸)、%(百分比),如“10mm”表示10毫米。

Width:

該圖形(直線的外緣矩形或橢圓的外緣矩形)的寬度,整數或字元型,整數時預設長度機關為px。字元型時可包含機關名:in(英寸)、cm(厘米)、mm(毫米)、pt(磅)、px(1/96英寸)、%(百分比),如“10mm”表示10毫米。

Height:

該圖形(直線的外緣矩形或橢圓的外緣矩形)的高度,整數或字元型,整數時預設長度機關為px。字元型時可包含機關名:in(英寸)、cm(厘米)、mm(毫米)、pt(磅)、px(1/96英寸)、%(百分比),如“10mm”表示10毫米。

intLineStyle:

線條類型,數字型,0--實線 1--破折線 2--點線 3--點劃線 4--雙點劃線

預設線條是實線。

intLineWidth:

線條寬,整數型,機關是(列印)像素,預設值是1,非實線的線條寬也是0。

varColor:

圖形的顔色,整數或字元型,整數時是顔色的十進制RGB值;字元時是超文本顔色值,可以是“#”加三色16進制值組合,也可以是英文顔色名;

結果:無

建議或要求:

要求在列印初始化後調用,建議在文本類函數之前調用。

SET_PRINTER_INDEXA

名稱:(擴充型)指定列印裝置

格式:SET_PRINTER_INDEXA (oIndexOrName)

功能:按名稱或序号指定要進行列印輸出的裝置,指定後允許重新選擇。

參數:

oIndexOrName:

列印機名稱或序号,字元或數字型。數字表示列印機的序号,從0開始,最大序号是GET_PRINTER_COUNT()減1。-1特指作業系統内設定的預設列印機。

字元代表列印機的名稱,與作業系統内的列印機名稱一緻。

注:用本函數指定列印機後,在預覽界面允許重新選擇列印機,而用另外一個函數SET_PRINTER_INDEX指定後則不允許重新選擇。

結果:傳回邏輯值

傳回邏輯真表示指定成功,邏輯假表示指定失敗,失敗原因有:該列印裝置不存在。

建議或要求:

要求在初始化之後、列印或預覽之前調用。

NEWPAGEA

名稱:(擴充型)強制分頁

格式:NEWPAGEA()

功能:強制分頁。執行該函數之後所增加的内容會在前面内容的尾頁之後建立一頁輸出,前面無内容時,仍然從第一頁開始。

參數:無

結果:傳回邏輯值

傳回邏輯真表示強制分頁成功,邏輯假表示強制分頁失敗。

建議或要求:

列印初始化後調用本函數。

PREVIEWA

名稱:(擴充型)列印預覽A

格式:PREVIEWA ()

功能:同函數PREVIEW。預覽前提示選擇列印機。

參數:同函數PREVIEW。

結果:同函數PREVIEW。

建議或要求:

同函數PREVIEW。

PREVIEWB

名稱:(擴充型)列印預覽B

格式:PREVIEWB ()

功能:同函數PREVIEW。強制用預設布局風格來列印預覽。

參數:同函數PREVIEW。

結果:同函數PREVIEW。

建議或要求:

同函數PREVIEW。不希望最終使用者改變列印布局和風格時調用本函數。

PRINTA

名稱:(擴充型)直接列印A

格式:PRINTA ()

功能:同函數PRINT。列印前提示選擇列印機。

參數:同函數PRINT。

結果:同函數PRINT。傳回邏輯結果,當真實列印時傳回真,放棄列印或列印出錯時傳回假。

建議或要求:

同函數PRINTA。

PRINTB

名稱:(擴充型)直接列印B

格式:PRINTB ()

功能:同函數PRINT。強制用預設布局風格來列印。

參數:同函數PRINT。

結果:同函數PRINT。

建議或要求:

同函數PRINT。不希望最終使用者改變列印布局和風格時調用本函數。

SHOW_CHART

名稱:顯示圖表

格式:SHOW_CHART ()

功能:在頁面内顯示一個圖表。其圖表的資料來源由函數ADD_PRINT_CHART來完成,圖表的樣式設定與列印預覽一樣,也是采用SET_PRINT_ STYLEA來實作。

參數:無。

結果:無。

建議或要求:

在建立好完整的列印頁後調用,該指令類似列印事件,二者的差别是前者把内容在界面上顯示,後者把内容在列印機中輸出。

DO_ACTION

名稱:控制界面動作

格式:DO_ACTION (ActName, ActValue)

功能:在控件界面内嵌到浏覽器時,JS通過該函數直接驅使控件内部的動作事件。

參數:

ActName動作名稱,具體名稱及其含義如下:

PREVIEW_ZOOM_HIGHT:适高顯示動作,觸發預覽界面适高顯示按鈕點選一次。

PREVIEW_ZOOM_NORMAL:正常顯示動作,觸發預覽界面正常顯示按鈕點選一次。

PREVIEW_ZOOM_WIDTH:适寬顯示動作,觸發預覽界面适寬顯示按鈕點選一次。

PREVIEW_ZOOM_IN:拉近顯示動作,觸發預覽界面拉近(放大+)顯示按鈕點選一次。

PREVIEW_ZOOM_OUT:推遠顯示動作,觸發預覽界面推遠(縮小-)顯示按鈕點選一次。

PREVIEW_PERCENT:選擇縮放列印比例動作,改變預覽界面縮放比例選項。

PREVIEW_GOFIRST:首頁動作,觸發預覽界面首頁(第一頁)按鈕點選一次。

PREVIEW_GOPRIOR:上頁動作,觸發預覽界面上頁按鈕點選一次。

PREVIEW_GONEXT:下頁動作,觸發預覽界面下頁按鈕點選一次。

PREVIEW_GOLAST:尾頁動作,觸發預覽界面尾頁(最後頁)按鈕點選一次。

PREVIEW_GOTO:頁跳轉動作,預覽界面直接轉到ActValue指定的頁号顯示。

PREVIEW_GOSKIP:頁跳過動作,預覽界面跳過ActValue指定的頁數後顯示。

PREVIEW_SETUP:列印設定動作,觸發預覽界面列印設定按鈕點選一次。

PREVIEW_PRINT:列印動作,觸發預覽界面列印按鈕點選一次。

PREVIEW_CLOSE:關閉動作,觸發預覽界面關閉按鈕點選一次。

PREVIEW_ROTATE:旋轉顯示動作,觸發預覽界面旋轉按鈕點選一次。

ActValue動作輔助值

隻有如下動作的輔助值有意義;

PREVIEW_PERCENT的值:數字,代碼值及其含義為:

0--30% 1--50% 2--60% 3--70% 4--80% 5--85% 6--90% 7--95% 8--100% 9--125%

10--150% 11--200% 12--按整寬 13--按整高 14--按整頁 15--整寬不變形

16--整高不變形 17--自定比例

PREVIEW_GOTO的值:整數,某頁的頁序号值,從1開始。

PREVIEW_GOSKIP的值:整數,跳轉的頁數,正數向後跳,負數向前跳。

結果:無。

建議或要求:

在内嵌界面正常打開後調用。

SET_LICENSES

名稱:設定軟體産品注冊資訊

格式:

SET_LICENSES (strCompanyName, strLicense, strLicenseA,strLicenseB)

功能:以函數方式設定軟體使用權注冊資訊,功能與對應的控件參數一樣。

參數:

strCompanyName:注冊機關名稱,用途與控件參數CompanyName一樣。

strLicense:主注冊号,用途與控件參數License一樣。

strLicenseA:附加注冊号A,用途與控件參數LicenseA一樣。

strLicenseB:附加注冊号B,用途與控件參數LicenseB一樣。

結果:無

建議或要求:

任何時間調用,本函數适合以隐蔽方式設定注冊資訊。

五、軟體使用權注冊

列印控件Lodop是一款專業共享軟體,公開發行版本沒有功能限制,多數使用者可免費長期使用,僅如下功能需要注冊使用權:

1、 (不經過預覽的)“直接列印”功能;

2、“導出資料到Excel檔案”功能;

不經注冊使用以上功能時,列印輸出結果的左下角會出現“本頁由【試用版列印控件LodopX.0】輸出”小字樣水印。

軟體使用權的注冊設定,除了用SET_LICENSES函數外,一般用如下幾個控件參數(調用方法參閱第三節):

CompanyName

名稱:設定注冊機關名稱

格式: < param name="CompanyName" value="注冊機關名稱XXX" >

功能:該名稱配合License實作按使用者機關名稱注冊。這種注冊不限制域名,注冊者可把Lodop用于多個WEB工程,适合軟體開發公司注冊。頁面使用機關名稱注冊号後,列印結果的水印消失,并在列印預覽的狀态欄有該機關名稱的明示。

License

名稱:設定注冊号

格式: < param name="License" value="注冊号XXX" >

功能:該注冊号有兩項功能:

一、當CompanyName不空時,該注冊号配合其實作按使用者機關名稱注冊。這種注冊不限制域名,注冊者可把Lodop用于多個WEB工程,适合軟體開發公司注冊。

二、當CompanyName空時,這是域名注冊号之一,一般是域名的名稱注冊号。這種注冊隻限該域名使用,價格便宜,适合最終使用機關注冊。

LicenseA

名稱:設定附加注冊号A

格式: < param name="LicenseA" value="附加注冊号A" >

功能:當CompanyName空時,這是域名注冊号之二,一般是内網IP注冊号,随主注冊号免費贈送。

控件從6.0.0.5開始支援雙注冊号,所謂雙注冊号是指一個頁面既有中文注冊名又有英文注冊名,英文注冊名僅适用于英文版的控件。LicenseA可用來設定英文注冊的公司名稱。

LicenseB

名稱:設定附加注冊号B

格式: < param name="LicenseB" value="附加注冊号B" >

功能:當CompanyName空時,這是域名注冊号之三,一般是外網IP注冊号,随主注冊号免費贈送。

LicenseB可用來設定雙注冊号中的英文注冊名的注冊号。

六、列印維護和列印設計

列印設計的目标使用者是軟體開發者,詳細功能解釋略。

列印維護的目标使用者是頁面操作者,詳細功能解釋略。

七、計量機關

本文所述px機關固定換算關系如下,與像素類似但不是一個概念,也不受顯示影響:

1in(英寸)=2.54cm(厘米)=25.4mm(毫米)=72pt(磅)=96px

另外一個特殊的計量機關“%(百分比)”,是指相對于紙張大小的百分比值,其中“上、下邊距、高度”等的百分比是相當對于紙張高度(橫向列印時則是寬度)的比值,而“左、右邊距和寬度”的百分比是相對于紙張寬度(橫向列印時則是高度)的比值。

例子1:

LODOP.PRINT_INIT("列印任務名");

LODOP.SET_PRINT_COPIES(2);

bdhtml=window.document.body.innerHTML;

var hei = $(\'#div1\').outerHeight();

string = prnhtml;

LODOP.SET_PRINT_PAGESIZE (3,\'6cm\',\'2cm\',2);

LODOP.ADD_PRINT_HTM(0,0,227,hei,string);

LODOP.SET_PRINTER_INDEXA(-1)

LODOP.PRINT();

例子2:

LODOP.PRINT_INIT("訂單列印");

LODOP.SET_PRINT_PAGESIZE(1,0,0,"A4");//1---縱(正)向列印,固定紙張;

LODOP.SET_PRINT_STYLEA(0,"FontName","黑體");//0表示目前的對象

//-1表示往前的一個對象,以此類推

LODOP.SET_PRINT_STYLEA(0,"FontSize",14);

LODOP.SET_PRINT_STYLEA(0,"Alignment",2);//Alignment的值:數字型,1--左靠齊 2--居中 3--右靠齊,預設值是1。

LODOP.ADD_PRINT_TEXT(35,40,200,25,"XXX公司");

LODOP.SET_PRINT_STYLEA(0,"FontName","黑體");

LODOP.SET_PRINT_STYLEA(0,"FontSize",11);

LODOP.SET_PRINT_STYLEA(0,"bold",1);

LODOP.ADD_PRINT_TEXT(35,260,140,25,""+str);

LODOP.SET_PRINT_STYLEA(0,"FontName","黑體");

LODOP.SET_PRINT_STYLEA(0,"FontSize",11);

LODOP.SET_PRINT_STYLEA(0,"bold",1);

LODOP.ADD_PRINT_TEXT(35,630,120,25,"頁數:#/&");//列印頁碼#和頁數&

LODOP.SET_PRINT_STYLEA(0,"FontName","黑體");//0表示目前的對象(目前頁)

LODOP.SET_PRINT_STYLEA(0,"FontSize",11);

LODOP.SET_PRINT_STYLEA(0,"bold",1);

LODOP.ADD_PRINT_HTM(70,41,340,30,"我在最後一頁後尾添加内容");

LODOP.SET_PRINT_STYLEA(0,"FontName","黑體");

LODOP.SET_PRINT_STYLEA(0,"FontSize",11);

LODOP.SET_PRINT_STYLEA(0,"bold",1);

LODOP.SET_PRINT_STYLEA(0,"PageIndex","Last");//Last表示最後一頁

LODOP.SET_PRINT_STYLEA(0,"PageIndex","2,Last-1");

//"2,Last-1"表示第二頁至倒數第一頁

例子2:

 var LODOP; //聲明為全局變量

 //以下為列印方法

function CreatePricePage(list,info,type) {

    var itemlist=list[0];

     LODOP = getLodop();

     LODOP.PRINT_INIT("訂單列印");

     LODOP.SET_PRINT_PAGESIZE(1,0,0,"A4");//設定紙張

     LODOP.ADD_PRINT_TEXT(35,630,120,25,"頁數:#/&");

     LODOP.SET_PRINT_STYLEA(0,"FontName","黑體");

     LODOP.SET_PRINT_STYLEA(0,"FontSize",11);

     LODOP.SET_PRINT_STYLEA(0,"bold",1);

     LODOP.SET_PRINT_STYLEA(0, "ItemType", 2);

     LODOP.SET_PRINT_STYLEA(0, "ItemType", 3);

     LODOP.SET_PRINT_STYLEA(0, "HOrient", 0);

//在html裡連續列印多個表格,外表格嵌套多個表格

var htmlTotal =\'<table border="0" cellspacing="0" cellpadding="0" style="border-collapse: collapse;width: 100%" align="center;">\'+\'<tr><td>\';

      htmlTotal += \'<style> table,td{border-collapse:collapse;border-spacing:0;padding:0;}</style><table border="0" style="width: 95%">\'

          + \'<tr>\'

          + \'<td  align="center" valign="top" height="40" >\' +\'<span style="font-family: 黑體;font-size:35px;"><b>XXX單</b></span>\'+ \'</td>\'

   + \'</tr>\'

          + \'</table>\';

      htmlTotal +=\'</td></tr><tr><td>\';

      //第二個表格

      htmlTotal += \'<style> table,td,th {border-collapse:collapse;border-spacing:0;padding:0;}</style><table border="1" border-color="black"  style="width: 95%">\'

          +\'<tr>\'+

          \'<th bgcolor="#A2A2A2" align="center" >序号</th>\'+

          \'<th bgcolor="#A2A2A2" align="center" >名稱</th>\'+

          \'<th bgcolor="#A2A2A2" align="center" >數量</th>\'+

          \'</tr>\';

   var cntorderCount = 0;// 總包裹數

    for (var i = 0; i < list.length; i++) {

       htmlTotal+=getPrintTableData(list[i]);//組裝資料行

       cntorderCount += list[i]. cntorder;

    }

       htmlTotal+=\'<tr>\'+

      \'<td style="text-align:center;width:70px;">\'+"合計+

\'</td>\'+

      \'<td style="text-align:center;width:100px;">\'+\'</td>\'+

      \'<td style="text-align:center;width:170px;">\'+\'</td>\'+

      \'</table>\';

      htmlTotal +=\'</td></tr></table>\';

      LODOP.ADD_PRINT_HTM(35,20,\'100%\',460,htmlTotal);

    if(type==1){

       LODOP.PRINT_DESIGN();//列印設計    

    }

    else{

       //var printname=LODOP.GET_PRINTER_NAME(1);設定直接列印用到的列印機

       //LODOP.SET_PRINTER_INDEX(printname);設定直接列印用到的列印機

       LODOP.PRINT();//直接列印

    }

   }

/**

  * [getPrintTableData 組裝清單]

  */

 function getPrintTableData(data){

    var html="";

          html+=

             \'<tr>\'+

             \'<td style="text-align:center;width:70px;">\'+data.index+\'</td>\'+

             \'<td style="text-align:center;width:100px;">\'+data.name+\'</td>\'+

             \'<td style="text-align:center;width:170px;">\'+data.count+\'</td>\'+

            \'</tr>\';

       return html;

 }