Lodop5.0技术手册

打印控件需要升级!点击这里执

行升级,升级后请重新进入。

其中的关键点是Version函数，Lodop提供了一个“读版本号”功能，这样控件的安装和升级任务就交给JS来实现，以下是控件在页面内的调用代码，其中包含CheckLodop

4

的利用：

„

以上两段代码相互配合实现了Lodop的安装、调用和升级。之所以将CheckActivX.js作为一个资源文件来部署，既可以利用浏览器的缓存减少页面内容的重复下载，同时还实现了控件发布统一管理，整个应用系统中只要这一个地方发布Lodop。其它页面直接拷贝嵌入第2段代码就可以了。

npActiveXFirefox4x.xpi

该文件是Firefox浏览器需要的安装附加文件。目前Lodop支持IE系列浏览器、Firefox系列浏览器和IE内核类浏览器(遨游、腾讯TT、麒麟、世界之窗等)及其它支持ActiveX的各类浏览器。

三、控件参数

Lodop有如下控件参数,以网页插件(ActiveX)参数形式使用：

Caption

名称：设置打印控件的显示标题

格式：

功能：打印控件在页面内一般是以object元素形式被引用。可以通过设置元素的width和

height等于0来隐藏控件，不隐藏时可以为控件设置一个标题，以便于看到控件是否被正确安装，以及控制对象在页面内的位置。希望打印预览界面或设计界面内嵌到网页内时，本参数显然很有用。

5

Color

名称：设置打印控件的显示区域颜色

格式：

功能：通过该参数设置控件显示区域的底色，对于希望打印预览界面或设计界面内嵌到网页

内时，本参数显然可以让控件容易融于整体页面。

参数值采用超文本颜色形式，可以是三色16进制值组合，也可以是英文颜色名。

Border

名称：设置打印控件的显示区域边界

格式：

功能：通过该参数设置控件显示区域的边界，值等于1表示有边界，否则无边界。本参数显

然可以让控件更融于整体页面。

另外，控件还有三个用于注册的辅助参数，参考后面《软件使用权注册》一节。

四、功能函数

Lodop的功能函数不多，但参数比较复杂。全部函数分“基本函数”和“扩展函数”两类，两类函数有类似性，基本函数使用简单，达不到要求时请使用扩展函数，二者无本质区别。

1、基本函数 VERSION

名称：获得软件版本号 格式：VERSION

结果：返回字符型结果

版本号有四个数字组成，样式为：X.X.X.X

6

PRINT_INIT

名称：打印初始化

格式：PRINT_INIT(strTaskName)

功能：初始化运行环境，清理异常打印遗留的系统资源，设定打印任务名。 参数：

strTaskName：

打印任务名，字符型参数，由开发者自主设定，未限制长度，字符要求符合Windows文件起名规则，Lodop会根据该名记忆相关的打印设置、打印维护信息。

若strTaskName空，控件则不保存本地化信息，打印全部由页面程序控制。 结果：返回逻辑值

返回逻辑真表示初始化成功，逻辑假表示初始化失败，失败原因有：前一个打印事务没有完成；操作系统没有打印机(驱动)等。 建议或要求：

该函数与SET_PRINT_PAPER都有初始化功能，每个打印事务至少初始化一次，建议打印程序首先调用该函数。任务名要尽量区别于其它打印任务，譬如用“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：

设为标准纸张，纸张类型名，字符型，只能在如下名称中选择，不限大小写：

7

Letter, LetterSmall, Tabloid, Ledger, Legal,Statement, Executive,

A3, A4, A4Small, A5, B4, B5, Folio, Quarto, qr10X14, qr11X17, Note, Env9, Env10, Env11, Env12,Env14, Sheet, DSheet, Esheet

注：PageWidth、PageHeight 和strPageName都无效时，本函数对纸张大小不起作用，控件则采用所选打印机的默认纸张，但intOrient仍可起作用。

