WEB打印控件Lodop技术手册

痛定思痛。 2022-05-17 13:09 1155阅读 0赞

**W****EB打印控件****Lodop****技术手册**

**目****  ****  ****  ****录**

一、概述 1

二、系统文件 1

install\_lodop32.exe 和 install\_lodop64.exe 1

LodopFuncs.js 2

三、控件参数 6

Caption 6

Color 6

Border 6

四、功能函数 7

1、基本函数 7

VERSION 7

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 14

ADD\_PRINT\_LINE 15

ADD\_PRINT\_BARCODE 16

ADD\_PRINT\_CHART 17

ADD\_PRINT\_DATA 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 24

SELECT\_PRINTER 24

SET\_SHOW\_MODE 24

SET\_PRINT\_MODE 27

SET\_PRINT\_COPIES 30

SET\_PREVIEW\_WINDOW 30

ADD\_PRINT\_SETUP\_BKIMG 31

SEND\_PRINT\_RAWDATA 31

WRITE\_PORT\_DATA 32

READ\_PORT\_DATA 33

GET\_PRINT\_INIFFNAME 33

GET\_PAGESIZES\_LIST 33

WRITE\_FILE\_TEXT 34

GET\_FILE\_TEXT 34

GET\_FILE\_TIME 35

IS\_FILE\_EXIST 35

GET\_SYSTEM\_INFO 35

GET\_VALUE 36

FORMAT 39

GET\_DIALOG\_VALUE 41

2、增强函数 42

PRINT\_INITA 42

ADD\_PRINT\_HTML 43

ADD\_PRINT\_TBURL 43

ADD\_PRINT\_TEXTA 43

SET\_PRINT\_STYLEA 44

SAVE\_TO\_FILE 49

SET\_SAVE\_MODE 49

ADD\_PRINT\_SHAPE 51

SET\_PRINTER\_INDEXA 52

NEWPAGEA 52

PREVIEWA 53

PREVIEWB 53

PRINTA 53

PRINTB 54

SHOW\_CHART 54

DO\_ACTION 54

SET\_LICENSES 55

五、软件使用权注册 56

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

七、使用样例 58

八、计量单位 59

# **一、概述** #

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

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

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

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

# **二、系统文件** #

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

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

<table style="width:469.75pt;"> 
 <tbody> 
 <tr> 
 <td style="background-color:#f3f3f3;width:469.75pt;"> //===判断是否需要安装CLodop云打印服务器(针对不支持np插件的浏览器)=== function needCLodop(){ &nbsp;&nbsp;&nbsp;&nbsp;try{ var ua=navigator.userAgent; if (ua.match(/Windows\sPhone/i) !=null) return true; if (ua.match(/iPhone|iPod/i) != null) return true; if (ua.match(/Android/i) != null) return true; if (ua.match(/Edge\D?\d+/i) != null) return true; if (ua.match(/QQBrowser/i) != null) return false; var verTrident=ua.match(/Trident\D?\d+/i); var verIE=ua.match(/MSIE\D?\d+/i); var verOPR=ua.match(/OPR\D?\d+/i); var verFF=ua.match(/Firefox\D?\d+/i); var x64=ua.match(/x64/i); if ((verTrident==null)&amp;&amp;(verIE==null)&amp;&amp;(x64!==null)) return true; else if ( verFF !== null) { verFF = verFF[0].match(/\d+/); if ( verFF[0] &gt;= 42 ) return true; } else if ( verOPR !== null) { verOPR = verOPR[0].match(/\d+/); if ( verOPR[0] &gt;= 32 ) return true; } else if ((verTrident==null)&amp;&amp;(verIE==null)) { var verChrome=ua.match(/Chrome\D?\d+/i); if ( verChrome !== null ) { verChrome = verChrome[0].match(/\d+/); if (verChrome[0]&gt;=42) return true; }; }; &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;return false; &nbsp;&nbsp;&nbsp;&nbsp;} catch(err) {return true;}; }; … //====获取LODOP对象的主过程：==== function getLodop(oOBJECT,oEMBED){ &nbsp;&nbsp;&nbsp;… &nbsp;&nbsp;&nbsp;&nbsp;var LODOP; &nbsp;&nbsp;&nbsp;&nbsp;try{ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;… &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;if (LODOP.VERSION&lt;"6.2.0.3") { &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;if (needCLodop()) &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;document.documentElement.innerHTML=strCLodopUpdate+document.documentElement.innerHTML; else &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;if (is64IE) document.write(strHtm64_Update); else &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;if (isIE) document.write(strHtmUpdate); else &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;document.documentElement.innerHTML=strHtmUpdate+document.documentElement.innerHTML; &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;return LODOP; &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;}; &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;//===如下空白位置适合调用统一功能(如注册语句、语言选择等):=== &nbsp; &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;//=========================================================== &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;return LODOP; &nbsp;&nbsp;&nbsp;&nbsp;} catch(err) {alert("getLodop出错:"+err);}; }; </td> 
 </tr> 
 </tbody> 
</table>

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

<table style="width:469.75pt;"> 
 <tbody> 
 <tr> 
 <td style="background-color:#f3f3f3;width:469.75pt;"> &lt;head&gt; &lt;title&gt;&lt;/title&gt; &lt;script language="javascript" src="LodopFuncs.js"&gt;&lt;/script&gt; &lt;object&nbsp; id="LODOP_OB" classid="clsid:2105C259-1E0C-4534-8141-A753534CB4CA" width=0 height=0&gt;&nbsp; &lt;embed id="LODOP_EM" type="application/x-print-lodop" width=0 height=0&gt;&lt;/embed&gt; &lt;/object&gt; &lt;/head&gt; &lt;body&gt; &lt;script language="javascript"&gt;&nbsp; var LODOP=getLodop(document.getElementById('LODOP_OB'),document.getElementById('LODOP_EM')); &lt;/script&gt; … &lt;/body&gt; </td> 
 </tr> 
 </tbody> 
</table>

以上两段代码相互配合实现了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** ###

### **ADD\_PRINT\_TEXT** ###

### **ADD\_PRINT\_IMAGE** ###

### **ADD\_PRINT\_RECT** ###

### **ADD\_PRINT\_ELLIPSE** ###

### **ADD\_PRINT\_LINE** ###

### **ADD\_PRINT\_BARCODE** ###

### **ADD\_PRINT\_CHART** ###

### **ADD\_PRINT\_DATA** ###

