Lodop技术手册
WEB打印控件Lodop技术手册
Ver 6.2.0.3
Email: gungho999@sina.com
QQ: 932131686 梦泰尔软件(中国) MTSoftware(CN)
1
Lodop技术手册
目 录
一、概述 ........................................................................................................................................................... 4 二、系统文件 ................................................................................................................................................... 4
install_lodop32.exe 和 install_lodop64.exe .................................................................................... 4 LodopFuncs.js ................................................................................................................................... 5
三、控件参数 ................................................................................................................................................... 8
Caption .............................................................................................................................................. 8 Color .................................................................................................................................................. 8 Border ................................................................................................................................................ 9
四、功能函数 ................................................................................................................................................... 9
1、基本函数 ............................................................................................................................................. 9
VERSION.......................................................................................................................................... 9 PRINT_INIT ..................................................................................................................................... 9 SET_PRINT_PAGESIZE ................................................................................................................ 10 ADD_PRINT_HTM ........................................................................................................................ 11 ADD_PRINT_TABLE .................................................................................................................... 12 ADD_PRINT_URL ......................................................................................................................... 13 ADD_PRINT_TEXT....................................................................................................................... 14 ADD_PRINT_IMAGE .................................................................................................................... 15 ADD_PRINT_RECT ...................................................................................................................... 16 ADD_PRINT_ELLIPSE ................................................................................................................. 16 ADD_PRINT_LINE ........................................................................................................................ 17 ADD_PRINT_BARCODE .............................................................................................................. 18 ADD_PRINT_CHART ................................................................................................................... 19 SET_PRINT_STYLE ...................................................................................................................... 20 PREVIEW ....................................................................................................................................... 22 PRINT ............................................................................................................................................. 22 PRINT_SETUP ............................................................................................................................... 23 PRINT_DESIGN ............................................................................................................................. 23 NEWPAGE ...................................................................................................................................... 23 GET_PRINTER_COUNT ............................................................................................................... 24 GET_PRINTER_NAME ................................................................................................................. 24 SET_PRINTER_INDEX ................................................................................................................. 25 SELECT_PRINTER ........................................................................................................................ 25 SET_SHOW_MODE ...................................................................................................................... 26 SET_PRINT_MODE ...................................................................................................................... 28 SET_PRINT_COPIES..................................................................................................................... 31 SET_PREVIEW_WINDOW ........................................................................................................... 31 ADD_PRINT_SETUP_BKIMG ..................................................................................................... 32 SEND_PRINT_RAWDATA ............................................................................................................ 32 WRITE_PORT_DATA .................................................................................................................... 33 READ_PORT_DATA ...................................................................................................................... 33 GET_PRINT_INIFFNAME ............................................................................................................ 33
2
Lodop技术手册
GET_PAGESIZES_LIST ................................................................................................................ 34 WRITE_FILE_TEXT ...................................................................................................................... 34 GET_FILE_TEXT .......................................................................................................................... 35 GET_FILE_TIME ........................................................................................................................... 35 IS_FILE_EXIST .............................................................................................................................. 35 GET_SYSTEM_INFO .................................................................................................................... 36 GET_VALUE .................................................................................................................................. 37 FORMAT ......................................................................................................................................... 40 GET_DIALOG_VALUE ................................................................................................................. 41 2、扩展函数 ........................................................................................................................................... 42
PRINT_INITA ................................................................................................................................. 42 ADD_PRINT_HTML ..................................................................................................................... 43 ADD_PRINT_TBURL .................................................................................................................... 43 ADD_PRINT_TEXTA .................................................................................................................... 44 SET_PRINT_STYLEA ................................................................................................................... 44 SAVE_TO_FILE ............................................................................................................................. 49 SET_SAVE_MODE ........................................................................................................................ 50 ADD_PRINT_SHAPE .................................................................................................................... 51 SET_PRINTER_INDEXA .............................................................................................................. 52 NEWPAGEA ................................................................................................................................... 53 PREVIEWA ..................................................................................................................................... 53 PREVIEWB .................................................................................................................................... 53 PRINTA ........................................................................................................................................... 53 PRINTB ........................................................................................................................................... 54 SHOW_CHART .............................................................................................................................. 54 DO_ACTION .................................................................................................................................. 54 SET_LICENSES ............................................................................................................................. 55
五、软件使用权注册 ..................................................................................................................................... 56 六、打印维护和打印设计 ............................................................................................................................. 57 七、使用样例 ................................................................................................................................................. 58 八、计量单位 ................................................................................................................................................. 59
3
Lodop技术手册
一、概述
Lodop是一款专业的WEB打印控件，其设计目标是简单易用、功能强大且短小精悍，开创WEB打印开发的新局面。
设计者对WEB下的打印需求进行了分类汇总，高度抽象，构思出仅用几个功能函数，就可实现复杂的打印任务，尽量避免由此引起的知识累赘。控件发布包有3个系统文件组成，主要功能用3个控件参数和2组功能函数来实现。
尽管Lodop有个理想化的目标，那就是不用详细了解这些参数或函数，仅仅看懂几
个样例就能很轻松地开始使用，控件为此提供了一个足够完善的设计界面，用它可以实现大多数打印开发任务，但事实上深入了解这些参数和函数总是有好处的，特别是当您的开发任务很复杂时，这就是本文目的，但愿本文档足够详细且简单明了。
如果此前曾看过lodop发行包里的入门样例，本文会更容易理解。
二、系统文件
Lodop发布包内主要有如下三个安装文件：
1. install_lodop32.exe 2. install_lodop64.exe
3. CLodopPrint_Setup_for_Win32NT.exe
前两个是打印控件安装文件，第三个是云打印服务安装文件。建议页面综合部署，即部分浏览器采用控件，另外浏览器采用云打印，该选择过程由LodopFuncs.js里的needCLodop();引导实现。C-Lodop云打印32位安装文件可以适用于32位或64位操作系统，更详细的安装使用请参考《云打印C-Lodop技术手册》。
下载地址：http://www.c-lodop.com/download.html
install_lodop32.exe 和 install_lodop64.exe
这俩文件是lodop控件安装和升级的主程序文件，其中install_lodop32.exe适用于32位浏览器，install_lodop64.exe适用于64位浏览器，提供给用户或开发者下载安装，如果不特意拦截一般都能100%安装，对“网页插件安装难”有彻底改善。如果将
4
Lodop技术手册
其复制或改名为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 该参数使程序执行安装操作，优先于文件名。
安装界面如下：
LodopFuncs.js
该文件是用来引导安装控件的一个JS文件，是个样例，但建议直接采用。其中getLodop的任务是判断当前浏览器的类型并决定采用哪个对象实例，并检测控件是否安装、是否最新版本、并引导安装或升级，加入了兼容C-Lodop云打印的检测信息。文件主要内容如下：
5