如果打印程序未采用扩展方式（SET_PRINT_PAPER）初始化，本函数的固定纸张功能所定制的纸张大小，会起到SET_PRINT_PAPER中Width和Height的相同功能。 结果：无 建议或要求：

打印初始化之后调用。

如果打印纸张不固定，希望由操作者自主选择纸张时，则不要调用本函数。

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毫米。 Height：

打印区域的高度，整数或字符型，整数时缺省长度单位为px。字符型时可包含单位名：in(英寸)、cm(厘米) 、mm(毫米) 、pt(磅)、px(1/96英寸)，如“10mm”表示10毫米，控件按这个值自动分页。

strHtmlContent：

超文本代码内容，字符型，未限制长度。可以是一个完整的页面，也可以是代码段。超文本代码中包含有style=\"page-break-after:always\"或style=\"page-break-before:always\"的元素称为“强制分页元素”，控件会在该元素处分页。

结果：无

建议或要求：

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

8

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毫米。 Height：

表格数据体(tbody)区域的高度，整数或字符型，整数时缺省长度单位为px。字符型时可包含单位名：in(英寸)、cm(厘米) 、mm(毫米) 、pt(磅)、px(1/96英寸)，如“10mm”表示10毫米。控件按这个值自动分页。

strHtml：

超文本代码内容，字符型，未限制长度。可以是一个完整的页面，也可以是代码段，要求至少包含一个table元素。

特别说明：本函数能识别的超文本专有元素属性有tdata、format、tclass、tindex等四个，它们主要用来实现分页小计、分类合计等统计功能，这四个属性可以用在tfoot元素内的任何子元素上，包含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 ”等等,其中的“#”表示当数据为0时不显示。

9

③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毫米。 Height：

打印区域的高度，整数或字符型，整数时缺省长度单位为px。字符型时可包含单位名：in(英寸)、cm(厘米) 、mm(毫米) 、pt(磅)、px(1/96英寸)，如“10mm”表示10毫米。控件按这个值自动分页。 strURL：

页面URL地址，字符型，未限制长度。 结果：无

建议或要求：

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

10

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毫米。 Height：

打印区域的高度，整数或字符型，整数时缺省长度单位为px。字符型时可包含单位名：in(英寸)、cm(厘米) 、mm(毫米) 、pt(磅)、px(1/96英寸)，如“10mm”表示10毫米。 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(英

11

寸)、cm(厘米) 、mm(毫米) 、pt(磅)、px(1/96英寸)，如“10mm”表示10毫米。 Height：

图片的高度，整数或字符型，整数时缺省长度单位为px。字符型时可包含单位名：in(英寸)、cm(厘米) 、mm(毫米) 、pt(磅)、px(1/96英寸)，如“10mm”表示10毫米。图片大时被截取，不会分到下页。 strHtmlContent：

超文本代码内容，字符型，未限制长度。获得图片的超文本（用标签IMG）。 结果：无 建议或要求：

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

本函数可用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毫米。 Height：

该矩形的高度，整数或字符型，整数时缺省长度单位为px。字符型时可包含单位名：in(英寸)、cm(厘米) 、mm(毫米) 、pt(磅)、px(1/96英寸)，如“10mm”表示10毫米。宽和高相等时是正方形。 varLineStyle：

线条类型，数字型，0--实线 1--破折线 2--点线 3--点划线 4--双点划线 缺省线条是实线。 intLineWidth：

线条宽，整数型，单位是(打印)像素，缺省值是1，非实线的线条宽也是1。 结果：无

建议或要求：

要求在打印初始化后调用，建议在文本类函数之前调用。

12

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毫米。 Height：

该椭圆的外缘矩形的高度，整数或字符型，整数时缺省长度单位为px。字符型时可包含单位名：in(英寸)、cm(厘米) 、mm(毫米) 、pt(磅)、px(1/96英寸)，如“10mm”表示10毫米，宽和高相等时是圆。 intLineStyle：

线条类型，数字型，0--实线 1--破折线 2--点线 3--点划线 4--双点划线 缺省线条是实线。

intLineWidth：