<table style="margin-left:-3.6pt;width:473.35pt;"> 
 <tbody> 
 <tr> 
 <td style="background-color:#f3f3f3;width:473.35pt;"> 名称：装载文档式模板 格式： ADD_PRINT_ DATA (strDataStyle, varDataValue) 功能：直接装载文档式模板。&nbsp;Lodop传统模板可以称为“JS语句组式模板”， 传统模板需要JS的eval方法来装载，“文档式模板”不再依赖该方法，直接用Lodop的语句ADD_PRINT_DATA就可装载复用 参数： strDataStyle： 字符型，如下是类型名及其含义： ProgramData----加载文档式模板关键字。 varDataValue： 文档式模板内容。文档式模板内容是特殊格式的BASE64字符，符合该编码集范畴，容易保存和网络传递 结果：无 建议或要求： 要求在初始化之后，打印或预览之前调用。 文档式模板使用相关语句信息： 
 <ol> 
 <li>获得模板信息，语句如下：</li> 
 </ol>GET_VALUE (ValueType, ValueIndex); ValueType：获得文档式模板关键字是“ProgramData”; intModeValue&nbsp;0-全部模板;1-不包含初始化语句的模板。 &nbsp;（详细解释参考基本函数GET_VALUE） 
 <ol> 
 <li>文档式模板执行后，给打印对象赋值，语句如下： </li> 
 </ol>SET_PRINT_STYLEA(varItemNameID, strStyleName,varStyleValue); strStyleName：关键字参数值是“CONTENT”（详细解释参考基本函数SET_PRINT_STYLEA）。 举例：LODOP.ADD_PRINT_&nbsp;DATA (ProgramData,"&nbsp;@J0yHEH1QG1IBIS0APy&nbsp;…...&nbsp;GHIBES0APt==");// (省略…..). &nbsp; </td> 
 </tr> 
 </tbody> 
</table>

### **SET\_PRINT\_STYLE** ###

### **PREVIEW** ###

### **PRINT** ###

### **PRINT\_SETUP** ###

### **PRINT\_DESIGN** ###

### **NEWPAGE** ###

### **GET\_PRINTER\_COUNT** ###

### **GET\_PRINTER\_NAME** ###

### **SET\_PRINTER\_INDEX** ###

### **SELECT\_PRINTER** ###

### **SET\_SHOW\_MODE** ###

<table style="margin-left:-3.6pt;width:429.7pt;"> 
 <tbody> 
 <tr> 
 <td style="background-color:#f3f3f3;width:429.7pt;"> 名称：设置显示模式 格式： SET_SHOW_MODE(strModeType,varModeValue) 功能：设置打印预览、打印维护和打印设计的显示模式，设置打印预览时是否包含背景图等。 参数： strModeType显示模式的名称，字符型，如下是类型名及其含义：<a rel="nofollow"></a> “PREVIEW_IN_BROWSE”：打印预览界面是否内嵌到网页内部。 “SETUP_IN_BROWSE”：&nbsp;&nbsp;打印维护界面是否内嵌到网页内部。 “DESIGN_IN_BROWSE”：&nbsp;打印设计界面是否内嵌到网页内部。 “BKIMG_IN_PREVIEW”：<a rel="nofollow"></a>&nbsp;打印预览时是否包含背景图。 “BKIMG_IN_FIRSTPAGE”：打印预览时是否仅首页包含背景图。 “SETUP_ENABLESS”：打印维护界面工具显示控制（权限控制字串） “SKIN_TYPE”：界面皮肤类型 “SKIN_CUSTOM_COLOR”：界面自定义皮肤颜色 “HIDE_PBUTTIN_PREVIEW”：隐藏预览窗口的打印按钮 “HIDE_SBUTTIN_PREVIEW”：隐藏预览窗口的打印设置按钮 “HIDE_QBUTTIN_PREVIEW”：隐藏预览窗口的关闭按钮 “HIDE_PBUTTIN_SETUP”：隐藏打印维护及设计窗口的打印按钮 “HIDE_VBUTTIN_SETUP”：隐藏打印维护及设计窗口的预览按钮 “HIDE_ABUTTIN_SETUP”：隐藏打印维护及设计窗口的应用（暂存）按钮 “HIDE_RBUTTIN_SETUP”：隐藏打印维护及设计窗口的复原按钮 “MESSAGE_GETING_URL”：URL对象下载时的提示信息 “MESSAGE_PARSING_URL”：URL对象解析时的提示信息 “MESSAGE_PARSING_HTM”：HTM对象解析时的提示信息 “MESSAGE_NOSET_PROPERTY”：打印维护界面企图进入属性设置的警示信息 “HIDE_PAPER_BOARD”：隐藏打印预览背景进纸版的图案 “LANDSCAPE_DEFROTATED”：横向打印的预览默认旋转90度（正向显示） “BKIMG_LEFT”：设置背景图位置X值 “BKIMG_TOP”：设置背景图位置Y值 “BKIMG_WIDTH”：设置背景图宽度 “BKIMG_HEIGHT”：设置背景图高度 “HIDE_PAGE_PERCENT”：隐藏整页缩放(百分比)的下拉选择框 “LANGUAGE”：设置界面文字的语言 “HIDE_DISBUTTIN_SETUP”隐藏打印维护窗口那些已经禁止操作的无效按钮 “PREVIEW_NO_MINIMIZE”设置预览窗口禁止最小化，并始终在各个窗口的最前面 “BKIMG_PRINT”：设置打印时是否包含背景图。 “BKIMG_PRINT_FIRSTPAGE”：设置打印时是否仅首页包含背景图。 “HIDE_ITEM_LIST”：设置设计界面、维护界面的对象列表默认为“关闭状态”（合上）。 “TEXT_SHOW_BORDER”：设置设计界面的字符编辑框border的默认显示类型。 “HIDE_TOOLS_DESIGN”:&nbsp;隐藏打印设计或打印维护界面上的工具条。 “HIDE_GROUND_LOCK”：隐藏打印设计或打印维护界面上的纸钉按钮。 “SHOW_SCALEBAR”：设置是否在打印设计界面和预览界面显示标尺。 “NP_NO_RESULT”：设置NP插件无返回，这可避免chrome（谷歌）等np插件浏览器对弹窗超时误报崩溃。注意： 1. 作用：预览或打印不再返回结果，不再等待从而避免浏览器的响应超时警告，如需要返回结果则不能用本函数； 2. 影响的浏览器：支持np插件的所有浏览器，如Firefox(火狐)系列、Chrome(谷歌)系列、Opera系列、Safari系列等等，而IE系列或以IE为内核的浏览器则不受影响。 3.具体影响的函数：PREVIEW; PREVIEWA; PREVIEWB;PRINT; PRINTA; PRINTB; PRINT_DESIGN; PRINT_SETUP。 varModeValue显示模式的值，整数或字符型，相关值如下： PREVIEW_IN_BROWSE的值：整数或字符型，1或true=是,否则不是。 SETUP_IN_BROWSE的值：整数或字符型，1或true=是,否则不是。 DESIGN_IN_BROWSE的值：整数或字符型，1或true=是,否则不是。 BKIMG_IN_PREVIEW的值：整数或字符型，1或true=是,否则不是。 BKIMG_IN_FIRSTPAGE的值：整数或字符型，1或true=是,否则不是。 SETUP_ENABLESS的值：字符型，由“1”和“0”组成的字符串，最多14个字符， 按如下顺序控制打印维护的界面功能，“1”-允许，“0”-禁止： 位置移动和宽高调整1+颜色选择2+字体名选择3+字大小选择4+旋角调整5+粗斜体功能条6+线型功能条7+对齐功能条8+删除功能9+页眉设置10+页脚设置11+位置锁定功能（边距锁定或居中）12+&nbsp;属性设置13+显示关闭钮（界面内嵌时）14 缺省的SETUP_ENABLESS值：“11111111000001” 例如：如想允许操作者“删除”对象，可以执行如下语句; LODOP.SET_SHOW_MODE("SETUP_ENABLESS","11111111100001"); SKIN_TYPE的值：数字型，固定皮肤如下： 0--银灰色(缺省)；1--经典绿; 2--熏衣草紫；3--淡钢青；4--茶色棕；5--茶色棕； 6--麦色；7--紫罗兰；8--天蓝；9--镀银；10--沙滩棕；11--鲜肉色；12--粉末蓝；13--钒矿色； 14--浅绿；15--浅蓝；16--卡其布； 17--秋麒麟；18--深海绿；19--深卡其布；20--番茄桔 SKIN_CUSTOM_COLOR的值：整数或字符型，整数时是颜色的十进制RGB值；字符时是超文本颜色值，可以是“#”加三色16进制值组合，也可以是英文颜色名。 HIDE_PBUTTIN_PREVIEW的值：整数或字符型，1或true=是,否则不是。 HIDE_SBUTTIN_PREVIEW的值：整数或字符型，1或true=是,否则不是。 HIDE_QBUTTIN_PREVIEW的值：整数或字符型，1或true=是,否则不是。 HIDE_PBUTTIN_SETUP的值：整数或字符型，1或true=是,否则不是。 HIDE_VBUTTIN_SETUP的值：整数或字符型，1或true=是,否则不是。 HIDE_ABUTTIN_SETUP的值：整数或字符型，1或true=是,否则不是。 HIDE_RBUTTIN_SETUP的值：整数或字符型，1或true=是,否则不是。 MESSAGE_GETING_URL的值：字符型，默认值是“正打开页面下载数据(限时5分钟)...”,当设置该值为空时则隐藏提示。 MESSAGE_PARSING_URL的值：字符型，默认值是“下载结束,正在准备打印数据...”，当设置该值为空时则隐藏提示。 MESSAGE_PARSING_HTM的值：字符型，默认值是空（不提示信息），当超文本内容较多，有明显等待时间时，建议设置该值。 MESSAGE_NOSET_PROPERTY的值：字符型，默认值是“只有在设计模式下才能设置属性...”。 HIDE_PAPER_BOARD的值：整数或字符型，1或true=是,否则不是。 LANDSCAPE_DEFROTATED的值：整数或字符型，1或true=是,否则不是。 BKIMG_LEFT的值：整数或字符型。整数的单位是PX，字符时可以包含具体计量单位。 BKIMG_TOP的值：同上； BKIMG_WIDTH的值：同上； BKIMG_HEIGHT的值：同上； HIDE_PAGE_PERCENT的值：整数或字符型，1或true=是,否则不是。 LANGUAGE的值：数字，0-简体中文 1-英文 2-繁体 3-BIG5(繁体) HIDE_DISBUTTIN_SETUP的值：整数或字符型，1或true=是,否则不是。 PREVIEW_NO_MINIMIZE的值：整数或字符型，1或true=是,否则不是。 BKIMG_PRINT的值：整数或字符型，1或true=是,否则不是。 BKIMG_PRINT_FIRSTPAGE的值：整数或字符型，1或true=是,否则不是。 HIDE_ITEM_LIST的值：整数或字符型，1或true=是。 设置对象列表默认为关闭或打开状态，不执行本语句时，Lodop会根据对象个数自动判断是否有必要打开。该语句比操作者手工改变的优先级要低，也就是人工可以通过界面选择是否关闭对象列表，手工操作会覆盖本语句效果。 TEXT_SHOW_BORDER的值：数字，具体值及边框样式： 0--&nbsp;3D效果&nbsp;&nbsp;&nbsp;&nbsp;1--单线(single)&nbsp;&nbsp;&nbsp;&nbsp;2--无边框(none) 该语句比操作者手工改变的优先级要低，也就是后者能改变这个语句效果。 HIDE_TOOLS_DESIGN的值：整数或字符型，1或true=是,否则不是。 HIDE_GROUND_LOCK的值：整数或字符型，1或true=是,否则不是。 SHOW_SCALEBAR的值：整数或字符型，1或true=是,否则不是。 NP_NO_RESULT的值：整数或字符型，1或true=是,否则不是。 &nbsp; 结果：返回逻辑结果，成功时返回真，失败时返回假。 建议或要求： 初始化之后，进入功能（打印预览、打印维护或打印设计）界面前调用本函数。 </td> 
 </tr> 
 <tr> 
 <td style="background-color:#f3f3f3;width:429.7pt;"> 举例一：LODOP. SET_SHOW_MODE("PREVIEW_IN_BROWSE",true); 举例二：LODOP. SET_SHOW_MODE("BKIMG_IN_PREVIEW",1); 举例三：LODOP. SET_SHOW_MODE("HIDE_PAPER_BOARD ",true); 举例四：LODOP.SET_SHOW_MODE("NP_NO_RESULT",true);//设置NP插件无返回，这可避免chrome（谷歌）对弹窗超时误报崩溃。 </td> 
 </tr> 
 </tbody> 
