Lodop6.1技术手册

Lodop技术手册

WEB打印控件Lodop技术手册

Ver 6.1.5.8

Email: gungho999@sina.com

QQ: 932131686 梦泰尔软件工作室 MTSoftware(CN)

1

Lodop技术手册

目 录

一、概述 ........................................................................................................................................................... 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 .................................................................................................................... 13 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 ....................................................................................................................................... 20 PRINT ............................................................................................................................................. 21 PRINT_SETUP ............................................................................................................................... 21 PRINT_DESIGN ............................................................................................................................. 21 NEWPAGE ...................................................................................................................................... 22 GET_PRINTER_COUNT ............................................................................................................... 22 GET_PRINTER_NAME ................................................................................................................. 22 SET_PRINTER_INDEX ................................................................................................................. 23 SELECT_PRINTER ........................................................................................................................ 24 SET_SHOW_MODE ...................................................................................................................... 24 SET_PRINT_MODE ...................................................................................................................... 27 SET_PRINT_COPIES..................................................................................................................... 29 SET_PREVIEW_WINDOW ........................................................................................................... 30 ADD_PRINT_SETUP_BKIMG ..................................................................................................... 30 SEND_PRINT_RAWDATA ............................................................................................................ 30 WRITE_PORT_DATA .................................................................................................................... 31 READ_PORT_DATA ...................................................................................................................... 31 GET_PRINT_INIFFNAME ............................................................................................................ 32

2

Lodop技术手册

GET_PAGESIZES_LIST ................................................................................................................ 32 WRITE_FILE_TEXT ...................................................................................................................... 32 GET_FILE_TEXT .......................................................................................................................... 33 GET_FILE_TIME ........................................................................................................................... 33 IS_FILE_EXIST .............................................................................................................................. 34 GET_SYSTEM_INFO .................................................................................................................... 34 GET_VALUE .................................................................................................................................. 35 FORMAT ......................................................................................................................................... 37 GET_DIALOG_VALUE ................................................................................................................. 39 2、扩展函数 ........................................................................................................................................... 40

PRINT_INITA ................................................................................................................................. 40 ADD_PRINT_HTML ..................................................................................................................... 40 ADD_PRINT_TBURL .................................................................................................................... 41 ADD_PRINT_TEXTA .................................................................................................................... 41 SET_PRINT_STYLEA ................................................................................................................... 41 SAVE_TO_FILE ............................................................................................................................. 46 SET_SAVE_MODE ........................................................................................................................ 46 ADD_PRINT_SHAPE .................................................................................................................... 48 SET_PRINTER_INDEXA .............................................................................................................. 49 NEWPAGEA ................................................................................................................................... 49 PREVIEWA ..................................................................................................................................... 50 PREVIEWB .................................................................................................................................... 50 PRINTA ........................................................................................................................................... 50 PRINTB ........................................................................................................................................... 50 SHOW_CHART .............................................................................................................................. 51 DO_ACTION .................................................................................................................................. 51 SET_LICENSES ............................................................................................................................. 52

五、软件使用权注册 ..................................................................................................................................... 52

CompanyName ................................................................................................................................ 53 License ............................................................................................................................................ 53 LicenseA.......................................................................................................................................... 53 LicenseB .......................................................................................................................................... 53

六、打印维护和打印设计 ............................................................................................................................. 54 七、使用样例 ................................................................................................................................................. 54 八、计量单位 ................................................................................................................................................. 54

一、概述

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

设计者对WEB下的打印需求进行了分类汇总，高度抽象，构思出仅用几个功能函数，

3

Lodop技术手册

就可实现复杂的打印任务，尽量避免由此引起的知识累赘。控件发布包有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下几乎所有的浏览器。

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

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

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

4

Lodop技术手册

安装界面如下：

LodopFuncs.js

该文件是用来引导安装控件的一个JS文件，是个样例，但建议直接采用。其中getLodop的任务是判断当前浏览器的类型并决定采用哪个对象实例，并检测控件是否安装、是否最新版本、并引导安装或升级。文件内容如下：

function getLodop(oOBJECT,oEMBED){ /**************************

本函数根据浏览器类型决定采用哪个对象作为控件实例： IE系列、IE内核系列的浏览器采用oOBJECT，

其它浏览器(Firefox系列、Chrome系列、Opera系列、Safari系列等)采用oEMBED, 对于64位浏览器指向64位的安装程序install_lodop64.exe。 **************************/

var strHtmInstall=\打印控件未安装!点击这里执行安装,安装后请刷新页面或重新进入。\

var strHtmUpdate=\color='#FF00FF'>打印控件需要升级!点击这里执行升级,升级后请重新进入。\

var strHtm64_Install=\打印控件未安装!点击这里执行安装,安装后请刷新页面或重新进入。\

var strHtm64_Update=\打印控件需要升级!点击这里执行升级,升级后请重新进入。\

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

var LODOP=oEMBED;

var isIE=(navigator.userAgent.indexOf('MSIE')>=0) || (navigator.userAgent.indexOf('Trident')>=0); var is64IE = isIE && (navigator.userAgent.indexOf('x64')>=0);

try{

if (isIE) LODOP=oOBJECT;

if ((LODOP==null)||(typeof(LODOP.VERSION)==\

if (navigator.userAgent.indexOf('Firefox')>=0)

5