线条宽，整数型，单位是（打印）像素，缺省值是1，非实线的线条宽也是1。 结果：无

建议或要求：

要求在打印初始化后调用，建议在文本类函数之前调用。

ADD_PRINT_LINE

名称：增加直线

格式：

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

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

13

当上边距超过纸张高度时，打印项被输出在下一页(或更下页)。

Left1：

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

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

当上边距超过纸张高度时，打印项被输出在下一页(或更下页)。 Left2：

端点2的左边距，整数或字符型，整数时缺省长度单位为px。字符型时可包含单位名：in(英寸)、cm(厘米) 、mm(毫米) 、pt(磅)、px(1/96英寸)，如“10mm”表示10毫米。 intLineStyle：

线条类型，数字型，0--实线 1--破折线 2--点线 3--点划线 4--双点划线 缺省线条是实线。 intLineWidth：

线条宽，整数型，单位是(打印)像素，缺省值是1，非实线的线条宽也是1。 结果：无

建议或要求：

要求在打印初始化后调用，建议在文本类函数之前调用。

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毫米。 Height：

该条码图的高度，整数或字符型，整数时缺省长度单位为px。字符型时可包含单位名：in(英寸)、cm(厘米) 、mm(毫米) 、pt(磅)、px(1/96英寸)，如“10mm”表示10毫米，宽和高相等时是圆。 CodeType：

14

条码类型，字符型。目前支持的类型（条码规制）主要是一维条码，有如下几种： 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。 CodeValue：

条码值。 结果：无

建议或要求：

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

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。

FontColor的值：整数或字符型，整数时是颜色的十进制RGB值；字符时是超文本颜色值，可以是“#”加三色16进制值组合，也可以是英文颜色名；

Bold的值：数字型，1代表粗体，0代表非粗体，缺省值是0。

15

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，非实线的线条宽也是1。

PenStyle的值：数字型，0--实线 1--破折线 2--点线 3--点划线 4--双点划线

缺省值是0。

Stretch的值：数字型，0--截取图片 1--扩展（可变形）缩放 2--按原图长和宽比例（不变形）缩放。缺省值是0。

PreviewOnly的值：字符或数字型，1或“true”代表仅预览，否则为正常内容。 ReadOnly的值：字符或数字型，1或“true” 代表“是”，其它表示“否”，缺省值为“是”，

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

建议或要求：

打印初始化后、增加打印项之前调用本函数。

NEWPAGE

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

功能：强制分页。执行该函数之后所增加的内容会在下一页输出。在执行该函数之前，需要至少有一项内容，否则该函数不动作。 参数：无

结果：返回逻辑值

返回逻辑真表示强制分页成功，逻辑假表示强制分页失败。

16

建议或要求：

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

PREVIEW

名称：打印预览

格式：PREVIEW()

功能：打印预览输出页。

参数：无

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

建立打印页之后运行。

PRINT

名称：直接打印

格式：PRINT()

功能：不经打印预览的直接打印。

参数：无

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

建立打印页之后运行。

PRINT_SETUP

名称：打印维护

格式：PRINT_SETUP()

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

参数：无

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

建立打印页之后运行。

17

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(intIndex) 功能：指定用某打印设备输出。

18

参数：

intIndex：

所指定打印设备的序号，数字型，序号从0开始，最大序号是GET_PRINTER_COUNT()减1。

结果：返回逻辑值

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

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

SELECT_PRINTER

名称：选择打印设备 格式：SELECT_PRINTER

功能：弹出界面选定某打印设备为固定输出设备。 参数：无

结果：返回数字

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

直接打印前或打印预览前调用。本函数与SET_PRINTER_INDEX的功能效果一样。

SET_SHOW_MODE

19

名称：设置显示模式 格式：

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”：隐藏预览窗口的打印设置按钮

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\100001\"); 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”=是,否则不是。

结果：返回逻辑结果，成功时返回真，失败时返回假。 建议或要求：

初始化之后，进入功能（打印预览、打印维护或打印设计）界面前调用本函数。

20

