Lodop6.1技术手册

WEB打印控件Lodop技术手册Ver 6.1.7.7Email: gungho999@QQ: 932131686梦泰尔软件工作室MTSoftware(CN)目录一、概述 (3)二、系统文件 (4)install_lodop32.exe 和install_lodop64.exe (4)LodopFuncs.js (5)三、控件参数 (7)Caption (7)Color (7)Border (7)四、功能函数 (7)1、基本函数 (8)VERSION (8)PRINT_INIT (8)SET_PRINT_PAGESIZE (8)ADD_PRINT_HTM (9)ADD_PRINT_TABLE (10)ADD_PRINT_URL (12)ADD_PRINT_TEXT (13)ADD_PRINT_IMAGE (14)ADD_PRINT_RECT (14)ADD_PRINT_ELLIPSE (15)ADD_PRINT_LINE (16)ADD_PRINT_BARCODE (17)ADD_PRINT_CHART (18)SET_PRINT_STYLE (19)PREVIEW (21)PRINT (21)PRINT_SETUP (21)PRINT_DESIGN (22)NEWPAGE (22)GET_PRINTER_COUNT (22)GET_PRINTER_NAME (23)SET_PRINTER_INDEX (23)SELECT_PRINTER (24)SET_SHOW_MODE (24)SET_PRINT_MODE (27)SET_PRINT_COPIES (30)SET_PREVIEW_WINDOW (30)ADD_PRINT_SETUP_BKIMG (30)SEND_PRINT_RAWDA TA (31)WRITE_PORT_DA TA (31)READ_PORT_DA TA (32)GET_PRINT_INIFFNAME (32)GET_PAGESIZES_LIST (32)WRITE_FILE_TEXT (33)GET_FILE_TEXT (33)GET_FILE_TIME (34)IS_FILE_EXIST (34)GET_SYSTEM_INFO (34)GET_V ALUE (35)FORMAT (38)GET_DIALOG_V ALUE (40)2、扩展函数 (40)PRINT_INITA (40)ADD_PRINT_HTML (41)ADD_PRINT_TBURL (41)ADD_PRINT_TEXTA (42)SET_PRINT_STYLEA (42)SA VE_TO_FILE (47)SET_SA VE_MODE (47)ADD_PRINT_SHAPE (49)SET_PRINTER_INDEXA (50)NEWPAGEA (50)PREVIEW A (50)PREVIEWB (51)PRINTA (51)PRINTB (51)SHOW_CHART (51)DO_ACTION (52)SET_LICENSES (53)五、软件使用权注册 (53)CompanyName (53)License (54)LicenseA (54)LicenseB (54)六、打印维护和打印设计 (54)七、使用样例 (55)八、计量单位 (55)一、概述Lodop是一款专业的WEB打印控件，其设计目标是简单易用、功能强大且短小精悍，开创WEB打印开发的新局面。

设计者对WEB下的打印需求进行了分类汇总，高度抽象，构思出仅用几个功能函数，就可实现复杂的打印任务，尽量避免由此引起的知识累赘。

控件发布包有3个系统文件组成，主要功能用3个控件参数和2组功能函数来实现。

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

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

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

如果将其复制或改名为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下几乎所有的浏览器。

安装程序文件有几个预定参数：-wait XX该参数设置安装程序运行完毕后自动关闭窗口，这里的XX表示关闭前等待的秒数，如果是0秒则安装（或卸载）成功后立即关闭，例如：–wait8 -nowindow 该参数设置安装程序运行时不出现界面窗口（所谓的静默安装）。

-un 该参数使程序执行卸载操作，优先于文件名。

-in 该参数使程序执行安装操作，优先于文件名。

安装界面如下：LodopFuncs.js该文件是用来引导安装控件的一个JS文件，是个样例，但建议直接采用。

其中getLodop的任务是判断当前浏览器的类型并决定采用哪个对象实例，并检测控件是否安装、是否最新版本、并引导安装或升级。

文件内容如下：function getLodop(oOBJECT,oEMBED){/**************************本函数根据浏览器类型决定采用哪个对象作为控件实例：IE系列、IE内核系列的浏览器采用oOBJECT，其它浏览器(Firefox系列、Chrome系列、Opera系列、Safari系列等)采用oEMBED,对于64位浏览器指向64位的安装程序install_lodop64.exe。

**************************/var strHtmInstall="<br><font color='#FF00FF'>打印控件未安装!点击这里<a href='install_lodop32.exe'>执行安装</a>,安装后请刷新页面或重新进入。

</font>";var strHtmUpdate="<br><font color='#FF00FF'>打印控件需要升级!点击这里<a href='install_lodop32.exe'>执行升级</a>,升级后请重新进入。

</font>";var strHtm64_Install="<br><font color='#FF00FF'>打印控件未安装!点击这里<a href='install_lodop64.exe'>执行安装</a>,安装后请刷新页面或重新进入。

</font>";var strHtm64_Update="<br><font color='#FF00FF'>打印控件需要升级!点击这里<a href='install_lodop64.exe'>执行升级</a>,升级后请重新进入。

</font>";var strHtmFireFox="<br><br><font color='#FF00FF'>注意：<br>1：如曾安装过Lodop旧版附件npActiveXPLugin,请在【工具】->【附加组件】->【扩展】中先卸它。

";var LODOP=oEMBED;var isIE=(erAgent.indexOf('MSIE')>=0) || (erAgent.indexOf('Trident')>=0);var is64IE = isIE && (erAgent.indexOf('x64')>=0);try{if (isIE) LODOP=oOBJECT;if ((LODOP==null)||(typeof(LODOP.VERSION)=="undefined")) {if (erAgent.indexOf('Firefox')>=0){document.documentElement.innerHTML=strHtmFireFox+document.documentElement.innerHTML;};if (is64IE) {document.write(strHtm64_Install);} elseif (isIE) {document.write(strHtmInstall); } else{document.documentElement.innerHTML=strHtmInstall+document.documentElement.innerHTML;};return LODOP;} else if (LODOP.VERSION<"6.1.5.8") {if (is64IE){document.write(strHtm64_Update);} elseif (isIE) {document.write(strHtmUpdate); } else{document.documentElement.innerHTML=strHtmUpdate+document.documentElement.innerHTML; };return LODOP;}//*****如下空白位置适合调用统一功能:*********//*******************************************return LODOP;}catch(err){document.documentElement.innerHTML="Error:"+strHtmInstall+document.documentElement.innerHTML;return LODOP;}}其中的关键点是VERSION函数，Lodop提供了这个“读版本号”功能，这样控件的安装和升级任务就交给JS来实现，以下是控件在页面内的调用代码，其中包含getLodop 的使用：<head><title></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></embed></object></head><body><script language="javascript">var LODOP=getLodop(document.getElementById('LODOP_OB'),document.getElementById('LODOP_EM'));</script>…</body>以上两段代码相互配合实现了Lodop的安装、调用和升级。