Lodop屬性和方法詳解
例子:
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();
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:
所選紙張型別名,字元型。不同印表機所支援的紙張可能不一樣,這裡的名稱同作業系統內印表機屬性中的紙張名稱,支援作業系統內的自定義紙張。
關鍵字“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 --光碟的個數
CDROMDrive.1.Label ---第一個光碟的碟符
CDROMDrive.1.SerialNumber ----第一個光碟的序列號
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
另外一個特殊的計量單位“%(百分比)”,是指相對於紙張大小的百分比值,其中“上、下邊距、高度”等的百分比是相當對於紙張高度(橫向列印時則是寬度)的比值,而“左、右邊距和寬度”的百分比是相對於紙張寬度(橫向列印時則是高度)的比值。
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();
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:
所選紙張型別名,字元型。不同印表機所支援的紙張可能不一樣,這裡的名稱同作業系統內印表機屬性中的紙張名稱,支援作業系統內的自定義紙張。
關鍵字“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_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 --光碟的個數
CDROMDrive.1.Label ---第一個光碟的碟符
CDROMDrive.1.SerialNumber ----第一個光碟的序列號
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
另外一個特殊的計量單位“%(百分比)”,是指相對於紙張大小的百分比值,其中“上、下邊距、高度”等的百分比是相當對於紙張高度(橫向列印時則是寬度)的比值,而“左、右邊距和寬度”的百分比是相對於紙張寬度(橫向列印時則是高度)的比值。