Lodop5.0技术手册

WEB打印控件Lodop技术手册

Ver 5.0.5.5

Email: gungho999@sina.com

QQ: 932131686

1

目 录

一、概述 ........................................................................................................................................................... 3 二、系统文件 ................................................................................................................................................... 4

install_lodop.exe ............................................................................................................................... 4 CheckActivX.js ................................................................................................................................. 4 npActiveXFirefox4x.xpi.................................................................................................................... 5

三、控件参数 ................................................................................................................................................... 5

Caption .............................................................................................................................................. 5 Color .................................................................................................................................................. 6 Border ................................................................................................................................................ 6

四、功能函数 ................................................................................................................................................... 6

1、基本函数 ............................................................................................................................................. 6

VERSION.......................................................................................................................................... 6 PRINT_INIT ..................................................................................................................................... 7 SET_PRINT_PAGESIZE .................................................................................................................. 7 ADD_PRINT_HTM .......................................................................................................................... 8 ADD_PRINT_TABLE ...................................................................................................................... 9 ADD_PRINT_URL ......................................................................................................................... 10 ADD_PRINT_TEXT....................................................................................................................... 11 ADD_PRINT_IMAGE .................................................................................................................... 11 ADD_PRINT_RECT ...................................................................................................................... 12 ADD_PRINT_ELLIPSE ................................................................................................................. 13 ADD_PRINT_LINE ........................................................................................................................ 14 ADD_PRINT_BARCODE .............................................................................................................. 14 ADD_PRINT_CHART ................................................................................................................... 15 SET_PRINT_STYLE ...................................................................................................................... 16 NEWPAGE ...................................................................................................................................... 18 PREVIEW ....................................................................................................................................... 18 PRINT ............................................................................................................................................. 19 PRINT_SETUP ............................................................................................................................... 19 PRINT_DESIGN ............................................................................................................................. 19 GET_PRINTER_COUNT ............................................................................................................... 19 GET_PRINTER_NAME ................................................................................................................. 20 SET_PRINTER_INDEX ................................................................................................................. 20 SELECT_PRINTER ........................................................................................................................ 20 SET_SHOW_MODE ...................................................................................................................... 21 SET_PRINT_MODE ...................................................................................................................... 23 SET_PREVIEW_WINDOW ........................................................................................................... 23 ADD_PRINT_SETUP_BKIMG ..................................................................................................... 24 SEND_PRINT_RAWDATA ............................................................................................................ 24 WRITE_PORT_DATA .................................................................................................................... 25 READ_PORT_DATA ...................................................................................................................... 25 GET_PRINT_INIFFNAME ............................................................................................................ 25

2

WRITE_FILE_TEXT ...................................................................................................................... 26 GET_FILE_TEXT .......................................................................................................................... 26 GET_FILE_TIME ........................................................................................................................... 27 IS_FILE_EXIST .............................................................................................................................. 27 GET_SYSTEM_INFO .................................................................................................................... 27 2、扩展函数 ........................................................................................................................................... 28

PRINT_INITA ................................................................................................................................. 28 ADD_PRINT_HTML ..................................................................................................................... 29 ADD_PRINT_TBURL .................................................................................................................... 29 ADD_PRINT_TEXTA .................................................................................................................... 30 SET_PRINT_ STYLEA .................................................................................................................. 30 SAVE_TO_FILE ............................................................................................................................. 32 SET_SAVE_MODE ........................................................................................................................ 32 SET_PRINT_TEXT_STYLEA ....................................................................................................... 34 ADD_PRINT_SHAPE .................................................................................................................... 34 SET_PRINTER_INDEXA .............................................................................................................. 35 PREVIEWA ..................................................................................................................................... 36 PREVIEWB .................................................................................................................................... 36 PRINTA ........................................................................................................................................... 36 PRINTB ........................................................................................................................................... 36 SHOW_CHART .............................................................................................................................. 37 SET_LICENSES ............................................................................................................................. 37

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

CompanyName ................................................................................................................................ 38 License ............................................................................................................................................ 38 LicenseA.......................................................................................................................................... 38 LicenseB .......................................................................................................................................... 38

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

一、概述

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

Lodop设计者对WEB下的打印开发任务进行了分类汇总，高度抽象，设计出仅用几个功能函数，就可实现复杂的打印任务，尽量减少使用者的知识累赘。控件发布包有3个系统文件组成，全部功能用几个控件参数和2组功能函数来实现。

尽管我们有个理想化的目标，那就是您不用详细了解这些参数或函数，仅仅看懂几个

3

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

如果此前曾看过lodop的入门样例程序，本文会更容易理解！

二、系统文件

Lodop发布包内主要有如下三个文件：

install_lodop.exe

该文件是控件安装和升级的主文件，提供给用户或开发者下载安装，如果不特意拦截一般都能100%安装，对“网页插件安装难”有一定改善。如果将其复制或改名为uninstall_lodop.exe (名前加un)就可用其卸载控件。

Lodop安装后，在操作系统目录WINDOWS\\system32下会安装一个OCX文件：CAOSOFT_WEB_PRINT_LODOP.OCX，有特殊需要的使用者可以将该文件自主签名，用传统的OCX安装方式发布。

CheckActivX.js

该文件是用来引导安装控件的一个JS文件，是个样例，但建议直接采用。其中CheckLodop的任务是检查控件是否安装、是否最新版本、并引导安装或升级。文件内容如下：

function CheckLodop(){

var oldVersion=LODOP.Version; newVerion=\ if (oldVersion==null){

document.write(\打印控件未安装!点击这里执行if (navigator.appName==\

document.write(\color='#FF00FF'>（Firefox浏览器用户需先点击这里,安装后请刷新页面。\

npActiveXFirefox4x.xpi'>安装运行环境）\ } else if (oldVersion

document.write(\打印控件需要升级!点击这里执行升级,升级后请重新进入。\

4

}

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