SET_PRINT_MODE

名称：设置打印模式 格式：

SET_PRINT_MODE (strModeType,varModeValue) 功能：设置人工双面打印模式等。 参数：

strModeType模式类型名，字符型，如下是类型名及其含义： “DOUBLE_SIDED_PRINT”：设置是否人工双面打印。

varModeValue模式类型值，整数或字符型，相关值如下：

DOUBLE_SIDED_PRINT的值：整数或字符型，1或“1”或“True”=是,否则不是。 结果：返回逻辑结果，成功时返回真，失败时返回假。 建议或要求：

直接打印前或打印预览前调用。

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

名称：指定背景图

21

格式：ADD_PRINT_SETUP_BKIMG(strImgHtml) 功能：用程序方式指定打印维护或打印设计的背景图。 参数： strImgHtml：

获得背景图的超文本代码，字符型，用IMG标签设定图片的URL和大小。

结果：无

建议或要求：

初始化之后调用。

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”) 结果：返回逻辑结果，发送成功时返回真，发送失败时返回假。 建议或要求：

任何时间调用。

22

READ_PORT_DATA

名称：读端口数据

格式：READ_PORT_DATA(strPortName) 功能：直接从端口读数据。

参数：

strPortName：端口名，同操作系统的端口名，名称如下： LPT1、LPT2、LPT3、COM1、COM2、COM3…

结果：返回字符数据。 建议或要求：

任何时间调用。

GET_PRINT_INIFFNAME

名称：获得配置文件名

格式：GET_PRINT_INIFFNAME (strPrintTask)

功能：获得某打印任务的本地配置文件全路径名。 参数：

strPrintTask：

打印任务名，字符型，即初始化时所设的任务名。 结果：返回字符

返回字符结果表示本地配置文件全路径名（并非文件内容），空表示失败。 建议或要求：

在初始化之后调用。

WRITE_FILE_TEXT

名称：写本地文件内容

格式：WRITE_FILE_TEXT(intWriteMode,strFileName, strText) 功能：向本地文件写入文本内容。 参数：

intWriteMode：

写入模式，数字型，0--文件覆盖模式 1--文件尾追加模式 2--文件首插入模式。 strFileName：

本地文件名，字符型，文件名包含全路径。 strText：

写入的文本内容，字符型。

结果：调用函数后控件启动安全提示，等待操作许可。

返回字符值表示写入情况： “ok”-写入成功

23

“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：

24

本地文件名，字符型，含全路径。

结果：返回逻辑值，逻辑真表示文件存在，逻辑假表示文件不存在。 建议或要求：

任何时间调用。

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 ---主板序列号 关于Processor的： Processor.CPUID Processor.ProcessorID Processor.DeviceID Processor.Name Processor.CpuStatus Processor.SystemName Processor.ProcessorType Processor.Caption …..

结果：返回字符

返回字符或整数，表示系统信息值，null表示读取失败。

建议或要求：

25

任何时间调用。

2、扩展函数 SET_PRINT_PAPER

名称：(扩展型)打印初始化

格式：SET_PRINT_PAPER(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) 功能：增加超文本打印项，设定该打印项在纸张内的位置和区域大小，实现超文本控制打印。

26

参数：同ADD_PRINT_HTM 结果：无

建议或要求：

图形模式打印速度快，但不适合要求文本打印质量高的情况，特别是要面对针式打印机。

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：要设置的目标项序号或项目名，数字型或字符型。

 数字型时，表示是序号，以其增加的先后自然顺序为准，从1开始，所有打印对象

都参与排序，包括超文本、纯文本、矩形线、椭圆线、直线等。

27

 字符型时，表示是打印项的项目名，见ADD_PRINT_TEXTA的strItemName

strStyleName：打印风格名，风格名称及其含义如下：

“PageIndex”： 指定输出页的序号控制字。

“PreviewOnly”： 指定内容仅仅用来预览。 其它见SET_PRINT_STYLE varStyleValue：打印风格值，相关值如下：