</table>

### **SET\_PRINT\_MODE** ###

### **SET\_PRINT\_COPIES** ###

### **SET\_PREVIEW\_WINDOW** ###

### **ADD\_PRINT\_SETUP\_BKIMG** ###

### **SEND\_PRINT\_RAWDATA** ###

### **WRITE\_PORT\_DATA** ###

<table style="margin-left:-3.6pt;width:451.85pt;"> 
 <tbody> 
 <tr> 
 <td style="background-color:#f3f3f3;width:451.85pt;"> 名称：写端口数据 格式：WRITE_PORT_DATA(strPortName,strData) 功能：直接向端口写数据或指令。 参数： strPortName：本地端口或远端端口名， 指向本地端口时，该名称类似如下： LPT1、LPT2、LPT3、COM1、COM2、COM3… 指向远程端口时，该名称类似如下： “HOST:192.168.1.6;&nbsp;PORT:9100;CHARSET:UTF-8;TIMEOUT:5000”&nbsp;，其中“HOST:”是关键字,必须用其开头，可设置的内容项有四个：HOST(设置远程主机IP)，PORT(远程主机端口)，CHARSET(数据字符集)和TIMEOUT(写超时的毫秒数)。内容项之间用分号隔开。 &nbsp; strData：数据或指令值，字符型，未限制长度。 &nbsp; &nbsp; 当设置端口通讯参数时strData格式如下： mode com1:波特率,校验,数据位,停止位,读时限,写时限 其中mode为固定关键字，com1要和strPortName保持一直。 校验值有：N(noparity) O(oddparity)&nbsp;E(evenparity) M(markparity) S(spaceparity) 读时限和写时限的时间单位为毫秒。 结果：<a rel="nofollow">返回逻辑结果，</a>发送成功时返回真，发送失败时返回假。 建议或要求： 任何时间调用。 举例一：LODOP.WRITE_PORT_DATA("COM1", "mode com1:2400,n,8,1"); 举例二：LODOP.WRITE_PORT_DATA("COM2", " mode com2:2400,n,7,2,5000,2000"); 举例三： LODOP.WRITE_PORT_DATA("HOST:192.168.1.99;PORT:9100;CHARSET:UTF-8;TIMEOUT:5000", &nbsp;"^XA\n^FO50,50\n^BY3^BCN,100,Y,N,N\n^FD&gt;;382436&gt;6CODE39&gt;752375152^FS\n^XZ\n"); </td> 
 </tr> 
 </tbody> 
</table>

### ** READ\_PORT\_DATA** ###

