WEB 打印控件 Lodop 技术手册

WEB打印控件Lodop技术手册

Ver 6.2.1.5

Email: [email protected]

QQ: 932131686

梦泰尔软件(中国)

MTSoftware(CN)

目 录

一、概述 1

二、系统文件 1

installlodop32.exe **和_** install_lodop64.exe 2

LodopFuncs.js 3

三、控件参数 5

Caption 5

Color 5

Border 5

四、功能函数 6

1、基本函数 6

VERSION 6

PRINT_INIT 7

SET_PRINT_PAGESIZE 8

ADD_PRINT_HTM 9

ADD_PRINT_TABLE 10

ADD_PRINT_URL 11

ADD_PRINT_TEXT 12

ADD_PRINT_IMAGE 13

ADD_PRINT_RECT 14

ADD_PRINT_ELLIPSE 15

ADD_PRINT_LINE 16

ADD_PRINT_BARCODE 17

ADD_PRINT_CHART 19

ADD_PRINT_DATA 21

SET_PRINT_STYLE 21

PREVIEW 22

PRINT 22

PRINT_SETUP 22

PRINT_DESIGN 23

NEWPAGE 23

GET_PRINTER_COUNT 23

GET_PRINTER_NAME 24

SET_PRINTER_INDEX 25

SELECT_PRINTER 25

SET_SHOW_MODE 25

SET_PRINT_MODE 28

SET_PRINT_COPIES 29

SET_PREVIEW_WINDOW 29

ADD_PRINT_SETUP_BKIMG 30

SEND_PRINT_RAWDATA 30

WRITE_PORT_DATA 31

READ_PORT_DATA 32

GET_PRINT_INIFFNAME 32

GET_PAGESIZES_LIST 33

WRITE_FILE_TEXT 33

GET_FILE_TEXT 34

GET_FILE_TIME 34

IS_FILE_EXIST 35

GET_SYSTEM_INFO 36

GET_VALUE 36

FORMAT 38

GET_DIALOG_VALUE 39

2、扩展函数 40

PRINT_INITA 40

ADD_PRINT_HTML 41

ADD_PRINT_TBURL 41

ADD_PRINT_TEXTA 41

SET_PRINT_STYLEA 42

SAVE_TO_FILE 44

SET_SAVE_MODE 45

ADD_PRINT_SHAPE 46

SET_PRINTER_INDEXA 47

NEWPAGEA 47

PREVIEWA 48

PREVIEWB 48

PRINTA 48

PRINTB 49

SHOW_CHART 49

DO_ACTION 50

SET_LICENSES 51

五、软件使用权注册 51

六、打印维护和打印设计 52

七、使用样例 53

八、计量单位 54

一、概述

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

设计者对WEB下的打印需求进行了分类汇总，高度抽象，构思出仅用几个功能函数，就可实现复杂的打印任务，尽量避免由此引起的知识累赘。控件发布包有3个系统文件组成，主要功能用3个控件参数和2组功能函数来实现。

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

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

二、系统文件

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

install_lodop32.exe

install_lodop64.exe

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%安装，对“网页插件安装难”有彻底改善。如果将其复制或改名为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云打印的检测信息。文件主要内容如下：

//===判断是否需要安装CLodop云打印服务器(针对不支持np插件的浏览器)===

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

<head>

以上两段代码相互配合实现了Lodop的安装、调用和升级。之所以将LodopFuncs.js作为一个资源文件来部署，既可以利用浏览器的缓存减少页面内容的重复下载，同时还实现了控件发布统一管理，整个应用系统中只要这一个地方发布Lodop。其它页面直接拷贝嵌入第2段代码就可以了。

三、控件参数

Lodop有如下控件参数,以页面object对象元素的参数形式使用：

Caption

名称：设置控件的显示标题

Color

名称：设置控件的显示区域颜色

Border

名称：设置控件的显示区域边界

四、功能函数

Lodop的功能函数不多，但参数比较复杂。全部函数分“基本函数”和“扩展函数”两类，两类函数有类似性，基本函数使用简单，达不到要求时请使用扩展函数，二者无本质区别。

1、基本函数

VERSION

名称：获得软件版本号

PRINT_INIT

名称：打印初始化

SET_PRINT_PAGESIZE

名称：设定纸张大小

ADD_PRINT_HTM

名称：增加超文本打印项(普通模式)

ADD_PRINT_TABLE

名称：增加表格打印项（超文本模式）

ADD_PRINT_URL

名称：增加超文本打印项（URL模式）

ADD_PRINT_TEXT

名称：增加纯文本打印项

ADD_PRINT_IMAGE

名称：增加图片打印项

ADD_PRINT_RECT

名称：增加矩形线

ADD_PRINT_ELLIPSE

名称：增加椭圆线

ADD_PRINT_LINE

名称：增加直线

ADD_PRINT_BARCODE

名称：增加条形码

ADD_PRINT_CHART

