Lodop6.2技术手册

更新时间:2024-05-03 12:51:01 阅读量: 综合文库 文档下载

说明:文章内容仅供预览,部分内容可能不全。下载后的文档,内容与下面显示的完全一致。下载之前请确认下面内容是否您想要的,是否完整无缺。

Lodop技术手册

WEB打印控件Lodop技术手册

Ver 6.2.0.3

Email: gungho999@sina.com

QQ: 932131686 梦泰尔软件(中国) MTSoftware(CN)

1

Lodop技术手册

目 录

一、概述 ........................................................................................................................................................... 4 二、系统文件 ................................................................................................................................................... 4

install_lodop32.exe 和 install_lodop64.exe .................................................................................... 4 LodopFuncs.js ................................................................................................................................... 5

三、控件参数 ................................................................................................................................................... 8

Caption .............................................................................................................................................. 8 Color .................................................................................................................................................. 8 Border ................................................................................................................................................ 9

四、功能函数 ................................................................................................................................................... 9

1、基本函数 ............................................................................................................................................. 9

VERSION.......................................................................................................................................... 9 PRINT_INIT ..................................................................................................................................... 9 SET_PRINT_PAGESIZE ................................................................................................................ 10 ADD_PRINT_HTM ........................................................................................................................ 11 ADD_PRINT_TABLE .................................................................................................................... 12 ADD_PRINT_URL ......................................................................................................................... 13 ADD_PRINT_TEXT....................................................................................................................... 14 ADD_PRINT_IMAGE .................................................................................................................... 15 ADD_PRINT_RECT ...................................................................................................................... 16 ADD_PRINT_ELLIPSE ................................................................................................................. 16 ADD_PRINT_LINE ........................................................................................................................ 17 ADD_PRINT_BARCODE .............................................................................................................. 18 ADD_PRINT_CHART ................................................................................................................... 19 SET_PRINT_STYLE ...................................................................................................................... 20 PREVIEW ....................................................................................................................................... 22 PRINT ............................................................................................................................................. 22 PRINT_SETUP ............................................................................................................................... 23 PRINT_DESIGN ............................................................................................................................. 23 NEWPAGE ...................................................................................................................................... 23 GET_PRINTER_COUNT ............................................................................................................... 24 GET_PRINTER_NAME ................................................................................................................. 24 SET_PRINTER_INDEX ................................................................................................................. 25 SELECT_PRINTER ........................................................................................................................ 25 SET_SHOW_MODE ...................................................................................................................... 26 SET_PRINT_MODE ...................................................................................................................... 28 SET_PRINT_COPIES..................................................................................................................... 31 SET_PREVIEW_WINDOW ........................................................................................................... 31 ADD_PRINT_SETUP_BKIMG ..................................................................................................... 32 SEND_PRINT_RAWDATA ............................................................................................................ 32 WRITE_PORT_DATA .................................................................................................................... 33 READ_PORT_DATA ...................................................................................................................... 33 GET_PRINT_INIFFNAME ............................................................................................................ 33

2

Lodop技术手册

GET_PAGESIZES_LIST ................................................................................................................ 34 WRITE_FILE_TEXT ...................................................................................................................... 34 GET_FILE_TEXT .......................................................................................................................... 35 GET_FILE_TIME ........................................................................................................................... 35 IS_FILE_EXIST .............................................................................................................................. 35 GET_SYSTEM_INFO .................................................................................................................... 36 GET_VALUE .................................................................................................................................. 37 FORMAT ......................................................................................................................................... 40 GET_DIALOG_VALUE ................................................................................................................. 41 2、扩展函数 ........................................................................................................................................... 42

PRINT_INITA ................................................................................................................................. 42 ADD_PRINT_HTML ..................................................................................................................... 43 ADD_PRINT_TBURL .................................................................................................................... 43 ADD_PRINT_TEXTA .................................................................................................................... 44 SET_PRINT_STYLEA ................................................................................................................... 44 SAVE_TO_FILE ............................................................................................................................. 49 SET_SAVE_MODE ........................................................................................................................ 50 ADD_PRINT_SHAPE .................................................................................................................... 51 SET_PRINTER_INDEXA .............................................................................................................. 52 NEWPAGEA ................................................................................................................................... 53 PREVIEWA ..................................................................................................................................... 53 PREVIEWB .................................................................................................................................... 53 PRINTA ........................................................................................................................................... 53 PRINTB ........................................................................................................................................... 54 SHOW_CHART .............................................................................................................................. 54 DO_ACTION .................................................................................................................................. 54 SET_LICENSES ............................................................................................................................. 55