PageIndex的值：字符型，用该序号字指定本数据项输出到哪些页。“First”第一页；“Last”最后页；“Odd”奇数页；“Even”偶数页；“具体数字”对应具体页；空表示默认页。缺省值是空。

PreviewOnly的值：字符或数字型，1或“true”代表仅预览，否则为正常内容。 其它见SET_PRINT_STYLE

结果：同函数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文件中的表格页脚（中）内容

28

“LEFTFOOTER”：Excel文件中的表格页脚（左）内容 “RIGHTFOOTER”：Excel文件中的表格页脚（右）内容 “QUICK_SAVE”：保存表格时是否采用快速模式。 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”或其它=否。

如果采用快速模式，在生成表格单元时将忽略样式和本函数的其它

设置，生成速度较快，适宜数据较多且不在乎表格样式时。

结果：返回逻辑结果，成功时返回真，失败时返回假。 建议或要求：

导出数据(SAVE_TO_FILE)前调用本函数。

SET_PRINT_TEXT_STYLEA

名称：(扩展型)设置文本风格A 格式：

SET_PRINT_TEXT_STYLEA(varItemNO,strFontName,intSize,intBold,intItalic,intUnderline, intAlign,varColor)

功能：设置某纯文本项的打印风格。

29

参数：

varItemNO：要设置的目标项序号或项目名，数字型或字符型。

 数字型时，表示是序号，以其增加的先后自然顺序为准，从1开始，所有打印对象

都参与排序，包括超文本、纯文本、矩形线、椭圆线、直线等。

 字符型时，表示是打印项的项目名，见ADD_PRINT_TEXTA的strItemName strFontName：

设定该文本打印项的字体名，字符型，与操作系统字体名一致，缺省（不调用本函数时）字体是“宋体”。 intSize：

设定该文本打印项的字体大小，数字型，单位是pt，缺省值是9。

intBold：

设定该文本打印项是否粗体，数字型，1代表粗体，0（或非1）代表非粗体，缺省值是0。

intItalic：

设定该文本打印项是否斜体，数字型，1代表斜体，0（或非1）代表非斜体，缺省值是0。

intUnderline：

设定该文本打印项是否下划线，数字型，1代表有下划线，0（或非1）代表无下划线，缺省值是0。 intAlign：

文本内容在打印区域内靠齐方式，数字型，1--左靠齐 2--居中 3--右靠齐，缺省值是1。 varColor：

打印项的颜色，整数或字符型，整数时是颜色的十进制RGB值；字符时是超文本颜色值，可以是“#”加三色16进制值组合，也可以是英文颜色名； 结果：无

建议或要求：

要求在目标对象增加(ADD_PRINT_TEXT)后调用本函数。

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毫米。

30

当上边距超过纸张高度时，打印项被输出在下一页(或更下页)。

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，非实线的线条宽也是1。 varColor：

图形的颜色，整数或字符型，整数时是颜色的十进制RGB值；字符时是超文本颜色值，可以是“#”加三色16进制值组合，也可以是英文颜色名； 结果：无

建议或要求：

要求在打印初始化后调用，建议在文本类函数之前调用。

SET_PRINTER_INDEXA

名称：(扩展型)指定打印设备

格式：SET_PRINTER_INDEXA (strPrinterName)

功能：同函数SET_PRINTER_INDEX。按名称指定打印设备。 参数：

strPrinterName：

打印设备名称，字符型。注：函数GET_PRINTER_NAME可获得打印设备名。 结果：同函数SET_PRINTER_INDEX。 建议或要求：

同函数SET_PRINTER_INDEX。

PREVIEWA

名称：(扩展型)打印预览A 格式：PREVIEWA ()

功能：同函数PREVIEW。预览前提示选择打印机。

31

参数：同函数PREVIEW。 结果：同函数PREVIEW。 建议或要求：

同函数PREVIEW。

PREVIEWB

名称：(扩展型)打印预览B

格式：PREVIEWB ()