名称：增加图表

ADD_PRINT_DATA

名称：装载文档式模板

SET_PRINT_STYLE

名称：设置打印项风格

PREVIEW

名称：打印预览

PRINT

名称：直接打印

PRINT_SETUP

名称：打印维护

PRINT_DESIGN

名称：打印设计

NEWPAGE

名称：强制分页

GET_PRINTER_COUNT

名称：获得打印设备个数

GET_PRINTER_NAME

名称：获得打印设备名称

SET_PRINTER_INDEX

名称：指定打印设备

SELECT_PRINTER

名称：选择打印设备

SET_SHOW_MODE

名称：设置显示模式
举例一：LODOP. SET_SHOW_MODE("PREVIEW_IN_BROWSE",true);

SET_PRINT_MODE

名称：设置打印模式

SET_PRINT_COPIES

名称：设置打印份数

SET_PREVIEW_WINDOW

名称：设置预览窗口

ADD_PRINT_SETUP_BKIMG

名称：指定背景图

SEND_PRINT_RAWDATA

名称：发送原始数据

WRITE_PORT_DATA

名称：写端口数据

READ_PORT_DATA

名称：读端口数据

GET_PRINT_INIFFNAME

名称：获得配置文件名

GET_PAGESIZES_LIST

名称：获得纸张类型名清单

WRITE_FILE_TEXT

名称：写本地文件内容

GET_FILE_TEXT

名称：读本地文件内容

GET_FILE_TIME

名称：读本地文件时间

IS_FILE_EXIST

名称：判断本地文件是否存在

GET_SYSTEM_INFO

名称：获得系统信息

GET_VALUE

名称：获得数据值

FORMAT

名称：数据格式转换

GET_DIALOG_VALUE

名称：获得对话框结果值

2、扩展函数

PRINT_INITA

名称：(扩展型)打印初始化

ADD_PRINT_HTML

名称：增加超文本打印项(图形模式)

ADD_PRINT_TBURL

名称：(扩展型)增加表格打印项（URL模式）

ADD_PRINT_TEXTA

名称：(扩展型)增加纯文本打印项

SET_PRINT_STYLEA

名称：(扩展型) 设置打印项风格A,继承SET_PRINT_STYLE的所有属性
举例十：LODOP.SET_PRINT_STYLEA(0,'Top','20mm'); //重设值

SAVE_TO_FILE

名称：导出数据到文件

SET_SAVE_MODE

名称：设置保存模式

ADD_PRINT_SHAPE

名称：(扩展型)增加图形

SET_PRINTER_INDEXA

名称：(扩展型)指定打印设备

NEWPAGEA

名称：(扩展型)强制分页

PREVIEWA

名称：(扩展型)打印预览A

PREVIEWB

名称：(扩展型)打印预览B

PRINTA

名称：(扩展型)直接打印A

PRINTB

名称：(扩展型)直接打印B

SHOW_CHART

名称：显示图表

DO_ACTION

名称：控制界面动作

SET_LICENSES

名称：设置软件产品注册信息

五、软件使用权注册

打印控件Lodop是一款专业共享软件，公开发行版本没有功能限制，多数用户可免费长期使用，仅如下功能需要注册使用权：

(不经过预览的)“直接打印”功能；

“导出数据到Excel文件” 功能；

不经注册使用以上功能时，打印输出结果的左下角会出现“本页由【试用版打印控件LodopX.0】输出”小字样水印。

Lodop注册号的价格表、购买方式和使用方法见：说明: C:\Users\ADMINI~1\AppData\Local\Temp\%W@GJ$ACOF(TYDYECOKVDYB.pnghttp://blog.sina.com.cn/s/blog_721e77e50100nfzs.html

六、打印维护和打印设计

打印设计的目标用户是软件开发者，详细功能解释略。

打印设计用到的快捷键：

ctrl 选中；

ctrl + delete 删除；

ctrl + 方向键 移动微调；

ctrl + 鼠标滑动 选中区域内打印项；

ctrl + 打印对象，同时拖拉一个对象就复制了；

打印对象列中按住ALT键的同时拖拉改变对象的顺序位置。

打印维护的目标用户是页面操作者，详细功能解释略。

七、使用样例

演示样例参见发行文件包及其技术手册可从如下地址下载：

http://www.c-lodop.com/download.html或

http://www.mtsoftware.cn/download.html

八、计量单位

本文所述px单位固定换算关系如下,与像素类似但不是一个概念，也不受显示影响：

1in(英寸)=2.54cm(厘米)=25.4mm(毫米)=72pt(磅)=96px

另外一个特殊的计量单位“%(百分比)”，是指相对于纸张大小的百分比值，其中“上、下边距、高度”等的百分比是相对于纸张高度（横向打印时则是宽度）的比值，而“左、右边距和宽度”的百分比是相对于纸张宽度（横向打印时则是高度）的比值。

<完>

results matching ""

    No results matching ""