五、软件使用权注册 ..................................................................................................................................... 56 六、打印维护和打印设计 ............................................................................................................................. 57 七、使用样例 ................................................................................................................................................. 58 八、计量单位 ................................................................................................................................................. 59

3

Lodop技术手册

一、概述

Lodop是一款专业的WEB打印控件,其设计目标是简单易用、功能强大且短小精悍,开创WEB打印开发的新局面。

设计者对WEB下的打印需求进行了分类汇总,高度抽象,构思出仅用几个功能函数,就可实现复杂的打印任务,尽量避免由此引起的知识累赘。控件发布包有3个系统文件组成,主要功能用3个控件参数和2组功能函数来实现。

尽管Lodop有个理想化的目标,那就是不用详细了解这些参数或函数,仅仅看懂几

个样例就能很轻松地开始使用,控件为此提供了一个足够完善的设计界面,用它可以实现大多数打印开发任务,但事实上深入了解这些参数和函数总是有好处的,特别是当您的开发任务很复杂时,这就是本文目的,但愿本文档足够详细且简单明了。

如果此前曾看过lodop发行包里的入门样例,本文会更容易理解。

二、系统文件

Lodop发布包内主要有如下三个安装文件:

1. install_lodop32.exe 2. install_lodop64.exe

3. CLodopPrint_Setup_for_Win32NT.exe

前两个是打印控件安装文件,第三个是云打印服务安装文件。建议页面综合部署,即部分浏览器采用控件,另外浏览器采用云打印,该选择过程由LodopFuncs.js里的needCLodop();引导实现。C-Lodop云打印32位安装文件可以适用于32位或64位操作系统,更详细的安装使用请参考《云打印C-Lodop技术手册》。

下载地址:http://www.c-lodop.com/download.html

install_lodop32.exe 和 install_lodop64.exe

这俩文件是lodop控件安装和升级的主程序文件,其中install_lodop32.exe适用于32位浏览器,install_lodop64.exe适用于64位浏览器,提供给用户或开发者下载安装,如果不特意拦截一般都能100%安装,对“网页插件安装难”有彻底改善。如果将

4

Lodop技术手册

其复制或改名为uninstall_lodop32.exe (或uninstall_lodop64.exe)就可用来卸载控件。

Lodop安装后,在操作系统Program Files\\MountTaiSoftware\\Lodop目录下会生成两个实体文件:CAOSOFT_WEB_PRINT_LODOP.OCX和NPCAOSOFT_WEB_PRINT_LODOP.DLL 前一个是标准OCX文件,它是Lodop的功能核心,后者是一个NPPlugin文件,其作用是实现多浏览器支持。目前Lodop支持IE系列、IE内核系列(遨游、360、世界之窗、腾讯TT、搜狗等)浏览器,以及Firefox(火狐)系列、Chrome(谷歌)系列、Opera系列、Safari系列等Windows下几乎所有的浏览器,通过云打印。

安装程序文件有几个预定参数:

-waitXX该参数设置安装程序运行完毕后自动关闭窗口,这里的XX表示关闭前等待的秒数,如果是0秒则安装(或卸载)成功后立即关闭,例如: –wait8

-nowindow 该参数设置安装程序运行时不出现界面窗口(所谓的静默安装)。 -un 该参数使程序执行卸载操作,优先于文件名。 -in 该参数使程序执行安装操作,优先于文件名。

安装界面如下:

LodopFuncs.js

该文件是用来引导安装控件的一个JS文件,是个样例,但建议直接采用。其中getLodop的任务是判断当前浏览器的类型并决定采用哪个对象实例,并检测控件是否安装、是否最新版本、并引导安装或升级,加入了兼容C-Lodop云打印的检测信息。文件主要内容如下:

5

Lodop技术手册

第4是按所选打印机的默认纸张; 结果:无

建议或要求:

打印初始化之后调用。