<table style="margin-left:-3.6pt;width:431.3pt;"> 
 <tbody> 
 <tr> 
 <td style="background-color:#f3f3f3;width:431.3pt;"> 名称：读端口数据 格式：READ_PORT_DATA(strPortName) 功能：直接从端口读数据，其参数可以用换行符附加通讯参数等数据，从而实现用单个语句对串口设置通讯参数后先写数据，停顿一定毫秒后再读。 参数： strPortName：端口名，同操作系统的端口名，名称如下： LPT1、LPT2、LPT3、COM1、COM2、COM3… 结果：返回字符数据。 建议或要求： 任何时间调用。 举例一：var strResult=LODOP. READ_PORT_DATA("COM1"); 举例二： LODOP.READ_PORT_DATA("COM1\nmode com1:2400,n,8,1,2000,1000\nSleep:200\nIamGoodMan"); (注意\n是换行符) </td> 
 </tr> 
 </tbody> 
</table>

### **GET\_PRINT\_INIFFNAME** ###

### **GET\_PAGESIZES\_LIST** ###

### **WRITE\_FILE\_TEXT** ###

### **GET\_FILE\_TEXT** ###

### **GET\_FILE\_TIME** ###

### **IS\_FILE\_EXIST** ###

### **GET\_SYSTEM\_INFO** ###

### **GET\_VALUE** ###

<table style="margin-left:-3.6pt;width:429.7pt;"> 
 <tbody> 
 <tr> 
 <td style="background-color:#f3f3f3;width:429.7pt;"> 名称：获得数据值&nbsp; 格式：GET_VALUE(ValueType, ValueIndex) 功能：获得程序代码、打印项属性等数据值。 参数：ValueType： 数据值类型，字符型，如下是类型名及其含义： ItemCount&nbsp;----打印项个数 ItemCountHS&nbsp;----打印项历史个数（包含已经删除的对象个数） ItemTop&nbsp;----打印项上边距 ItemLeft ----打印项左边距 ItemWidth ----打印项宽度 ItemHeight ----打印项高度 ItemContent ----打印项内容 ItemClass----打印项的对象类别 ItemClassName ----打印项的对象类别名 ItemPageType ----打印项的对象类型 ItemName ----打印项的对象类名(用来对单个或多个识别) ItemNameID ----打印项的对象识别序号(排除已删除对象后的序号，单个识别) ItemIndex----该打印项物理序号(含已删除对象的序号) ItemFontName ----打印项字体名称 ItemFontSize ----打印项字体大小 ItemColor ----打印项字体颜色 ItemAlign ----打印项靠齐方式 Itembold ----打印项是否粗体 ItemItalic ----打印项是否斜体 ItemUnderline ----打印项是否下划线 ItemPenWidth ----打印项线条宽度 ItemPenStyle - ---打印项线条类型 ItemHorient ----打印项左右位置 ItemVorient ----打印项上下位置 ItemAngle ----打印项旋转角度 ItemStretch ----打印项的图片缩放模式 ItemReadOnly ----打印项的打印维护内容只读 ItemPreviewOnly ----打印项是否仅预览 ItemPageIndex ----打印项的目标输出页号 ItemNumberStartPage ----打印项的页号起始页号 ItemStartNumberValue ----打印项页号起始值 ItemLineSpacing ----打印项行间距 ItemLetterSpacing&nbsp;----打印项字间距 ItemExist ----该打印项是否存在，增加又删除也算不存在。 ItemIsAdded&nbsp;----该打印项是否被增加过，被删除也算增加过。 ItemIsDeleted&nbsp;----该打印项是否增加过且已被删除； &nbsp;其中 ItemExist、ItemIsAdded、ItemIsDeleted一般用项目名来判断，不适合用序号。 ItemGroundColor(或ItembackWallColor或GroundColor)----该打印项的背景色 ItemShowBarText&nbsp;----该条码打印项是否显示条码文字 ItemQRCodeVersion----该打印项QRCode版本号 ItemTextFrame&nbsp;----该打印项边框类型 ItemSpacePatch&nbsp;----该打印项文本尾是否补空格 ItemAlignJustify&nbsp;----该打印项文本两端是否靠齐 ItemTranscolor&nbsp;----该打印项图片透明背景色 ItemTop2Offset&nbsp;----该打印项次页上边距偏移 ItemLeft2Offset&nbsp;----该打印项次页左边距偏移 ItemTableHeightScope&nbsp;----该打印项表格高是否含头脚 ItemLinkedItem&nbsp;----该打印项的关联对象的类名（或识别号） ItemLinknewpage&nbsp;----该打印项在关联顺序打印时是否在空间不足时“从新页开始” ItemSelected&nbsp;----该打印项是否被选中 ItemHtmWaitMilSecs&nbsp;----该（超文本）打印项下载时间附加延迟毫秒数 BKIMG_CONTENT----背景图地址 BKIMG_LEFT----背景图的X坐标(显示px) BKIMG_TOP----背景图的Y坐标(显示px) BKIMG_WIDTH----背景图的宽度(显示px) BKIMG_HEIGHT----背景图的高度(显示px) PrintInitTop&nbsp;----整体上边距 PrintInitLeft ----整体左边距 PrintInitWidth&nbsp;----编辑区宽度 PrintInitHeight&nbsp;----编辑区高度 PrintTaskName&nbsp;----打印任务的名称 PRINTED_TIMES或PRINTEDTIMES&nbsp;---当前内容已打印次数(打印设计、维护和预览界面内嵌时)&nbsp; PREVIEW_PAGE_NUMBER----打印预览界面内嵌时，获得当前页号 PREVIEW_ZOOM_STATE----打印预览界面内嵌时，获得显示缩放代码 代码值含义如下： 0--适高 1--适宽 2--缩25% 3--缩50% 4--缩75% 5--正常 6--放150% 7--放200% 8--放300% 9--放500% PREVIEW_PERCENT----打印预览界面内嵌时，获得缩放打印比例，该代码及其含义参考函数DO_ACTION中同名参数的说明。 PREVIEW _ PRINTEDTIMES----打印预览界面内嵌时，获得被打印次数 PRINTSETUP_PAGE_COUNT&nbsp;----打印预览时或打印后，获得总页数 （也可以用PREVIEW_PAGE_COUNT） PRINTSETUP_PAGE_WIDTH----打印设置的纸张宽度，单位是0.1mm PRINTSETUP_PAGE_HEIGHT----打印设置的纸张高度，单位是0.1mm PRINTSETUP_SIZE_WIDTH----所设纸张的可打印宽度，单位是0.1mm PRINTSETUP_SIZE_HEIGHT----所设纸张的可打印高度，单位是0.1mm PRINTSETUP_TOPMARGIN----所设纸张的不可打上边距，单位是0.1mm PRINTSETUP_LEFTMARGIN----所设纸张的不可打左边距，单位是0.1mm PRINTSETUP_FIRST_PAGE&nbsp;----打印时选择的起始页号 PRINTSETUP_ LAST _PAGE&nbsp;----打印时选择的结束页号 PRINTSETUP_PERCENT &nbsp;---打印设置的缩放比例代码 缩放代码值对应的比例含义如下： 0--30% 1--50% 2--60% 3--70% 4--80% 5--85% 6--90% 7--95% 8--100% 9--125% 10--150% &nbsp; 11--200% 12--按整宽 13--按整高 14--按整页 15--整宽不变形 16--整高不变形 17--自定比例 PRINTSETUP_PRINTER_NAME---当前选择的打印机名称 PRINTSETUP_ORIENT----当前设置的打印方向 PRINTSETUP_COPIES----当前设置的打印份数 PRINTSETUP_PAGESIZE_NAME----当前纸张类型名称 PRINT_STATUS_JOBID&nbsp;----最新JOB代码(值有打印机序号和JOB序号组成) PRINT_STATUS_ID----打印状态代码 PRINT_STATUS_TEXT----当前打印状态描述 PRINT_STATUS_LIST----打印状态变化记录 PRINT_STATUS_TOTAL_PAGES----该任务需要打印的总页数 PRINT_STATUS_PAGES_PRINTED----该任务已经打印的总页数 PRINT_STATUS_DOCNAME----该打印任务的文档名称 PRINT_STATUS_ADDTIME----该打印任务的建立时间 PRINT_STATUS_EXIST---判断该打印任务是否还处在队列中 PRINT_STATUS_OK----该打印任务是否已经打印成功 PRINT_STATUS_SECONDS----该打印任务持续的时间(秒) PRINT_STATUS_BUSY----该打印机是否处于忙碌状态 DesignInterfaceBaseX----设计器原点相对于object的X坐标 DesignInterfaceBaseY----设计器原点相对于object的Y坐标 ProgramCodes&nbsp;----获得语句组式模板（程序代码），在打印设计或打印维护界面显示或关闭后通过本语句获得，本模板为js语句格式。 ProgramData&nbsp;----获得文档式模板，在打印设计或打印维护界面显示或关闭后通过本语句获得，本模板为base64编码文档格式。 &nbsp; ValueIndex： 数值对应的项目序号或项目名称，数字或字符型，序号从1开始；有如下几种特殊情况（主要适合获取对象的属性）： 1：当ValueIndex等于selected时，代表打印设计或打印维护界面选定的对象； 2：当ValueIndex等于unSelected时，代表打印设计或打印维护界面没有选定的对象； 3：当ValueIndex等于first或last时，分别代表第一对象和最后一个对象； 4：当ValueType为打印状态（各种PRINT_STATUS_XXX）时，ValueIndex是打印任务的JOB代码，该代码通过PRINT及PREVIEW指令返回，或者本函数的PRINT_JOBID参数获得；要使用各种PRINT_STATUS_XXX，必须用函数SET_PTINT_MODE打开其“CATCH_PRINT_STATU”模式。 5：当ValueType&nbsp;为“ProgramCodes”或“ProgramData”时，可以通过ValueIndex参数控制输出范围： 0-全部代码（默认），1-排除初始化语句，2-排除纸张设置，4-排除变量赋值语句，8-排除背景图语句。 &nbsp; 结果：返回字符 返回对应的字符型、整数型或逻辑值，返回空字符表示读取失败。 建议或要求： 打印设计或打印维护运行期间调用。 举例一：var strResult=LODOP. GET_VALUE&nbsp;("ItemTop",1); &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;获得第1个内容项的上边距值。 举例二：var strResult=LODOP. GET_VALUE&nbsp;("ItemContent ","myItm01"); &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;获得类名为"myItm01"的项目的内容值。 举例三：LODOP.GET_VALUE('DesignInterfaceBaseX',0); &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;LODOP.GET_VALUE('DesignInterfaceBaseY',0); 获取设计器原点相对于object的坐标,便于js拖拉进来的对象和设计器内部的位置一致，见官网样例35. </td> 
 </tr> 
 </tbody> 
