Lodop6.1技术手册(2)

Lodop技术手册

{document.documentElement.innerHTML=strHtmFireFox+document.documentElement.innerHTML;};

if (is64IE) {document.write(strHtm64_Install);} else

if (isIE) {document.write(strHtmInstall); } else

{document.documentElement.innerHTML=strHtmInstall+document.documentElement.innerHTML;};

return LODOP;

if (is64IE){document.write(strHtm64_Update);} else if (isIE) {document.write(strHtmUpdate); } else

}

//******************************************* return LODOP; }catch(err){

document.documentElement.innerHTML=\ return LODOP; }

return LODOP;

{document.documentElement.innerHTML=strHtmUpdate+document.documentElement.innerHTML; };

}

//*****如下空白位置适合调用统一功能:********* } else if (LODOP.VERSION<\

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

?

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

6

Lodop技术手册

拷贝嵌入第2段代码就可以了。

三、控件参数

Lodop有如下控件参数,以页面object对象元素的参数形式使用：

Caption

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

格式：

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

Color

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

格式：

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

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

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

Border

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

格式：

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

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

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

四、功能函数

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

7

Lodop技术手册

1、基本函数 VERSION

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

结果：返回字符型结果

版本号有四个数字组成，样式为：X.X.X.X 举例：var strVersion=LODOP.VERSION;

PRINT_INIT

名称：打印初始化

格式：PRINT_INIT(strTaskName)

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

strTaskName：

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

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

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

该函数与PRINT_INITA都有初始化功能，每个打印事务至少初始化一次，建议打印程序首先调用该函数。任务名要尽量区别于其它打印任务，譬如用“XX单位_XX管理信息系统_XX子系统_XX模块_XX打印作业”字样。

不希望最终用户更改打印布局时，则设strTaskName空。

举例：LODOP.PRINT_INIT(\打印控件功能演示_Lodop功能_表单一\

LODOP.PRINT_INIT(\

SET_PRINT_PAGESIZE

名称：设定纸张大小

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

功能：设定打印纸张为固定纸张或自适应内容高，并设定相关大小值或纸张名及打印方向。 参数： intOrient：

8

Lodop技术手册

打印方向及纸张类型，数字型， 1---纵(正)向打印，固定纸张； 2---横向打印，固定纸张；

3---纵(正)向打印，宽度固定，高度按打印内容的高度自适应； 0(或其它)----打印方向由操作者自行选择或按打印机缺省设置； PageWidth：

设定自定义纸张宽度，整数或字符型，整数时缺省长度单位为0.1mm, 譬如该参数值为45，则表示4.5毫米。字符型时可包含单位名：in(英寸)、cm(厘米) 、mm(毫米) 、pt(磅)，如“10mm”表示10毫米。数值等于0时本参数无效。 PageHeight：

固定纸张时设定纸张高；高度自适应时设定纸张底边的空白高。整数或字符型，整数时缺省长度单位为0.1毫米。字符型时可包含单位名：in(英寸)、cm(厘米) 、mm(毫米) 、pt(磅)，如“10mm”表示10毫米。数值等于0时本参数无效。

宽或高无效时下面的strPageName才起作用。 strPageName：

所选纸张类型名，字符型。不同打印机所支持的纸张可能不一样，这里的名称同操作系统内打印机属性中的纸张名称，支持操作系统内的自定义纸张。

关键字“CreateCustomPage”会按以上宽度和高度自动建立一个自定义纸张，所建立的纸张名固定为“LodopCustomPage”，多次建立则刷新该纸张的大小值。

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

实际打印时，控件按如下优先级顺序确定纸张大小： 第1优先是打印维护里纸张属性（“本机自行定义纸张”）设置的纸张大小。 第2优先是SET_PRINT_PAGESIZE指定的纸张大小； 第3优先是上次打印时在预览界面设置里选择的纸张类型； 第4是按所选打印机的默认纸张； 结果：无

建议或要求：

打印初始化之后调用。

如果打印纸张不固定，希望由操作者自主选择纸张时，则不要调用本函数。 举例一：LODOP. SET_PRINT_PAGESIZE (1 …… 此处隐藏：3239字，全部文档内容请下载后查看。喜欢就下载吧 ……