如果打印纸张不固定,希望由操作者自主选择纸张时,则不要调用本函数。 举例一:LODOP. SET_PRINT_PAGESIZE (1,2100,2970,\

设置纸张大小为:宽210mm*高297mm,纵向打印

举例二:LODOP. SET_PRINT_PAGESIZE (2, 0, 0,\

设置纸张为A4(按操作系统定义的A4尺寸),横向打印

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=\或style=\,该元素称为“强制分页元素”,控件会在该元素处分页。

●代码中的标签IMG如果有transcolor属性,则可以实现透明打印图片。例如属性格式为:transcolor=\表示用白色作为透明底色,这里的颜色值可以是“#”加三色16进制值组合,也可以是英文颜色名。这个专有属性再配合IMG的position: absolute可以实现“先字后章”的公章打印效果。

●代码中的元素如果包含borderthin属性,如果属性值等于true,则该元素的border在合

11

Lodop技术手册

并单元格时会采用单细线模式。 结果:无

建议或要求:

要求在打印初始化后使用,建议在画线类函数之后调用。注意“强制分页元素”要符合xhtml规范,建议用跨整行的元素,内容不能空,内容可以是“ ”。强制分页符对其它Lodop函数无效,仅适用本函数。

举例一:LODOP. ADD_PRINT_HTM (0,0, 300,100,\

举例二:LODOP. ADD_PRINT_HTM (\ 举例三:LODOP.ADD_PRINT_HTM(\document.documentElement.innerHTML);

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毫米。当内容的高度超出本参数值时,控件会自动分页,后面的内容在下一页对应位置输出,每页至少打印一个TR行(由于table可以嵌套多层子table,这里的TR行是指首层TR)。本参数可以用BottomMargin关键字转义为打印区域相对于纸张的“下边距”。 strHtml:

超文本代码内容,字符型,未限制长度。可以是一个完整的页面超文本代码,或者是一个代码段落,也可以是URL:web地址形式的URL地址。要求实际内容中至少包含一个table元素。

特别说明:本函数能识别的超文本专有元素属性有tdata、format、tclass、tindex等四个,它们主要用来实现分页小计、分类合计等统计功能,这四个属性可以用在table内的任何元素上,包含tdata属性的超文本元素下面称为“统计结果元素”,被统计的超文本元素称为“数据元素”,它们的属性值及其含义如下:

12

Lodop技术手册

① tdata:设置统计类型,其值和含义为:

SubCount---本页行数,即本页该数据列的单元格行数;

SubDistinctCount---本页非重复行数,即本页该数据列的单元格内容不重复的行数; SubSum---本页合计,即本页该数据列的数值合计; SubAverage---本页平均数,即本页合计除以本页行数; Count---累计行数,即从第一页到本页的该列行数的累加值;

DistinctCount---累计非重复行数,即从第一页到本页的该列非重复行数的累加值; Sum---累计数,即从第一页到本页的该列数值的累加值; Average---累计平均数,即累计数除以累计行数; AllCount---总行数,即该列全表的行数;

AllDistinctCount---非重总行数,全表非重复的行数; AllSum---总计数,即该列全表的数值总和;

AllAverage---总平均数,即全表总计数除以总行数;

PageNO---页号,即本table页的序号(与总页号不一样),页号数值默认是阿拉伯数字,

也可用显示格式“ChineseNum”设为中文;

PageCount---总页数,即全(table)表被分成的总页数,数值格式同“页号”;

以上属性值可以组合成表达式, 以复杂四则运算形式统计运算, 表达式内除了\加+减-乘*除/\和\括号( )\外,还支持数学函数Trunc Round Sqrt Int Sqr Abs Sin Cos Tan Arcsin Arccos Arctin Logo10 Log2 Round1-6等, 表格内单元格原始(或统计结果)数据可用其id值参与运算。

②format:设置统计结果的显示格式,其值如下样式: “0”“0.00””“#.##” “#,##0.00”“0.000E+00”“#.###E-0 ” “UpperMoney(大写金额)” “ChineseNum(中文数字) ”等等,其中的“#”表示当数据为0时不显示。 ③tclass:设置分类统计的―类名‖,其值可任意设置,在分类统计时,“统计结果元素”和“数据元素”的tclass值必须一致。不设置类名时则全表统计。

④tindex:一般要求“统计结果元素”的位置与“数据元素”的列位置一致或内含在“数据元素”列内,如果位置无法一致,可以用tindex指定对应的数据列,该值是数字型的列序号,从1起始。

⑤占位符:一个要显示统计结果的“统计结果元素”必须要包含占位符,占位符是任意个―#‖组成的字符串,占位符可以与其它内容混合在一起,当统计结果值较大时,开发者需要注意占位符要占用足够多的位置,除非占位符周围有合理的空白区,以避免统计结果与普通内容重叠。

结果:无

建议或要求:

要求在打印初始化后调用,建议在画线类函数之后调用。

举例一:LODOP.ADD_PRINT_TABLE(10,10,300,100,\border=’1’>11 12 21 22\举例二:

LODOP.ADD_PRINT_TABLE(0,0, \

ADD_PRINT_URL

名称:增加超文本打印项(URL模式)

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

13

Lodop技术手册

功能:按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地址,字符型,未限制长度。 结果:无

建议或要求:

要求在打印初始化后调用,建议在画线类函数之后调用。 举例:

LODOP.ADD_PRINT_URL(0,0, \

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:

14

Lodop技术手册

打印区域的宽度,整数或字符型,整数时缺省长度单位为px。字符型时可包含单位名:in(英寸)、cm(厘米) 、mm(毫米) 、pt(磅)、px(1/96英寸) 、%(百分比),如“10mm”表示10毫米。本参数可以用RightMargin关键字转义为打印区域相对于纸张的“右边距”。 Height:

打印区域的高度,整数或字符型,整数时缺省长度单位为px。字符型时可包含单位名:in(英寸)、cm(厘米) 、mm(毫米) 、pt(磅)、px(1/96英寸) 、%(百分比),如“10mm”表示10毫米。本参数可以用BottomMargin关键字转义为打印区域相对于纸张的“下边距”。 strContent:

纯文本内容,字符型,未限制长度。 结果:无

建议或要求:

要求在打印初始化后调用,建议在画线类函数之后调用。 举例一:LODOP.ADD_PRINT_TEXT(11,23,98,19,\新加文本\

举例二:LODOP. ADD_PRINT_TEXT(\新加文本\

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地址。 结果:无

建议或要求:

15

Lodop技术手册

要求在打印初始化后调用,建议在画线类函数之后调用。

本函数可用ADD_PRINT_HTM代替,但区别是其仅取超文本第一个图片元素,边距是0,而且打印时不因为设计区域小于图片而被分页,适合与纯文本组合打印的插图。 举例:LODOP. ADD_PRINT_IMAGE (10,10,300,160,\

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。 结果:无

建议或要求:

要求在打印初始化后调用,建议在文本类函数之前调用。 举例一:LODOP.ADD_PRINT_RECT(10,10,100,60,0,1);

举例二:LODOP.ADD_PRINT_RECT(\

ADD_PRINT_ELLIPSE

名称:增加椭圆线

16

Lodop技术手册

格式:

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。 结果:无

建议或要求:

要求在打印初始化后调用,建议在文本类函数之前调用。 举例一:LODOP.ADD_PRINT_ELLIPSE(10,10,100,60,0,1);

举例二:LODOP.ADD_PRINT_ELLIPSE(\

ADD_PRINT_LINE

名称:增加直线 格式:

ADD_PRINT_LINE(Top1,Left1, Top2, Left2,intLineStyle, intLineWidth) 功能:增加直线,设定直线的两个端点,设定直线的线条类型和线宽。 参数: Top1:

端点1的上边距,整数或字符型,整数时缺省长度单位为px。字符型时可包含单位名:in(英寸)、cm(厘米) 、mm(毫米) 、pt(磅)、px(1/96英寸) 、%(百分比),如“10mm”表示10毫米。

17

Lodop技术手册

当上边距超过纸张高度时,打印项被输出在下一页(或更下页)。 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。 结果:无

建议或要求:

要求在打印初始化后调用,建议在文本类函数之前调用。 举例一:LODOP. ADD_PRINT_LINE(106,83,46,183,0,1);

举例二:LODOP. ADD_PRINT_LINE(\

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时。本参数

18

Lodop技术手册

可以用RightMargin关键字转义为打印区域相对于纸张的“右边距”。 Height:

该条码图的高度,整数或字符型,整数时缺省长度单位为px。字符型时可包含单位名:in(英寸)、cm(厘米) 、mm(毫米) 、pt(磅)、px(1/96英寸) 、%(百分比),如“10mm”表示10毫米,宽和高相等时是圆。本参数可以用BottomMargin关键字转义为打印区域相对于纸张的“下边距”。 CodeType:

条码类型,字符型。目前支持的类型(条码规制)如下:

128A,128B,128C,128Auto,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,PDF417。

其中QRCode和PDF417是二维码,其它为一维码。默认情况下“QRCode的版本”、“PDF417压缩模式”、“PDF417容错级别” “PDF417数据列数” “PDF417基条高(倍数)”等参数会根据宽度和高度自动调整,当然页面程序也可以直接设置它们的具体值。 CodeValue:

条码值,注意各种条码类型对条码值有长度限制,有的只能数字。 结果:无

建议或要求:

要求在初始化之后,打印或预览之前调用。

举例一:LODOP.ADD_PRINT_BARCODE(56,48,238,62,\举例二:LODOP.ADD_PRINT_BARCODE(56,48,122,115,\汉字内容\

LODOP.SET_PRINT_STYLEA(0,\

举例三:LODOP.ADD_PRINT_BARCODE(30,405,176,67,\我是pdf417value\

LODOP.SET_PRINT_STYLEA(0,\ LODOP.SET_PRINT_STYLEA(0,\LODOP.SET_PRINT_STYLEA(0,\LODOP.SET_PRINT_STYLEA(0,\

LODOP.SET_PRINT_STYLEA(0,\

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”

19

Lodop技术手册

表示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进制组合值或英文名三种描述法。 结果:无

建议或要求:

要求在初始化之后,打印或预览之前调用。

举例:LODOP.ADD_PRINT_CHART(0,0,420,190,0,\折线图的table超文本\

SET_PRINT_STYLE

名称:设置打印项风格

20

Lodop技术手册

格式:

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。普通项只打印一次;页眉页脚项则每页都在固定位置重复打印;页号项和页数项是特殊的页眉页脚项,其内容包含当前页号和全部页数;多页项每页都打印,直到把内容打印完毕,打印时在每页上的位置和区域大小固定一样(多页项只对纯文本有效)

21

Lodop技术手册

在页号或页数对象的文本中,有两个特殊控制字符:

“#”特指“页号”,“&”特指“页数”。

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 代表“是”,其它表示“否”,缺省值为“是”,

即缺省情况下,纯文本内容在打印维护时是禁止修改的。

结果:无

建议或要求:

打印初始化后、增加打印项之前调用本函数。 举例:LODOP.SET_PRINT_STYLE(\

PREVIEW

名称:打印预览 格式:PREVIEW()

功能:打印预览输出页。 参数:无

结果:显示打印预览界面。如果预览界面没有被嵌入页面中,而是被弹出窗口,那么关闭窗口时会返回数字结果值,该数字大于0时表示被实际打印的次数。 建议或要求:

建立打印页之后运行。 举例:LODOP.PREVIEW();

PRINT

名称:直接打印 格式:PRINT()

功能:不经打印预览的直接打印。 参数:无

结果:打印机开始实际打印,返回逻辑结果,正确打印时返回真,打印出错时返回假。 建议或要求:

建立打印页之后运行。

22

Lodop技术手册

举例:LODOP. PRINT ();

PRINT_SETUP

名称:打印维护

格式:PRINT_SETUP()

功能:对整页的打印布局和打印风格进行界面维护,它与打印设计的区别是不具有打印项增删功能,目标使用者是最终用户。 参数:无

结果:显示打印维护界面。如界界面没有被嵌入页面中,而是被弹出窗口,那么关闭窗口时会返回数字结果值,该数字大于0时表示被实际打印的次数,这里的实打次数包括打印维护界面“打印”按钮的直接打印和“预览”按钮进入预览后的打印。 建议或要求:

建立打印页之后运行。

举例:LODOP. PRINT_SETUP ();

PRINT_DESIGN

名称:打印设计

格式:PRINT_DESIGN ()

功能:对整页的打印布局和打印风格进行界面设计,它与打印维护的区别是具有打印项增删功能,目标使用者是软件开发者。 参数:无

结果:显示打印设计界面,设计完毕关闭窗口后,返回生成的程序代码。 建议或要求:

建立打印页之后运行。 举例:LODOP. PRINT_DESIGN ();

NEWPAGE

名称:强制分页 格式:NEWPAGE()

功能:强制分页。执行该函数之后所增加的内容会在前面内容的首页之后新建一页输出,前

面无内容时,仍然从第一页开始。 参数:无

结果:返回逻辑值

返回逻辑真表示强制分页成功,逻辑假表示强制分页失败。 建议或要求:

打印初始化后调用本函数。

23

Lodop技术手册

举例:LODOP. NEWPAGE ();

GET_PRINTER_COUNT

名称:获得打印设备个数

格式:GET_PRINTER_COUNT()

功能:获得操作系统内打印设备的个数。 参数:无

结果:返回数字

返回数字结果表示操作系统内的打印设备个数,0表示失败或无打印设备。 建议或要求:

任何时间调用均可。

举例:var iCount=LODOP. GET_PRINTER_COUNT ();

GET_PRINTER_NAME

名称:获得打印设备名称

格式:GET_PRINTER_NAME(strPrinterIDandType) 功能:按设备序号获得打印机名称、驱动名称等。 参数:

strPrinterIDandType:

由“设备序号:名称类型”组成,字符型或数字型参数,数字型(名称类型空)时专取打印机名称,序号从0开始,最大序号是GET_PRINTER_COUNT()减1。名称类型如下:

PrinterName:打印机名称 DriverName:驱动名称 PortName:端口名称 Orientation:打印方向

PaperSize:纸张大小(编号)

PaperLength:纸张长度,单位是0.1mm PaperWidth:纸张宽度,单位是0.1mm Copies:打印份数

DefaultSource:纸张来源

PrintQuality:打印质量(打印机分辨率),单位是dpi Color:是否彩色 Duplex:是否双面

FormName:表单名称,如“A4”等 Comment:注释说明

DriverVersion:驱动程序版本号

DCOrientation:获取横向打印的旋转度数是90度还是270度 MaxExtentWidth:获取打印机能支持的最大纸张规格宽度 MaxExtentLength:获取打印机能支持的最大纸张规格高度 MinExtentWidth:获取打印机能支持的最小纸张规格宽度

24

Lodop技术手册

MinExtentlength:获取打印机能支持的最小纸张规格高度 结果:返回字符

返回字符型结果,代表对应的名称或属性值,如返回空表示失败或无该设备。 建议或要求:

任何时间调用均可。

举例一:var strPName=LODOP. GET_PRINTER_NAME(0); 获取0号设备的打印机名称。

举例二:var strDName =LODOP. GET_PRINTER_NAME(―1:DriverName‖); 获取1号设备的驱动名称。

举例三:var strKName =LODOP. GET_PRINTER_NAME(―1:PortName‖); 获取1号设备的端口名称

SET_PRINTER_INDEX

名称:指定打印设备

格式:SET_PRINTER_INDEX(oIndexOrName)

功能:按名称或序号指定要进行打印输出的设备,指定后禁止重新选择。。 参数:

oIndexOrName:

打印机名称或序号,字符或数字型。数字表示打印机的序号,从0开始,最大序号是GET_PRINTER_COUNT()减1。-1特指操作系统内设定的默认打印机。 字符代表打印机的名称,与操作系统内的打印机名称一致。

注:用本函数指定打印机后,在预览界面不允许重新选择打印机,而用另外一个函数SET_PRINTER_INDEXA指定后则允许重新选择。 结果:返回逻辑值

返回逻辑真表示指定成功,逻辑假表示指定失败,失败原因有:该打印设备不存在。 建议或要求:

要求在初始化之后、打印或预览之前调用。 举例一: LODOP. SET_PRINTER_INDEX (0); 举例二: LODOP. SET_PRINTER_INDEX (-1);

SELECT_PRINTER

名称:选择打印设备

格式:SELECT_PRINTER

功能:弹出界面选定某打印设备为目标输出设备。 参数:无

结果:返回数字

返回数字结果表示选定的设备序号,返回-1表示放弃选择,没有任何动作。 建议或要求:

直接打印前或打印预览前调用。本函数与SET_PRINTER_INDEX的功能效果一样。 举例:LODOP. SELECT_PRINTER();

25

本文来源:https://www.bwwdw.com/article/mijg.html

Top