</table>

### **FORMAT** ###

### **GET\_DIALOG\_VALUE** ###

## **2、增强函数** ##

### **PRINT\_INITA** ###

<table style="margin-left:-3.6pt;width:432pt;"> 
 <tbody> 
 <tr> 
 <td style="background-color:#f3f3f3;width:432pt;"> 名称：(增强型)打印初始化 格式：PRINT_INITA(Top,Left,Width,Height,strPrintName) 功能：打印初始化、设定纸张整体偏移量、设定可视编辑区域大小 参数： Top： 整页上边距，整数或字符型，整数时缺省长度单位为px。字符型时可包含单位名：in(英寸)、cm(厘米) 、mm(毫米)&nbsp;、pt(磅)、px(1/96英寸)&nbsp;、%(百分比)，如“10mm”表示10毫米，不设置时（用PRINT_INIT初始化）缺省值为0。 Left： 整页左边距，整数或字符型，整数时缺省长度单位为px。字符型时可包含单位名：in(英寸)、cm(厘米) 、mm(毫米)&nbsp;、pt(磅)、px(1/96英寸)&nbsp;、%(百分比)，如“10mm”表示10毫米，不设置时（用PRINT_INIT初始化）缺省值为0。 Width： 可视编辑区域的宽度，整数或字符型，整数时缺省长度单位为px。字符型时可包含单位名：in(英寸)、cm(厘米) 、mm(毫米)&nbsp;、pt(磅)、px(1/96英寸)，如“10mm”表示10毫米，不设置时（用PRINT_INIT初始化）缺省为800px Height： 可视编辑区域的高度，整数或字符型，整数时缺省长度单位为px。字符型时可包含单位名：in(英寸)、cm(厘米) 、mm(毫米)&nbsp;、pt(磅)、px(1/96英寸)，如“10mm”表示10毫米，不设置时（用PRINT_INIT初始化）缺省为600px strPrintName： 打印任务名，同PRINT_INIT&nbsp;的strTaskName。 当打印程序没有调用本初始化语句且调用了SET_PRINT_PAGESIZE时，那么后者设置的纸张尺寸会影响(代替)这里的Width和Height。 结果：返回逻辑值 &nbsp;&nbsp;&nbsp;&nbsp;返回逻辑真表示初始化成功，逻辑假表示初始化失败，失败原因有：前一个打印事务没有完成；操作系统没有打印机(驱动)等 建议或要求 该函数与PRINT_INIT都有初始化功能，建议和要求同PRINT_INIT。 如果打印页有上边距或左边距要求，或可视编辑区域大小用实际纸张大小不合适时，调用本函数。 举例：LODOP.PRINT_INITA(10,10,762,533,"移动公司发票全样"); </td> 
 </tr> 
 </tbody> 
</table>

### **ADD\_PRINT\_HTML** ###

### **ADD\_PRINT\_TBURL** ###

### **ADD\_PRINT\_TEXTA** ###

### **SET\_PRINT\_STYLEA** ###