功能：同函数PREVIEW。强制用缺省布局风格来打印预览。 参数：同函数PREVIEW。 结果：同函数PREVIEW。 建议或要求：

同函数PREVIEW。不希望最终使用者改变打印布局和风格时调用本函数。

PRINTA

名称：(扩展型)直接打印A 格式：PRINTA ()

功能：同函数PRINT。打印前提示选择打印机。 参数：同函数PRINT。

结果：同函数PRINT。返回逻辑结果，当真实打印时返回真，放弃打印或打印出错时返回假。 建议或要求：

同函数PRINTA。

PRINTB

名称：(扩展型)直接打印B

格式：PRINTB ()

功能：同函数PRINT。强制用缺省布局风格来打印。

参数：同函数PRINT。 结果：同函数PRINT。 建议或要求：

同函数PRINT。不希望最终使用者改变打印布局和风格时调用本函数。

SET_LICENSES

名称：设置软件产品注册信息 格式：

32

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

名称：设置注册单位名称

格式：

功能：该名称配合License实现按使用者单位名称注册。这种注册不限制域名，注册者可把

Lodop用于多个WEB工程，适合软件开发公司注册。页面使用单位名称注册号后，打印结果的水印消失，并在打印预览的状态栏有该单位名称的明示。

License

名称：设置注册号

格式： 功能：该注册号有两项功能：

33

一、当CompanyName不空时，该注册号配合其实现按使用者单位名称注册。这种注册不限制域名，注册者可把Lodop用于多个WEB工程，适合软件开发公司注册。

二、当CompanyName空时，这是域名注册号之一，一般是域名的名称注册号。这种注册只限

该域名使用，价格便宜，适合最终使用单位注册。

LicenseA

名称：设置附加注册号A

格式：

功能：当CompanyName空时，这是域名注册号之二，一般是内网IP注册号，随主注册号免

费赠送。

LicenseB

名称：设置附加注册号B

格式：

功能：当CompanyName空时，这是域名注册号之三，一般是外网IP注册号，随主注册号免

费赠送。

六、打印维护和打印设计

打印设计的目标用户是软件开发者，详细功能解释略。 打印维护的目标用户是页面操作者，详细功能解释略。

七、使用样例

演示样例清单如下（样例内容参见发行包）：

1.

如何在页面内嵌入控件见样例一 2.

如何裁剪打印当前页面内容见样例二 3.

如何用代码生成打印页见样例三 4.

如何打印设计和定位套打见样例四 5.

如何控制纸张大小和连续打印见样例五 6.

如何打印多页长文档及双面打印见样例六 7.

如何定向输出见样例七 8.

如何打印图片见样例八 9.

如何用程序加载打印维护背景图见样例九

34

10 如 何控制打印样式(STYLE)见样例十 11 如

何打印条码图案见样例十一 12 如 何读写本地文件见样例十二 13 如 何打印旋转内容见样例十三 14 如何按URL打印见样例十四 15 如何打印表格的页头页尾见样例十五 16 如何设置预览窗口大小见样例十六

17 如何发打印机指令或直接写端口见样例十七 18 如何打印幅面高度不固定的票据见样例十八 19 如何内嵌显示及预览时包含背景图见样例十九 20 如 何一次性预览多页卡片见样例二十 21 如 何控制打印维护的功能权限见样例二十一 22 如何构建自己的纯WEB打印预览见样例二十二 23 如何居中打印超文本见样例二十三 24 如何选择界面皮肤见样例二十四

25 如何指定输出到哪页或仅预览见样例二十五 26 如何提高多页打印的性能见样例二十六 27 如何导出数据到Excel文件见样例二十七 28 如何快速读取客户端系统信息见样例二十八 29 如何使用其它长度单位见样例二十九 30 如何分页输出页面内容见样例三十

31 如何打印表格的分页小计或合计见样例三十一

八、计量单位

本文所述px单位固定换算关系如下,与像素类似但不是一个概念，也不受显示影响：1in(英寸)=2.54cm(厘米)=25.4mm(毫米)=72pt(磅)=96px

<完>

35