1. 程式人生 > >Lodop屬性和方法詳解

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 ((LODOPnull)||(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----列印狀態