<table style="margin-left:-3.6pt;"> 
 <tbody> 
 <tr> 
 <td style="background-color:#f3f3f3;"> 名称：(增强型)&nbsp;设置打印项风格A,继承SET_PRINT_STYLE的所有属性 格式：<a rel="nofollow"></a> <a rel="nofollow">SET_PRINT_STYLEA</a>(varItemNameID, strStyleName,varStyleValue) 功能：类似函数SET_PRINT_ STYLE的功能，二者的区别是本函数只对单个打印项有效。 参数： varItemNameID：要设置的目标项序号或项目名，数字型或字符型。 
 <ol> 
 <li>数字型时，表示是序号，以其增加的先后自然顺序为准，从1开始，所有打印对象都参与排序，包括超文本、纯文本、图片、图线、图表、条码等。</li> 
 </ol>&nbsp;&nbsp;&nbsp;&nbsp;如果序号为0，代表当前（最后加入的那个）数据项；如果序号是负数，代表前面加入的数据项，该值为前移个数偏移量。 
 <ol> 
 <li>字符型时，是对象的类名或代表部分对象的关键字。</li> 
 </ol>关键字有如下几种： Selected-代表在设计界面上用鼠标所选的所有对象； unSelected-代表在设计界面上所有没有被鼠标选择的对象； All-代表所有正常对象； First-代表第一个正常对象； Last-代表最后一个正常对象； 不是关键字的字符一般是类名，类名可以在ADD_PRINT_TEXTA 加入纯文本时用strItemName来声明，也可以在设计界面用菜单功能（Set TEXT Item Name）来设置。 &nbsp; strStyleName：打印风格名，风格名称及其含义如下： “PageIndex”： 指定输出页的序号控制字。<a rel="nofollow"></a> <a rel="nofollow">“P</a>reviewOnly”： 指定内容仅仅用来预览或打印。 “ChartStyle”：图表风格，字符形的控制串。 “ChartLeftTitle”：图表的左标题，单行文本字符。 “ChartBottomTitle”： 图表的底标题 “ChartTopTitle”： 图表的上标题 “ChartRightTitle”： 图表的右标题 “ChartTitle”： 图表的主标题 “ChartFoot”： 图表的注脚 “ChartbkStartColor”： 图表的背景渐变的起始颜色 “ChartBKEndColor”： 图表的背景渐变的截止颜色 “ChartMarkColor”： 图表的标注颜色 “ShowBarText”&nbsp;：(一维)条码的码值是否显示 “LeftWallColor”： 图表的左墙颜色 “BottomWallColor”： 图表的底墙颜色 “BackWallColor”： 图表的背墙颜色<a rel="nofollow"></a> “NumberStartPage”：页号排序的起始页 “LineSpacing”：纯文本的行间距 “LetterSpacing”： 纯文本的字间距 “ItemName”：项目类名 “StartNumberValue”：打印页号的初始值 “Content”：打印项的内容 “Deleted”：删除打印项或恢复被删除项； “TransColor”：透明图片的底色 “PageUnIndex”： 禁止输出页的序号控制字 “SpacePatch”：文本末尾补空格 “AlignJustify”：设置“text文本”是否两端对齐或“barcode条码文字”靠齐方式 “TextFrame”：文本的外框类型 “Offset2Top”：次页开始的上边距偏移量 “Offset2Left”：次页开始的左边距偏移量 “LinkedItem”：设置关联内容项的项目编号 “TableHeightScope”：设置TABLE高度是否包含页头页尾 “NotOnlyHighPrecision”：设置条码适应低精度输出或扫描设备 “LinkNewPage”：如果前面剩余空间不足，关联对象顺序打印时就“从新页开始” “HtmWaitMilSecs”：设置超文本下载延迟毫秒数 “Repeat”：设置对象是否在本纸张内有规律重复输出 “AngleOfPageInside”：设置内容对象所在页的整体旋转角度（该对象最好是所在页的首对象） “QRCodeVersion”： 设置二维码QRCode版本值，其决定容量 “QRCodeErrorLevel”：设置二维码QRCode纠错等级 “QRCodeEncodeMode”： 设置二维码QRCode编码模式 “ContentVName”：设置打印设计返回程序代码时的内容参数变量名, (当PROGRAM_CONTENT_BYVAR真时ContentVName才有效) “PDF417EncodeMode”： 设置二维码PDF417压缩模式 “PDF417ErrorLevel”： 设置二维码PDF417容错级别 “PDF417Columns”： 设置二维码PDF417数据列数 “PDF417H_W”： 设置二维码PDF417基条高(倍数) “PDF417Short”： 设置二维码PDF417是否截短模式 “DataCharset”： 设置二维条码的数据集 “GroundColor”： 设置条码的背景色 “TableRowThickNess”：设置htm对象中表格行的自动分页粒度 “TextNeatRow”：设置多行Text对象文本行是否尽量对齐 “IDTagForPick”：用URL获取整页面后,可按ID或标签摘取页面内的单个元素(需高级注册,参考样例14) “Top”用语句二次修改某对象的位置顶部边界距离（在内嵌设计时有用，此前只能用热键或界面按钮） “Left”用语句二次修改某对象的位置和宽高（在内嵌设计时有用，此前只能用热键或界面按钮） “Width”用语句二次修改某对象的位置和宽高（在内嵌设计时有用，此前只能用热键或界面按钮） “Height”用语句二次修改某对象的位置和宽高（在内嵌设计时有用，此前只能用热键或界面按钮） 其它见SET_PRINT_STYLE &nbsp; varStyleValue：打印风格值，相关值如下： PageIndex的值：字符型，用该序号字指定本数据项输出到哪些页。“First”第一页；“Last”最后页；“Odd”奇数页；“Even”偶数页；“具体数字”对应具体页号，可以是多个页号，页号之间用逗号或分号隔开；空表示默认页。缺省值是空。<a rel="nofollow"></a> PreviewOnly的值：字符或数字型，1或true代表仅预览不打印，2代表不预览不打印，否则为正常打印内容。 ChartStyle的值： 字符（串）型，该字符串的长度是19位，譬如：“00001-8008--2353312”每个位置的含义如下： 第1位控制“左边坐标样式”，样式值为0到5之间的一个数字或字符“-”，其中0代表“Hidden”、1代表“Auto”、2代表“None”、3代表“Value”、4代表“Mark”、5代表“Text”，字符“-”代表不设置，用默认样式； 第2位控制“底边坐标样式”，第3位控制“上边坐标样式”，第4位控制“右边坐标样式”，这三位的样式值及其含义与第1位相同。 第5位控制“图例样式”，样式值为0到6之间的一个数字或字符“-”，其中0代表“Hidden”、1代表“LeftValue” 、2代表“LeftPercent” 、3代表“XValue” 、4代表“Plain”、5代表“RightValue”、6代表“RightPercent”，字符“-”代表不设置，用默认样式。 第6位控制“图例位置”，其值为0到3之间的一个数字或字符“-”，其中0代表“Left”、1代表“Right”、2代表“Top”、3代表“Bottom”，字符“-”代表不设置，用默认位置。 第7位控制“标注样式”，样式值为0到9之间的一个数字或字符“-”，其中0代表“Hidden”、1代表“Value” 、2代表“Percent” 、3代表“Label” 、4代表“Label and Percent”、5代表“Label and Value”、6代表“Legend” 、7代表“Percent Total” 、8代表“Label and Percent Total” 、9代表“XValue”，字符“-”代表不设置，用默认样式。 第8位控制“标注是否透明”，其值为0到1之间的一个数字或字符“-”，其中0代表“不透明”、1代表“透明”，字符“-”代表不设置，默认不透明。 第9-10这两位控制“三维深度（3D效果）”，其值为1到99之间的一个数值或两个字符“-”，1-99代表3D效果的百分比例，字符“-”代表不设置，用默认的3D效果。 第11-12这两位控制“左墙厚度”，其值为0到99之间的一个数值或两个字符“-”，0代表隐藏左墙，1-99代表左墙的厚度，字符“-”代表不设置，用默认的厚度。 第13位控制“背景色渐变走向样式”，样式值为0到7之间的一个数字或字符“-”，其中0代表“Hidden”、1代表“Top-&gt;Bottom”、2代表“Bottom-&gt;Top”、3代表“Left-&gt;Right”、4代表“Right-&gt;Left”、5代表“From Center”、6代表“From TopLeft”、7代表“From BottomLeft”，字符“-”代表不设置，用默认样式。 第14-16这三位控制“左右方向的旋转角度”，其值为270到361之间的一个数值或三个字符“-”，270-360代表旋转的角度，361代表恢复缺省角度，字符“-”代表不设置，用默认的角度。 第17-19这三位控制“前后方向的翻转角度”，其值为270到360之间的一个数值或三个字符“-”，270-360代表旋转的角度，字符“-”代表不设置，用默认的角度。 ChartLeftTitle、ChartBottomTitle、ChartTopTitle、ChartRightTitle、ChartTitle、ChartFoot：这六个的值：都是单行文本字符，未限制长度。 ChartbkStartColor、ChartBKEndColor、ChartMarkColor、LeftWallColor、BottomWallColor、BackWallColor这六个的值：整数或字符型，整数时是颜色的十进制RGB值；字符时是超文本颜色值，可以是“#”加三色16进制值组合，也可以是英文颜色名。 ShowBarText的值 ：字符或逻辑型，真表示显示（一维条码的）码值，假表示隐藏码值，默认值是真。true、“true”、1、“1”代表真，false、“false”、0或“0”代表假 NumberStartPage的值：整数型，代表页号排序时的起始页，默认是1，即从第一页开始计算页号，设置大于1时一般用于目录或扉页不排序。 LineSpacing、LetterSpacing的值：字符或整数型，整数时缺省长度单位为px。字符型时可包含单位名：in(英寸)、cm(厘米) 、mm(毫米)&nbsp;、pt(磅)、px(1/96英寸)。 ItemName的值：字符型，未限制长度，禁止包含关键字“ITEM”。 StartNumberValue的值，整数型，打印页号时起始值，默认是1，即页号从1开始累加，该值可以是0或负数。 “Content”的值： 字符型，打印项的内容，未限制长度，在内容打印维护或打印设计时可动态设置打印项内容。 “Deleted”的值：字符或逻辑型，真表示删除该打印项，&nbsp;True或“True”或1或“1”==真，False或“False”或0或“0”=假，假表示恢复删除项。 “TransColor”的值：透明图片的底色，整数或字符型，整数时是颜色的十进制RGB值；字符时是超文本颜色值，可以是“#”加三色16进制值组合，也可以是英文颜色名。 PageUnIndex的值：字符型，用该序号字禁止本数据项输出到哪些页。“First”第一页；“Last”最后页；“Odd”奇数页；“Even”偶数页；“具体数字”对应具体页，可以是多个页号，页号之间用逗号或分号隔开；空表示不禁止。缺省值是空。 “SpacePatch”的值：数字型，1代表文本末尾补空格，0代表不补。 “AlignJustify”的值： 数字型 设置“text文本”时，1代表两端对齐，0代表不处理（默认）； &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;设置“barcode条码文字”时，0-两端对齐(默认) &nbsp;1-左靠齐 &nbsp;2-居中 &nbsp;3-右靠齐； “TextFrame”的值： 数字型，文本的外框类型如下： &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;0(None)--无 &nbsp;1(Uper)--上划线 &nbsp;&nbsp;2(Under)--下划线 &nbsp;&nbsp; 3(Left)--左划线 &nbsp;&nbsp;4(Right)--右划线 &nbsp;&nbsp;5(Rect)-矩形圈框 &nbsp;&nbsp; 6(Ellipse)-圆圈框 &nbsp;7(Luper)-整行上划线 &nbsp;&nbsp;8(Lunder)-整行下划线 9(Lleft)-整行左划线 &nbsp;&nbsp;10(Lright)--整行右划线11(Lrect)-整行矩形圈框 &nbsp;&nbsp;12(Lellipse)-整行圆圈框 &nbsp;&nbsp;13(Grid)-田字格 &nbsp;&nbsp;14(Divi)-分割线 “Offset2Top”的值： 整数或字符型，可声明单位或百分比，表示从次页开始的上边距偏移量。例如当对象的首页内容不能从顶端开始打印时，本设置显然很有用。 “Offset2Left”&nbsp;的值： 整数或字符型，可声明单位或百分比，表示从次页开始的左边距偏移量。 “LinkedItem”的值： 整数或字符型，字符型代表被关联项的项目名，整数代表被关联项的序号，如果是负数，代表当前对象，例如-1代表前一个对象，-2代表前面隔一个对象，使用-1时可以用同一个语句连续顺序关联一串对象。 内容项与别人关联后，会紧跟被关联者之后打印，位置和区域大小随被关联项而定，此时其Top和left不再是上边距和左边距，而是与关联项的间隔空隙及左边距偏移。 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;如果关联者是页眉页脚对象，那么不会每页输出，仅与被关联对象同页输出。此时输出的位置与被关联对象的位置相对固定，也就是当上边距小于被关联对象的上边距时，那么其起点位置会与被关联者的上边线保持设计时的距离，否则与被关联对象的下边线保持设计时的距离。 “TableHeightScope”&nbsp;的值：数字型， 0-代表不包含（默认），1-代表包含头和尾&nbsp;2-只包含页头&nbsp;3-只包含页尾。这个值仅对TABLE对象有效。 &nbsp; “NotOnlyHighPrecision”的值：数字型或逻辑型，True或1代表“是”，False或0代表“否”。 “LinkNewPage”的值：字符或数字型，True或1代表“是”，False或0代表“否”。 “HtmWaitMilSecs”的值：整数，毫秒数。 “Repeat”的值：数字型或逻辑型，True或1代表“是”，False或0代表“否”，本项对TABLE对象和HTM对象不起作用，但对IMAGE、TEXT、SHAPE、HTML（不是HTM）、BARCODE和CHART都起作用。 “AngleOfPageInside”的值：整数，角度值，正数表示逆时针旋转角度，负数表示顺时针旋转角度，可设置任何值，但注意很多打印机不一定支持该旋转，需要实际测试后再决定使用该功能，一般来说旋转+-90度和180度比较常见，当打印机不支持这种旋转打印时，仍可采用“横向打印”（参考SET_PRINT_PAGESIZE）实现-90度旋转，后者几乎所有打印机都支持。 “QRCodeVersion”的值：数字，有1,2,3,5,7,10,14共七个版本可选，最小版本的字符容量是14字符或者7个汉字，最大版本的容量是352字符或对应汉字。 “QRCodeErrorLevel”的值：单字符，默认值是”M”，具体值及其纠错等级含义如下： &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;“L”：7% &nbsp;&nbsp;&nbsp;&nbsp;“M”：15%(默认) &nbsp;&nbsp;“H”：30% “QRCodeEncodeMode”&nbsp;的值：单字符，默认值是”B”，具体值及其编码含义如下： “N”：数字 &nbsp;&nbsp;“A”：英文字母 &nbsp;&nbsp;&nbsp;“B”：二进制或汉语(默认) “ContentVName”的值：字符型，无长度限制，尽量避免太长，且不要包含标点符号。 内容参数变量名是为了生成后的程序代码直接与页面程序对接，不用再二次替换，也就是说，这里设置的变量名，在js程序中应该有对应的同名变量且已经赋值。 “PDF417EncodeMode”的值：数字型，数字代码及其压缩模式：0-自动(默认)，1-txt模式 2-bin模式 “PDF417ErrorLevel”的值：数字型，数字代码及其容错级别：-1--自动(默认) &nbsp;0--2byes 1--4byes &nbsp;&nbsp;2--8byes &nbsp;3--16byes &nbsp;4--32byes &nbsp;5--64byes &nbsp;&nbsp;6--128byes &nbsp;7--256byes &nbsp;8--512byes “PDF417Columns”的值：数字型，数字代码：0--自动(默认),其它值有1,2,3,4,5,6,7,8，最大是8，代码值等于数据列数值。 “PDF417H_W”的值：数字型，数字代码及基条高(也称长宽倍数)：0--自动(默认) 其它值有1,2,3,4,5,6,7,8，最大是8，代码值等于倍数值，这里的倍数是指基条高度与宽度的比例，它影响了整个条码的长宽形态。 “PDF417Short”的值，数字型或逻辑型，设置条码是否截短模式，True或1代表“是”，False或0代表“否”。 “DataCharset”&nbsp;的值，字符型，二维码支持的数据集有： ANSI,UTF-8,GB2312,GBK,BIG5,EUC-JP,UTF-7,UNICODE,UTF-16,UTF-16BE,SHIFT-JIS,Windows-874,Windows-1250,Windows-1251,Windows-1253,Windows-1254,Windows-1255,Windows-1256,Windows-1257,Windows-1258 “GroundColor”&nbsp;的值，设置条码的背景色，整数或字符型，整数时是颜色的十进制RGB值；字符时是超文本颜色值，可以是“#”加三色16进制值组合，也可以是英文颜色名。 “TableRowThickNess”的值：整数，分页粒度值，默认是20(px)。所谓分页粒度，是指自动分页时在分页线附近进行的前后定位分割线的范围。如果这个范围设置太小，那么分页位置恰巧遇到较大单元格时，则找不到其前后表格线，此时控件会把td单元格切开；相反如果这个范围设置太大，那么原本想切开的大单元格会被大块地搬到下页，造成每页内容差别很大而参差不齐。 “TextNeatRow”&nbsp;的值，数字型或逻辑型，True或1代表“是”，False或0代表“否”。设置Text对象文本尽量对齐时，结尾型标点符号会溢出在行外，长英文单词也会被拆开，从而实现每行的右边界对齐。 “IDTagForPick”的值，是页面的ID或标签摘取页面内的单个元素，字符型。 其它见SET_PRINT_STYLE &nbsp; 结果：同函数SET_PRINT_ STYLE。 建议或要求： 打印初始化后、增加打印项之后调用本函数。 举例一：LODOP.SET_PRINT_STYLEA(3,"FontName","隶书"); &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;设置第3个内容项的字体为隶书。 举例二：1.LODOP.SET_PRINT_STYLEA(0,"PageIndex","first"); &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;设置刚加入的这个内容只在首页输出。 2.LODOP.ADD_PRINT_HTM(1,600,300,100,"总页号：&lt;span tdata='pageNO-2'&gt;第##页&lt;/span&gt;/&lt;span tdata='pageCount-2'&gt;共##页&lt;/span&gt;"); &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;LODOP.SET_PRINT_STYLEA(0,"ItemType",1);//每页都输出 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;LODOP.SET_PRINT_STYLEA(0,"PageUnIndex","1,2");//1、2页不输出，排除法。 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;3.&nbsp;LODOP.SET_PRINT_STYLEA(0,"PageIndex","3,Last-1"); 设置让某个内容项仅在第3页和倒数第2页输出，控制输出范围的具体页号值可以是“Fisrt”“Last”为变量的四则运算表达式；&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; 举例三：LODOP.SET_PRINT_STYLEA(0,"PreviewOnly",true); &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;设置刚加入的这个内容只用来预览不实际打印输出。 举例四：LODOP.SET_PRINT_STYLEA(0,"QRCodeVersion",3); 举例五：LODOP.SET_PRINT_STYLEA(0,"QRCodeErrorLevel","L"); 举例六：LODOP.SET_PRINT_STYLEA(0,"PDF417ErrorLevel",2); 举例七：LODOP.SET_PRINT_STYLEA(0,"DataCharset","UTF-8"); 举例八：LODOP.SET_PRINT_STYLEA(0,"GroundColor","#0080FF"); 举例九：LODOP.SET_PRINT_STYLEA(0,"IDTagForPick","form2"); //其它例如："table:2" "div:3" </td> 
 </tr> 
 <tr> 
 <td style="background-color:#f3f3f3;"> 举例十：LODOP.SET_PRINT_STYLEA(0,'Top','20mm'); //重设值 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;LODOP.SET_PRINT_STYLEA(0,'Left','++2mm'); &nbsp;//增量 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;LODOP.SET_PRINT_STYLEA(0,'Width','--2mm'); //减量 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;LODOP.SET_PRINT_STYLEA(0,'Height','BottomMargin:++2mm');//用转义字 举例十一：用语句二次修改整体附加偏移和可视编辑区域的总宽高,如下： &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;LODOP.SET_PRINT_STYLEA('PRINT_INIT','Top','20mm'); &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;LODOP.SET_PRINT_STYLEA('PRINT_INIT',,'Left','20mm'); &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;LODOP.SET_PRINT_STYLEA('PRINT_INIT',,'Width','20mm'); &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;LODOP.SET_PRINT_STYLEA('PRINT_INIT',,'Height','20mm'); </td> 
 </tr> 
 </tbody> 
