Lodop是一款专业的WEB打印控件,其设计目标是简单易用、功能足够强大,开创WEB打印开发的新局面。
Lodop设计者对WEB下的打印开发任务进行了分类汇总,高度抽象,设计出仅用几个功能函数,就可实现复杂的打印任务,尽量减少使用者的知识累赘。控件发布包有3个系统文件组成,全部功能用几个控件参数和2组功能函数来实现。
Lodop控件下载网址:http://mt.runon.cn/
一、概述
Lodop是一款专业的WEB打印控件,其设计目标是简单易用、功能足够强大,开创WEB打印开发的新局面。
Lodop设计者对WEB下的打印开发任务进行了分类汇总,高度抽象,设计出仅用几个功能函数,就可实现复杂的打印任务,尽量减少使用者的知识累赘。控件发布包有3个系统文件组成,全部功能用几个控件参数和2组功能函数来实现。
尽管我们有个理想化的目标,那就是您不用详细了解这些参数或函数,仅仅看懂几个样例文件就能很轻松地开始使用本控件,为此Lodop提供了一个足够完善的设计界面,用它可以实现大多数打印开发任务,但事实上了解这些参数和函数总还是有好处的,特别是当您的开发任务很复杂时,这就是本文目的,但愿本文档足够详细且简单明了。
如果此前曾看过lodop的入门样例程序,本文会更容易理解!
二、系统文件
Lodop发布包内主要有如下几个文件:
install_lodop.exe
该文件是控件安装和升级的主文件,提供给用户或开发者下载安装,如果不特意拦截一般都能100%安装,对“网页插件安装难”有一定改善。如果将其复制或改名为uninstall_lodop.exe (名前加un)就可用其卸载控件。
Lodop安装后,在操作系统Program Files\MountTaiSoftware\Lodop目录下会生成两个实体文件: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的任务是判断当前浏览器的类型并决定采用哪个对象实例,并检测控件是否安装、是否最新版本、并引导安装或升级。文件内容如下:
function getLodop(oOBJECT,oEMBED){ var strHtml1="<br><font color='#FF00FF'>打印控件未安装!点击这里<a href='install_lodop.exe'>执行安装</a>,安装后请刷新页面或重新进入。</font>"; var strHtml2="<br><font color='#FF00FF'>打印控件需要升级!点击这里<a href='install_lodop.exe'>执行升级</a>,升级后请重新进入。</font>"; var strHtml3="<br><br><font color='#FF00FF'>(注:如曾安装过Lodop旧版附件npActiveXPLugin,请在【工具】->【附加组件】中先卸载它)</font>"; 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) document.documentElement.innerHTML=strHtml3+document.documentElement.innerHTML; if (navigator.appVersion.indexOf("MSIE")>=0) document.write(strHtml1); else document.documentElement.innerHTML=strHtml1+document.documentElement.innerHTML; } else if (LODOP.VERSION<"6.0.0.1") { if (navigator.appVersion.indexOf("MSIE")>=0) document.write(strHtml2); else document.documentElement.innerHTML=strHtml2+document.documentElement.innerHTML; } //*****如下空白位置适合调用统一功能:********* //******************************************* return LODOP; }catch(err){ document.documentElement.innerHTML="Error:"+strHtml1+document.documentElement.innerHTML; return LODOP; } } |
其中的关键点是VERSION函数,Lodop提供了这个“读版本号”功能,这样控件的安装和升级任务就交给JS来实现,以下是控件在页面内的调用代码,其中包含getLodop的使用:
<head> <title></title> <script language="JavaScript" src="LodopFuncs.js"></script> <object id="LODOP" classid="clsid:2105C259-1E0C-4534-8141-A753534CB4CA" width=0 height=0> <embed id="LODOP_EM" type="application/x-print-lodop" width=0 height=0></embed> </object> </head> <body> <script language="javascript"> var LODOP=getLodop(document.getElementById('LODOP'),document.getElementById('LODOP_EM')); </script> … </body> |
以上两段代码相互配合实现了Lodop的安装、调用和升级。之所以将LodopFuncs.js作为一个资源文件来部署,既可以利用浏览器的缓存减少页面内容的重复下载,同时还实现了控件发布统一管理,整个应用系统中只要这一个地方发布Lodop。其它页面直接拷贝嵌入第2段代码就可以了。
打印幅面高度不固定样例:
- <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
- <html>
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
- <title>WEB打印小票样例</title>
-
- <script language="javascript" src="LodopFuncs.js"></script>
-
- <object id="LODOP_OB" classid="clsid:2105C259-1E0C-4534-8141-A753534CB4CA" width=0 height=0>
- <embed id="LODOP_EM" type="application/x-print-lodop" width=0 height=0 pluginspage="install_lodop.exe"></embed>
- </object>
- </head>
- <body>
- <input type="button" value="打印预览" onclick="printPreview()" />
-
- <input type="button" value="直接打印" onclick="printOrder()" />
- <script language="javascript" type="text/javascript">
- var LODOP; //声明为全局变量
- function printPreview(){
- //创建小票打印页
- CreatePrintPage();
- //打印预览
- LODOP.PREVIEW();
- }
- /**
- * 样例函数,服务器确认订单后执行
- */
- function printOrder() {
-
- //创建小票打印页
- CreatePrintPage();
- //开始打印
- LODOP.PRINT();
-
- };
- function CreatePrintPage(json) {
- //json 创建模拟服务器响应的订单信息对象
- var json = {"title":"XXXXX订单信息", "name":"张三", "phone": "138123456789", "orderTime": "2012-10-11 15:30:15",
- "orderNo": "20122157481315", "shop":"XX连锁", "total":25.10,"totalCount":6,
- "goodsList":[
- {"name":"菜心(无公害食品)", "price":5.00, "count":2, "total":10.08},
- {"name":"菜心(无公害食品)", "price":5.00, "count":2, "total":10.02},
- {"name":"旺菜", "price":4.50, "count":1, "total":4.50},
- {"name":"黄心番薯(有机食品)", "price":4.50, "count":1, "total":4.50}
- ]
- }
- var hPos=10,//小票上边距
- pageWidth=580,//小票宽度
- rowHeight=15,//小票行距
- //获取控件对象
- LODOP=getLodop(document.getElementById('LODOP_OB'),document.getElementById('LODOP_EM'));
- //初始化
- LODOP.PRINT_INIT("打印控件功能演示_Lodop功能_名片");
- //添加小票标题文本
- LODOP.ADD_PRINT_TEXT(hPos,30,pageWidth,rowHeight,json.title);
- //上边距往下移
- hPos+=rowHeight;
-
- LODOP.ADD_PRINT_TEXT(hPos,1,pageWidth,rowHeight,"姓名:");
- LODOP.ADD_PRINT_TEXT(hPos,30,pageWidth,rowHeight,json.name);
- //hPos+=rowHeight; //电话不换行
- LODOP.ADD_PRINT_TEXT(hPos,70,pageWidth,rowHeight,"电话:");
- LODOP.ADD_PRINT_TEXT(hPos,100,pageWidth,rowHeight,json.phone);
- hPos+=rowHeight;
- LODOP.ADD_PRINT_TEXT(hPos,1,pageWidth,rowHeight,"下单时间:");
- LODOP.ADD_PRINT_TEXT(hPos,60,pageWidth,rowHeight,json.orderTime);
- hPos+=rowHeight;
- LODOP.ADD_PRINT_TEXT(hPos,1,pageWidth,rowHeight,"订单编号:");
- LODOP.ADD_PRINT_TEXT(hPos,60,pageWidth,rowHeight,json.orderNo);
- hPos+=rowHeight;
- LODOP.ADD_PRINT_TEXT(hPos,1,pageWidth,rowHeight,"取货门店:");
- LODOP.ADD_PRINT_TEXT(hPos,60,pageWidth,rowHeight,json.shop);
- hPos+=rowHeight;
- LODOP.ADD_PRINT_LINE(hPos,2, hPos, pageWidth,2, 1);
- hPos+=5;
- LODOP.ADD_PRINT_TEXT(hPos,1,pageWidth,rowHeight,"商品名称");
- LODOP.ADD_PRINT_TEXT(hPos,70,pageWidth,rowHeight,"单价");
- LODOP.ADD_PRINT_TEXT(hPos,110,pageWidth,rowHeight,"数量");
- LODOP.ADD_PRINT_TEXT(hPos,140,pageWidth,rowHeight,"小计");
- hPos+=rowHeight;
- //遍历json的商品数组
- for(var i=0;i<json.goodsList.length;i++){
-
- if(json.goodsList[i].name.length<4){
- LODOP.ADD_PRINT_TEXT(hPos,1,pageWidth,rowHeight,json.goodsList[i].name);
- }else {
- //商品名字过长,其他字段需要换行
- LODOP.ADD_PRINT_TEXT(hPos,1,pageWidth,rowHeight,json.goodsList[i].name);
- hPos+=rowHeight;
- }
- LODOP.ADD_PRINT_TEXT(hPos,70,pageWidth,rowHeight,json.goodsList[i].price);
- LODOP.ADD_PRINT_TEXT(hPos,115,pageWidth,rowHeight,json.goodsList[i].count);
- LODOP.ADD_PRINT_TEXT(hPos,140,pageWidth,rowHeight,json.goodsList[i].total);
- hPos+=rowHeight;
- }
- //商品遍历打印完毕,空一行
- hPos+=rowHeight;
- //合计
- LODOP.ADD_PRINT_TEXT(hPos,80,pageWidth,rowHeight,"合计:"+json.totalCount);
- LODOP.ADD_PRINT_TEXT(hPos,130,pageWidth,rowHeight,"¥"+json.total);
-
- hPos+=rowHeight;
- LODOP.ADD_PRINT_TEXT(hPos,2,pageWidth,rowHeight,(new Date()).toLocaleDateString()+" "+(new Date()).toLocaleTimeString())
- hPos+=rowHeight;
- LODOP.ADD_PRINT_TEXT(hPos,25,pageWidth,rowHeight,"谢谢惠顾,欢迎下次光临!");
- //初始化打印页的规格
- LODOP.SET_PRINT_PAGESIZE(3,pageWidth,45,"XXXXX订单信息");
-
- };
- </script>
- </body>
- </html>