</table>

### **SAVE\_TO\_FILE** ###

### **SET\_SAVE\_MODE** ###

### **ADD\_PRINT\_SHAPE** ###

### **SET\_PRINTER\_INDEXA** ###

### **NEWPAGEA** ###

### **PREVIEWA** ###

### **PREVIEWB** ###

### **PRINTA** ###

### **PRINTB** ###

### **SHOW\_CHART** ###

### **DO\_ACTION** ###

### **SET\_LICENSES** ###

# **五、软件使用权注册** #

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

1.   (不经过预览的)“直接打印”功能；
2.  “导出数据到Excel文件” 功能；

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

Lodop注册号的价格表、购买方式和使用方法见：http://blog.sina.com.cn/s/blog\_721e77e50100nfzs.html

# **六、打印维护和打印设计** #

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

打印设计用到的快捷键：

ctrl 选中；

ctrl + delete 删除；

ctrl \+ 方向键 移动微调；

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

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

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

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

# **七、使用样例** #

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

[http://www.c-lodop.com/download.html][http_www.c-lodop.com_download.html]或

[http://www.mtsoftware.cn/download.html][http_www.mtsoftware.cn_download.html]

# **八、计量单位** #

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

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

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

<完>

[http_www.c-lodop.com_download.html]: http://www.c-lodop.com/download.html
[http_www.mtsoftware.cn_download.html]: http://www.mtsoftware.cn/download.html