Lodop4.4技术手册【可编辑范本】

Lodop4.4技术手册【可编辑范本】

ID:81782262

大小:163.04 KB

页数:29页

时间:2022-11-01

上传者:胜利的果实
Lodop4.4技术手册【可编辑范本】_第1页
Lodop4.4技术手册【可编辑范本】_第2页
Lodop4.4技术手册【可编辑范本】_第3页
Lodop4.4技术手册【可编辑范本】_第4页
Lodop4.4技术手册【可编辑范本】_第5页
Lodop4.4技术手册【可编辑范本】_第6页
Lodop4.4技术手册【可编辑范本】_第7页
Lodop4.4技术手册【可编辑范本】_第8页
Lodop4.4技术手册【可编辑范本】_第9页
Lodop4.4技术手册【可编辑范本】_第10页
资源描述:

《Lodop4.4技术手册【可编辑范本】》由会员上传分享,免费在线阅读,更多相关内容在行业资料-天天文库

WEB打印控件Lodop技术手册Ver4.4.3。0Email:gungho999@sina。comQQ:93213168629

1目录一、概述3二、系统文件4install_lodop。exe4CheckActivX。js4npActiveXFirefox4x。xpi5三、控件参数5Caption5Color5Border6四、功能函数61、基本函数6VERSION6PRINT_INIT6SET_PRINT_PAGESIZE7ADD_PRINT_HTM8ADD_PRINT_TABLE8ADD_PRINT_URL9ADD_PRINT_TEXT9ADD_PRINT_IMAGE10ADD_PRINT_RECT10ADD_PRINT_ELLIPSE11ADD_PRINT_LINE11SET_PRINT_STYLE12NEWPAGE13PREVIEW14PRINT14PRINT_SETUP14PRINT_DESIGN14GET_PRINTER_COUNT15GET_PRINTER_NAME15SET_PRINTER_INDEX15SELECT_PRINTER16SET_SHOW_MODE16SET_PRINT_MODE18SET_PREVIEW_WINDOW18ADD_PRINT_SETUP_BKIMG19SEND_PRINT_RAWDATA19WRITE_PORT_DATA19READ_PORT_DATA20GET_PRINT_INIFFNAME20WRITE_FILE_TEXT20GET_FILE_TEXT2129

2GET_FILE_TIME21IS_FILE_EXIST222、扩展函数22SET_PRINT_PAPER22ADD_PRINT_HTML23ADD_PRINT_TBURL23ADD_PRINT_TEXTA23SET_PRINT_STYLEA23SET_PRINT_TEXT_STYLEA24ADD_PRINT_SHAPE25SET_PRINTER_INDEXA26PREVIEWA26PREVIEWB26PRINTA26PRINTB27SET_LICENSES27五、软件使用权注册27CompanyName28License28LicenseA28LicenseB28六、打印维护和打印设计28七、使用样例29八、计量单位29一、概述Lodop是一款专业的WEB打印控件,其设计目标是简单易用、功能足够强大,开创WEB打印开发的新局面。Lodop设计者对WEB下的打印开发任务进行了分类汇总,高度抽象,设计出仅用几个功能函数,就可实现复杂的打印任务,尽量减少使用者的知识累赘。控件发布包有3个系统文件组成,全部功能用几个控件参数和2组功能函数来实现。尽管我们有个理想化的目标,那就是您不用详细了解这些参数或函数,仅仅看懂几个样例文件就能很轻松地开始使用本控件,为此Lodop提供了一个足够完善的设计界面,用它可以实现大多数打印开发任务,但事实上了解这些参数和函数总还是有好处的,特别是当你的开发任务很复杂时,这就是本文目的,但愿本文档足够详细且简单明了。如果此前曾看过lodop的入门样例程序,本文会更容易理解!29

3二、系统文件Lodop发布包内主要有如下三个文件:install_lodop.exe该文件是控件安装和升级的主文件,提供给用户或开发者下载安装,如果不特意拦截一般都能100%安装,对“网页插件安装难”有一定改善。如果将其复制或改名为uninstall_lodop。exe(名前加un)就可用其卸载控件。Lodop安装后,在操作系统目录WINDOWS\system32下会安装一个OCX文件:CAOSOFT_WEB_PRINT_LODOP.OCX,有特殊需要的使用者可以将该文件自主签名,用传统的OCX安装方式发布。CheckActivX.js该文件是用来引导安装控件的一个JS文件,是个样例,但建议直接采用.其中CheckLodop的任务是检查控件是否安装、是否最新版本、并引导安装或升级。文件内容如下:functionCheckLodop(){varoldVersion=LODOP.Version;newVerion=”4。4.0。2";if(oldVersion==null){document。write(”〈h3>〈fontcolor=’#FF00FF’〉打印控件未安装!点击这里〈ahref='install_lodop。exe’>执行安装〈fontcolor=’#FF00FF’〉(Firefox浏览器用户需先点击这里)〈/h3>”);}elseif(oldVersion〈/h3>");}其中的关键点是Version函数,Lodop提供了一个“读版本号”功能,这样控件的安装和升级任务就交给JS来实现,以下是控件在页面内的调用代码,其中包含CheckLodop的利用:〈head>

4〈scriptlanguage=”javascript"src=”CheckActivX。js”>〈scriptlanguage=”javascript”〉CheckLodop();…功能:打印控件在页面内一般是以object元素形式被引用。可以通过设置元素的width和height等于0来隐藏控件,不隐藏时可以为控件设置一个标题,以便于看到控件是否被正确安装,以及控制对象在页面内的位置。希望打印预览界面或设计界面内嵌到网页内时,本参数显然很有用。Color名称:设置打印控件的显示区域颜色29

5格式:功能:通过该参数设置控件显示区域的底色,对于希望打印预览界面或设计界面内嵌到网页内时,本参数显然可以让控件容易融于整体页面.参数值采用超文本颜色形式,可以是三色16进制值组合,也可以是英文颜色名.Border名称:设置打印控件的显示区域边界格式:〈paramname=”Border”value=”1”〉功能:通过该参数设置控件显示区域的边界,值等于1表示有边界,否则无边界。本参数显然可以让控件更融于整体页面。另外,控件还有三个用于注册的辅助参数,参考后面《软件使用权注册》一节。四、功能函数Lodop的功能函数不多,但参数比较复杂。全部函数分“基本函数”和“扩展函数"两类,两类函数有类似性,基本函数使用简单,达不到要求时请使用扩展函数,二者无本质区别。1、基本函数VERSION名称:获得软件版本号格式:VERSION结果:返回字符型结果版本号有四个数字组成,样式为:X.X。X.XPRINT_INIT名称:打印初始化格式:PRINT_INIT(strTaskName)功能:初始化运行环境,清理异常打印遗留的系统资源,设定打印任务名。29

6参数:strTaskName:打印任务名,字符型参数,由开发者自主设定,未限制长度,字符要求符合Windows文件起名规则,Lodop会根据该名记忆相关的打印设置、打印维护信息。若strTaskName空,控件则不保存本地化信息,打印全部由页面程序控制.结果:返回逻辑值返回逻辑真表示初始化成功,逻辑假表示初始化失败,失败原因有:前一个打印事务没有完成;操作系统没有打印机(驱动)等。建议或要求:该函数与SET_PRINT_PAPER都有初始化功能,每个打印事务至少初始化一次,建议打印程序首先调用该函数。任务名要尽量区别于其它打印任务,譬如用“XX单位_XX管理信息系统_XX子系统_XX模块_XX打印作业”字样。不希望最终用户更改打印布局时,则设strTaskName空.SET_PRINT_PAGESIZE名称:设定纸张大小格式:SET_PRINT_PAGESIZE(intOrient,intPageWidth,intPageHeight,strPageName)功能:设定打印纸张为固定纸张,并设定其大小值或纸张类型名及打印方向。参数:intOrient:设定打印方向,数字型,0(或其它)-默认方向1-纵(正)向打印2—横向打印。intPageWidth:设定自定义纸张宽度,整数型,单位为0.1毫米。intPageHeight:设定自定义纸张高度,整数型,单位为0。1毫米。高或宽小于等于0时strPageName才起作用。strPageName:设为标准纸张,纸张类型名,字符型,只能在如下名称中选择,不限大小写:Letter,LetterSmall,Tabloid,Ledger,Legal,Statement,Executive, A3,A4,A4Small,A5,B4,B5,Folio,Quarto,qr10X14,qr11X17,Note, Env9,Env10,Env11,Env12,Env14,Sheet,DSheet,Esheet注:intPageWidth、intPageHeight和strPageName都无效时,本函数对纸张大小不起作用,控件则采用所选打印机的默认纸张,但intOrient仍可起作用。如果打印程序未采用扩展方式(SET_PRINT_PAPER)初始化,本函数所定制的纸张大小,会起到SET_PRINT_PAPER中intWidth和intHeight的相同功能.结果:无建议或要求:打印初始化之后调用。如果打印纸张不固定,希望由操作者自主选择纸张时,则不要调用本函数。29

7ADD_PRINT_HTM名称:增加超文本打印项(普通模式)格式:ADD_PRINT_HTM(intTop,intLeft,intWidth,intHeight,strHtmlContent)功能:增加超文本打印项,设定该打印项在纸张内的位置和区域大小,实现超文本控制打印。参数:intTop:所增打印项在纸张内的上边距,整数型,单位是px.IntLeft:所增打印项在纸张内的左边距,整数型,单位是px.intWidth:打印区域的宽度,整数型,单位是px。intHeight:打印区域的高度,整数型,单位是px,控件按这个值自动分页。strHtmlContent:超文本代码内容,字符型,未限制长度.可以是一个完整的页面,也可以是代码段.结果:无建议或要求:要求在打印初始化后调用,建议在画线类函数之后调用。ADD_PRINT_TABLE名称:增加表格打印项(超文本模式)格式:ADD_PRINT_TABLE(intTop,intLeft,intWidth,intHeight,strHtml)功能:用超文本增加一个表格打印项,设定该表格在每个纸张内的位置和区域大小。打印时只输出首个页面元素table的显示内容,当table内包含thead或tfoot时,一旦表格被分页,则每个打印页都输出表头(thead)或表尾(tfoot)。参数:intTop:表格数据头(页头thead)在纸张内的上边距,整数型,单位是px。intLeft:表格数据头(页头thead)在纸张内的左边距,整数型,单位是px。intWidth:打印区域的宽度,整数型,单位是px。intHeight:表格数据体(tbody)区域的高度,整数型,单位是px。控件按这个值自动分页。strHtml:超文本代码内容,字符型,未限制长度。可以是一个完整的页面,也可以是代码段。结果:无建议或要求:要求在打印初始化后调用,建议在画线类函数之后调用.29

8ADD_PRINT_URL名称:增加超文本打印项(URL模式)格式:ADD_PRINT_URL(intTop,intLeft,intWidth,intHeight,strURL)功能:按URL地址增加超文本打印项,设定该打印项在纸张内的位置和区域大小。参数:intTop:所增打印项在纸张内的上边距,整数型,单位是px。IntLeft:所增打印项在纸张内的左边距,整数型,单位是px。intWidth:打印区域的宽度,整数型,单位是px。intHeight:打印区域的高度,整数型,单位是px,控件按这个值自动分页。strURL:页面URL地址,字符型,未限制长度。结果:无建议或要求:要求在打印初始化后调用,建议在画线类函数之后调用。ADD_PRINT_TEXT名称:增加纯文本打印项格式:ADD_PRINT_TEXT(intTop,intLeft,intWidth,intHeight,strContent)功能:增加纯文本打印项,设定该打印项在纸张内的位置和区域大小,文本内容在该区域内自动折行.参数:intTop:打印项在纸张内的上边距,整数型,单位是px。当上边距超过纸张高度时,打印项被输出在下一页(或更下页)。IntLeft:打印项在纸张内的左边距,整数型,单位是px。intWidth:打印区域的宽度,整数型,单位是px.intHeight:打印区域的高度,整数型,单位是px。strContent:纯文本内容,字符型,未限制长度。结果:无建议或要求:要求在打印初始化后调用,建议在画线类函数之后调用.29

9ADD_PRINT_IMAGE名称:增加图片打印项格式:ADD_PRINT_IMAGE(intTop,intLeft,intWidth,intHeight,strHtmlContent)功能:增加图片打印项,设定该打印项在纸张内的位置和区域大小。参数:intTop:所增打印项在纸张内的上边距,整数型,单位是px。IntLeft:所增打印项在纸张内的左边距,整数型,单位是px.intWidth:图片的宽度,整数型,单位是px。intHeight:图片的高度,整数型,单位是px,图片大时被截取,不会分到下页。strHtmlContent:超文本代码内容,字符型,未限制长度。获得图片的超文本(用标签IMG).结果:无建议或要求:要求在打印初始化后调用,建议在画线类函数之后调用。本函数可用ADD_PRINT_HTM代替,但区别是其仅取超文本第一个图片元素,边距是0,而且打印时不因为设计区域小于图片而被分页,适合与纯文本组合打印的插图。ADD_PRINT_RECT名称:增加矩形线格式:ADD_PRINT_RECT(intTop,intLeft,intWidth,intHeight,intLineStyle,intLineWidth)功能:增加矩形线打印项,设定该矩形在纸张内的位置和大小,设定线条的类型和线条宽度。参数:intTop:该矩形在纸张内的上边距,整数型,单位是px。当上边距超过纸张高度时,打印项被输出在下一页(或更下页)。IntLeft:该矩形在纸张内的左边距,整数型,单位是px。intWidth:该矩形的宽度,整数型,单位是px。intHeight:该矩形的高度,整数型,单位是px,宽和高相等时是正方形.intLineStyle:线条类型,数字型,0(或其它)代表实线1-破折线2-点线3-点划线4-双点划线缺省线条是实线。intLineWidth:线条宽,整数型,单位是px,缺省值是1px,非实线的线条宽也是1px.结果:无建议或要求:29

10要求在打印初始化后调用,建议在文本类函数之前调用。ADD_PRINT_ELLIPSE名称:增加椭圆线格式:ADD_PRINT_ELLIPSE(intTop,intLeft,intWidth,intHeight,intLineStyle,intLineWidth)功能:增加椭圆线打印项,设定该椭圆在纸张内的位置和大小,设定线条的类型和线条宽度.参数:intTop:该椭圆的外缘矩形在纸张内的上边距,整数型,单位是px。当上边距超过纸张高度时,打印项被输出在下一页(或更下页).IntLeft:该椭圆的外缘矩形在纸张内的左边距,整数型,单位是px。intWidth:该椭圆的外缘矩形的宽度,整数型,单位是px。intHeight:该椭圆的外缘矩形的高度,整数型,单位是px,宽和高相等时是圆。intLineStyle:线条类型,数字型,0(或其它)代表实线1-破折线2-点线3-点划线4-双点划线缺省线条是实线。intLineWidth:线条宽,整数型,单位是px,缺省值是1px,非实线的线条宽也是1px。结果:无建议或要求:要求在打印初始化后调用,建议在文本类函数之前调用。ADD_PRINT_LINE名称:增加直线格式:ADD_PRINT_LINE(intTop1,intLeft1,intTop2,intLeft2,intLineStyle,intLineWidth)功能:增加直线,设定直线的两个端点,设定直线的线条类型和线宽.参数:intTop1:端点1的上边距,整数型,单位是px。当上边距超过纸张高度时,打印项被输出在下一页(或更下页)。intLeft1:端点1的左边距,整数型,单位是px.IntTop2:端点2的上边距,整数型,单位是px。当上边距超过纸张高度时,打印项被输出在下一页(或更下页)。29

11IntLeft2:端点2的左边距,整数型,单位是px。intLineStyle:线条类型,数字型,0(或其它)代表实线1-破折线2-点线3-点划线4-双点划线缺省线条是实线。intLineWidth:线条宽,整数型,单位是px,缺省值是1px,非实线的线条宽也是1px。结果:无建议或要求:要求在打印初始化后调用,建议在文本类函数之前调用。SET_PRINT_STYLE名称:设置打印项风格格式:SET_PRINT_STYLE(strStyleName,varStyleValue)功能:设置打印项的输出风格,成功执行该函数,此后再增加的打印项按此风格输出.参数:strStyleName:打印风格名,风格名称及其含义如下:“FontName":设定文本打印项的字体名称。“FontSize”:设定文本打印项的字体大小.“FontColor”:设定文本打印项的字体颜色。“Bold”:设定文本打印项是否粗体。“Italic”:设定文本打印项是否斜体.“Underline":设定文本打印项是否下滑线。“Alignment”:设定文本打印项的内容左右靠齐方式。“Angle”:设定文本打印项的旋转角度。“ItemType":设定打印项的基本属性。“HOrient”:设定打印项在纸张内的水平位置锁定方式.“VOrient”:设定打印项在纸张内的垂直位置锁定方式。“PenWidth”:线条宽度.“PenStyle”:线条风格。“Stretch”:图片截取缩放模式。varStyleValue:打印风格值,相关值如下:FontName的值:字符型,与操作系统字体名一致,缺省是“宋体”。FontSize的值:数字型,单位是pt,缺省值是9.FontColor的值:整数或字符型,整数时是颜色的十进制RGB值;字符时是超文本颜色值,可以是“#”加三色16进制值组合,也可以是英文颜色名;Bold的值:数字型,1代表粗体,0代表非粗体,缺省值是0。Italic的值:数字型,1代表斜体,0代表非斜体,缺省值是0.29

12Underline的值:数字型,1代表有下划线,0代表无下划线,缺省值是0。Alignment的值:数字型,1(或其它)-左靠齐2—居中3—右靠齐,缺省值是1。Angle的值:数字型,逆时针旋转角度数,单位是度,0度表示不旋转。ItemType的值:数字型,0(或其它)—普通项1—页眉页脚2-页号项3—页数项4-多页项缺省(不调用本函数时)值0。普通项只打印一次;页眉页脚项则每页都在固定位置重复打印;页号项和页数项是特殊的页眉页脚项,其内容包含当前页号和全部页数;多页项每页都打印,直到把内容打印完毕,打印时在每页上的位置和区域大小固定一样(多页项只对纯文本有效)HOrient的值:数字型,0(或其它)—左边距锁定1-右边距锁定2-水平方向居中3-左边距和右边距同时锁定(中间拉伸),缺省值是0。VOrient的值:数字型,0(或其它)-上边距锁定1—下边距锁定2-垂直方向居中3-上边距和下边距同时锁定(中间拉伸),缺省值是0。PenWidth的值:整数型,单位是px,缺省值是1px,非实线的线条宽也是1px。PenStyle的值:数字型,0(或其它)代表实线1-破折线2—点线3—点划线4—双点划线缺省值是0.Stretch的值:数字型,0(或其它)截取图片1扩展(可变形)缩放2-按原图长和宽比例(不变形)缩放。缺省值是0。结果:无建议或要求:打印初始化后、增加打印项之前调用本函数.NEWPAGE名称:强制分页格式:NEWPAGE()功能:强制分页.执行该函数之后所增加的内容会在下一页输出。在执行该函数之前,需要至少有一项内容,否则该函数不动作.参数:无结果:返回逻辑值返回逻辑真表示强制分页成功,逻辑假表示强制分页失败。建议或要求:打印初始化后调用本函数。29

13PREVIEW名称:打印预览格式:PREVIEW()功能:打印预览输出页。参数:无结果:弹出打印预览界面,详见打印预览说明。建议或要求:建立打印页之后运行。PRINT名称:直接打印格式:PRINT()功能:不经打印预览的直接打印。参数:无结果:打印机开始实际打印,返回逻辑结果,正确打印时返回真,打印出错时返回假.建议或要求:建立打印页之后运行.PRINT_SETUP名称:打印维护格式:PRINT_SETUP()功能:对整页的打印布局和打印风格进行界面维护,它与打印设计的区别是不具有打印项增删功能,目标使用者是最终用户。参数:无结果:弹出打印维护界面,详见打印维护说明。建议或要求:建立打印页之后运行。PRINT_DESIGN名称:打印设计格式:PRINT_DESIGN()功能:对整页的打印布局和打印风格进行界面设计,它与打印维护的区别是具有打印项增删功能,目标使用者是开发者。参数:无结果:弹出打印设计界面,详见打印设计说明.建议或要求:29

14建立打印页之后运行。GET_PRINTER_COUNT名称:获得打印设备个数格式:GET_PRINTER_COUNT()功能:获得操作系统内打印设备的个数。参数:无结果:返回数字返回数字结果表示操作系统内的打印设备个数,0表示失败或无打印设备.建议或要求:任何时间调用均可。GET_PRINTER_NAME名称:获得打印设备名称格式:GET_PRINTER_NAME(intPrinterNO)功能:按打印设备序号获得其名称.参数:intPrinterNO:打印设备序号,数字型,序号从0开始,最大序号是GET_PRINTER_COUNT()减1。结果:返回字符返回字符结果表示操作系统内的打印设备的名称,空表示失败或无该设备。建议或要求:任何时间调用均可.SET_PRINTER_INDEX名称:指定打印设备格式:SET_PRINTER_INDEX(intIndex)功能:指定用某打印设备输出。参数:intIndex:所指定打印设备的序号,数字型,序号从0开始,最大序号是GET_PRINTER_COUNT()减1。结果:返回逻辑值返回逻辑真表示指定成功,逻辑假表示指定失败,失败原因有:该打印设备不存在。建议或要求:初始化之后,直接打印前或打印预览前调用。29

15SELECT_PRINTER名称:选择打印设备格式:SELECT_PRINTER功能:弹出界面选定某打印设备为固定输出设备。参数:无结果:返回数字返回数字结果表示选定的设备序号,返回-1表示放弃选择,没有任何动作。建议或要求:直接打印前或打印预览前调用。本函数与SET_PRINTER_INDEX的功能效果一样。SET_SHOW_MODE名称:设置显示模式格式:SET_SHOW_MODE(strModeType,varModeValue)功能:设置打印预览、打印维护和打印设计的显示模式,设置打印预览时是否包含背景图等。参数:strModeType显示模式的名称,字符型,如下是类型名及其含义:“PREVIEW_IN_BROWSE”:打印预览界面是否内嵌到网页内部。“SETUP_IN_BROWSE":打印维护界面是否内嵌到网页内部。“DESIGN_IN_BROWSE”:打印设计界面是否内嵌到网页内部.“BKIMG_IN_PREVIEW”:打印预览时是否包含背景图。“BKIMG_IN_FIRSTPAGE":打印预览时是否仅首页包含背景图。“SETUP_ENABLESS”:打印维护界面工具显示控制(权限控制字串)“SKIN_TYPE":界面皮肤类型“SKIN_CUSTOM_COLOR”:界面自定义皮肤颜色“HTM_FONT_ZOOM”:超文本的字体缩放级别“SHOW_MODAL”:控件的打印维护及打印设计的窗口modal模式varModeValue显示模式的值,整数或字符型,相关值如下:PREVIEW_IN_BROWSE的值:整数或字符型,1或“1"或“True”=是,否则不是。SETUP_IN_BROWSE的值:整数或字符型,1或“1”或“True”=是,否则不是。DESIGN_IN_BROWSE的值:整数或字符型,1或“1”或“True”=是,否则不是。BKIMG_IN_PREVIEW的值:整数或字符型,1或“1”或“True"=是,否则不是。BKIMG_IN_FIRSTPAGE的值:整数或字符型,1或“1”或“True"=是,否则不是。SETUP_ENABLESS的值:字符型,由“1”和“0”组成的字符串,最多14个字符,按如下顺序控制打印维护的界面功能,“1”—允许,“0”-禁止:位置移动和宽高调整1+颜色选择2+字体名选择3+字大小选择4+旋角调整5+粗斜体功能条6+线型功能条7+对齐功能条8+删除功能9+页眉设置10+页脚设置11+位置锁定功能12+属性设置13+显示关闭钮(界面内嵌时)14缺省的SETUP_ENABLES值:“11111111000001”例如:如想允许操作者“删除”对象,可以执行如下语句;29

16LODOP.SET_SHOW_MODE(”SETUP_ENABLES”,"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进制值组合,也可以是英文颜色名。HTM_FONT_ZOOM的值:整数型,表示超文本整体缩放程度,类似浏览器的“文字大小”的设置.0—最小1-较小2—中3—较大4-最大缺省值是2SHOW_MODAL的值:整数或字符型,1或“1”或“True”=是,否则不是。控件窗口按modal模式显示时,后面的脚本代码在控件窗口退出之前不执行.这种方式适合把控件放到独立的浏览器窗口中自动执行,并希望浏览器窗口在控件窗口关闭时也随之关闭的情况等。结果:返回逻辑结果,成功时返回真,失败时返回假.建议或要求:初始化之后,进入功能(打印预览、打印维护或打印设计)界面前调用本函数。SET_PRINT_MODE名称:设置打印模式格式:SET_PRINT_MODE(strModeType,varModeValue)功能:设置人工双面打印模式等。参数:strModeType模式类型名,字符型,如下是类型名及其含义:“DOUBLE_SIDED_PRINT”:设置是否人工双面打印。varModeValue模式类型值,整数或字符型,相关值如下:DOUBLE_SIDED_PRINT的值:整数或字符型,1或“1”或“True”=是,否则不是。结果:返回逻辑结果,成功时返回真,失败时返回假.建议或要求:直接打印前或打印预览前调用。SET_PREVIEW_WINDOW名称:设置预览窗口格式:SET_PREVIEW_WINDOW(intDispMode,intToolMode,blDirectPrint,inWidth,intHeight,strTitleButtonCaptoin)功能:设置预览窗口的显示模式和大小。参数:29

17intDispMode预览比例,数字型,0-适高1-正常大小2-适宽.intToolMode工具条和按钮,数字型0-显示工具条1-显示按钮2-两个都显示3-两个都不显示blDirectPrint打印按钮是否“直接打印”1-是0—否(弹出界面“选机打印”)inWidth窗口宽,整数型,单位是pxintHeight窗口高,整数型,单位是px当inWidth或intHeight小于等于0时窗口最大化。strTitleButtonCaptoin预览窗口和打印按钮的名称组合,字符型,用“点”分隔,譬如“预览查看.开始打印”,表示预览窗口的标题是“预览查看",按钮名是“开始打印”.结果:无建议或要求:直接打印前或打印预览前调用.ADD_PRINT_SETUP_BKIMG名称:指定背景图格式:ADD_PRINT_SETUP_BKIMG(strImgHtml)功能:用程序方式指定打印维护或打印设计的背景图.参数:strImgHtml:获得背景图的超文本代码,字符型,用IMG标签设定图片的URL和大小.结果:无建议或要求:初始化之后调用.SEND_PRINT_RAWDATA名称:发送原始数据格式:SEND_PRINT_RAWDATA(strRawData)功能:向打印机发送原始数据或指令。参数:strRawData:数据或指令值,字符型,未限制长度。结果:返回逻辑结果,发送成功时返回真,发送失败时返回假.建议或要求:任何时间调用。WRITE_PORT_DATA名称:写端口数据格式:WRITE_PORT_DATA(strPortName,strData)功能:直接向端口写数据或指令。29

18参数:strPortName:端口名,同操作系统的端口名,名称如下:LPT1、LPT2、LPT3、COM1、COM2、COM3…strData:数据或指令值,字符型,未限制长度。当设置端口通讯参数时strData格式如下:modecom1:波特率,校验,数据位,停止位,读时限,写时限其中mode为固定关键字,com1要和strPortName保持一直。校验值有:N(noparity)O(oddparity)E(evenparity)M(markparity)S(spaceparity)读时限和写时限的时间单位为毫秒,举例如下:WRITE_PORT_DATA(“com1”,“modecom1:2400,n,8,1”)或WRITE_PORT_DATA(“com2”,“modecom2:2400,n,7,2,5000,2000”)结果:返回逻辑结果,发送成功时返回真,发送失败时返回假。建议或要求:任何时间调用。READ_PORT_DATA名称:读端口数据格式:READ_PORT_DATA(strPortName)功能:直接从端口读数据。参数:strPortName:端口名,同操作系统的端口名,名称如下:LPT1、LPT2、LPT3、COM1、COM2、COM3…结果:返回字符数据。建议或要求:任何时间调用。GET_PRINT_INIFFNAME名称:获得配置文件名格式:GET_PRINT_INIFFNAME(strPrintTask)功能:获得某打印任务的本地配置文件全路径名。参数:strPrintTask:打印任务名,字符型,即初始化时所设的任务名。结果:返回字符返回字符结果表示本地配置文件全路径名(并非文件内容),空表示失败。建议或要求:在初始化之后调用。29

19WRITE_FILE_TEXT名称:写本地文件内容格式:WRITE_FILE_TEXT(intWriteMode,strFileName,strText)功能:向本地文件写入文本内容。参数:intWriteMode:写入模式,数字型,0(或其它)—文件覆盖模式1-文件尾追加模式2—文件首插入模式。strFileName:本地文件名,字符型,文件名包含全路径。strText:写入的文本内容,字符型.结果:调用函数后控件启动安全提示,等待操作许可。返回字符值表示写入情况:“ok”-写入成功“filenotexist”-文件不存在“donothing”-未写入,一般原因有:操作者禁止读写、文件只读属性等建议或要求:任何时间调用.GET_FILE_TEXT名称:读本地文件内容格式:GET_FILE_TEXT(strFileName)功能:读本地文件文本内容。参数:strFileName:本地文件名,字符型,含全路径。结果:调用函数后控件启动安全提示,等待操作许可。返回字符值,文本内容。返回空原因:文件不存在;内容真实空;操作者禁止读写;建议或要求:任何时间调用。GET_FILE_TIME名称:读本地文件时间格式:GET_FILE_TIME(strFileName)功能:读本地文件最后修改时间。参数:29

20strFileName:本地文件名,字符型,含全路径。结果:返回字符值,最后修改时间,时间样式:yyyy-mm—ddhh:mm:ss.返回空原因:文件不存在;建议或要求:任何时间调用.IS_FILE_EXIST名称:判断本地文件是否存在格式:IS_FILE_EXIST(strFileName)功能:判断本地文件是否存在。参数:strFileName:本地文件名,字符型,含全路径。结果:返回逻辑值,逻辑真表示文件存在,逻辑假表示文件不存在。建议或要求:任何时间调用.2、扩展函数SET_PRINT_PAPER名称:(扩展型)打印初始化格式:SET_PRINT_PAPER(intTop,intLeft,intWidth,intHeight,strPrintName)功能:打印初始化、设定纸张整体偏移量、设定可视编辑区域大小参数:intTop:整页上边距,整数型,单位是px,不设置时(用PRINT_INIT初始化)缺省值为0。IntLeft:整页左边距,整数型,单位是px,不设置时(用PRINT_INIT初始化)缺省值为0。IntWidth:可视编辑区域的宽度,整数型,单位是px,不设置时(用PRINT_INIT初始化)缺省为800pxintHeight:可视编辑区域的高度,整数型,单位是px,不设置时(用PRINT_INIT初始化)缺省为600pxstrPrintName:打印任务名,同PRINT_INIT的strTaskName。结果:返回逻辑值返回逻辑真表示初始化成功,逻辑假表示初始化失败,失败原因有:前一个打印事务没有完成;操作系统没有打印机(驱动)等建议或要求该函数与PRINT_INIT都有初始化功能,建议和要求同PRINT_INIT.29

21如果打印页有上边距或左边距要求,或可视编辑区域大小用实际纸张大小不合适时,调用本函数。ADD_PRINT_HTML名称:增加超文本打印项(图形模式)格式:ADD_PRINT_HTML(intTop,intLeft,intWidth,intHeight,strHtmlContent)功能:增加超文本打印项,设定该打印项在纸张内的位置和区域大小,实现超文本控制打印。参数:同ADD_PRINT_HTM结果:无建议或要求:图形模式打印速度快,但不适合要求文本打印质量高的情况,特别是要面对针式打印机.ADD_PRINT_TBURL名称:(扩展型)增加表格打印项(URL模式)格式:ADD_PRINT_TBURL(intTop,intLeft,intWidth,intHeight,strURL)功能:按URL地址增加一个超文本表格打印项,只输出第一个table元素显示内容。功能同ADD_PRINT_TABLE参数:同ADD_PRINT_URL结果:无建议或要求:要求在打印初始化后调用,建议在画线类函数之后调用。ADD_PRINT_TEXTA名称:(扩展型)增加纯文本打印项格式:ADD_PRINT_TEXTA(strItemName,intTop,intLeft,intWidth,intHeight,strContent)功能:同函数ADD_PRINT_TEXT。参数:strItemName:所增纯文本打印项的项目名,字符型,未限制长度。其它参数同函数ADD_PRINT_TEXT.结果:同函数ADD_PRINT_TEXT。建议或要求:建议和要求同函数ADD_PRINT_TEXT.当打印项序号比较难以控制时,用本函数。29

22SET_PRINT_STYLEA名称:(扩展型)设置打印项风格A格式:SET_PRINT_STYLEA(varItemNameID,strStyleName,varStyleValue)功能:类似函数SET_PRINT_STYLE的功能,二者的区别是本函数只对某打印项有效.参数:varItemNameID:要设置的目标项序号或项目名,数字型或字符型。l数字型时,表示是序号,以其增加的先后自然顺序为准,从1开始,所有打印对象都参与排序,包括超文本、纯文本、矩形线、椭圆线、直线等。l字符型时,表示是打印项的项目名,见ADD_PRINT_TEXTA的strItemNamestrStyleName:打印风格名,风格名称及其含义如下:“PageIndex”:指定输出页的序号控制字。“PreviewOnly”:指定内容仅仅用来预览。其它见SET_PRINT_STYLEvarStyleValue:打印风格值,相关值如下:PageIndex的值:字符型,用该序号字指定本数据项输出到哪些页。“First”第一页;“Last”最后页;“Odd”奇数页;“Even”偶数页;“具体数字"对应具体页;空表示默认页。缺省值是空。PreviewOnly的值:字符或数字型,1或true代表仅预览,否则为正常内容。其它见SET_PRINT_STYLE结果:同函数SET_PRINT_STYLE。建议或要求:同函数SET_PRINT_STYLE。SET_PRINT_TEXT_STYLEA名称:(扩展型)设置文本风格A格式:SET_PRINT_TEXT_STYLEA(varItemNO,strFontName,intSize,intBold,intItalic,intUnderline,intAlign,varColor)功能:设置某纯文本项的打印风格。参数:varItemNO:要设置的目标项序号或项目名,数字型或字符型.l数字型时,表示是序号,以其增加的先后自然顺序为准,从1开始,所有打印对象都参与排序,包括超文本、纯文本、矩形线、椭圆线、直线等。l字符型时,表示是打印项的项目名,见ADD_PRINT_TEXTA的strItemNamestrFontName:29

23设定该文本打印项的字体名,字符型,与操作系统字体名一致,缺省(不调用本函数时)字体是“宋体”。intSize:设定该文本打印项的字体大小,数字型,单位是pt,缺省值是9。intBold:设定该文本打印项是否粗体,数字型,1代表粗体,0(或非1)代表非粗体,缺省值是0。intItalic:设定该文本打印项是否斜体,数字型,1代表斜体,0(或非1)代表非斜体,缺省值是0。intUnderline:设定该文本打印项是否下划线,数字型,1代表有下划线,0(或非1)代表无下划线,缺省值是0。intAlign:文本内容在打印区域内靠齐方式,数字型,1(或其它)-左靠齐2—居中3-右靠齐,缺省值是1.varColor:打印项的颜色,整数或字符型,整数时是颜色的十进制RGB值;字符时是超文本颜色值,可以是“#"加三色16进制值组合,也可以是英文颜色名;结果:无建议或要求:要求在目标对象增加(ADD_PRINT_TEXT)后调用本函数。ADD_PRINT_SHAPE名称:(扩展型)增加图形格式:ADD_PRINT_SHAPE(intShapeType,intTop,intLeft,intWidth,intHeight,intLineStyle,intLineWidth,varColor)功能:增加矩形框、椭圆、直线等图形打印项,设定该图形在纸张内的位置和大小,设定线条的类型和线条宽度。参数:intShapeType:该图形的类型,数字型参数。0(或其它)-仰角直线1-俯角直线2-矩形框线3—椭圆线4—实心矩形5—实心椭圆intTop:该图形在纸张内的上边距,整数型,单位是px。当上边距超过纸张高度时,打印项被输出在下一页(或更下页)。IntLeft:该图形在纸张内的左边距,整数型,单位是px.intWidth:该图形(直线的外缘矩形或椭圆的外缘矩形)的宽度,整数型,单位是px。intHeight:该图形(直线的外缘矩形或椭圆的外缘矩形)的高度,整数型,单位是px.intLineStyle:线条类型,数字型,0(或其它)代表实线1-破折线2-点线3-点划线4-29

24双点划线缺省线条是实线.intLineWidth:线条宽,整数型,单位是px,缺省值是1px,非实线的线条宽也是1px。varColor:图形的颜色,整数或字符型,整数时是颜色的十进制RGB值;字符时是超文本颜色值,可以是“#”加三色16进制值组合,也可以是英文颜色名;结果:无建议或要求:要求在打印初始化后调用,建议在文本类函数之前调用。SET_PRINTER_INDEXA名称:(扩展型)指定打印设备格式:SET_PRINTER_INDEXA(strPrinterName)功能:同函数SET_PRINTER_INDEX。按名称指定打印设备.参数:strPrinterName:打印设备名称,字符型.注:函数GET_PRINTER_NAME可获得打印设备名。结果:同函数SET_PRINTER_INDEX.建议或要求:同函数SET_PRINTER_INDEX。PREVIEWA名称:(扩展型)打印预览A格式:PREVIEWA()功能:同函数PREVIEW。预览前提示选择打印机。参数:同函数PREVIEW.结果:同函数PREVIEW。建议或要求:同函数PREVIEW.PREVIEWB名称:(扩展型)打印预览B格式:PREVIEWB()功能:同函数PREVIEW.强制用缺省布局风格来打印预览。参数:同函数PREVIEW。结果:同函数PREVIEW。建议或要求:29

25同函数PREVIEW。不希望最终使用者改变打印布局和风格时调用本函数。PRINTA名称:(扩展型)直接打印A格式:PRINTA()功能:同函数PRINT。打印前提示选择打印机。参数:同函数PRINT。结果:同函数PRINT.返回逻辑结果,当真实打印时返回真,放弃打印或打印出错时返回假。建议或要求:同函数PRINTA。PRINTB名称:(扩展型)直接打印B格式:PRINTB()功能:同函数PRINT.强制用缺省布局风格来打印。参数:同函数PRINT。结果:同函数PRINT。建议或要求:同函数PRINT。不希望最终使用者改变打印布局和风格时调用本函数.SET_LICENSES名称:设置软件产品注册信息格式:SET_LICENSES(strCompanyName,strLicense,strLicenseA,strLicenseB)功能:以函数方式设置软件使用权注册信息,功能与对应的控件参数一样。参数:strCompanyName:注册单位名称,用途与控件参数CompanyName一样。strLicense:主注册号,用途与控件参数License一样。strLicenseA:附加注册号A,用途与控件参数LicenseA一样.strLicenseB:附加注册号B,用途与控件参数LicenseB一样。结果:无建议或要求:任何时间调用,本函数适合以隐蔽方式设置注册信息。29

26五、软件使用权注册打印控件Lodop是一款专业共享软件,公开发行版本没有功能限制,多数用户可免费长期使用,仅如下情况需要注册使用权:当希望用到(不经过打印预览的)“直接打印"功能时需注册,否则在使用该功能时,打印结果的左下角会出现“本页由【试用版打印控件LodopX.0】输出"小字样。软件使用权的注册设置,除了用SET_LICENSES函数外,一般用如下几个控件参数(调用方法参阅第三节):CompanyName名称:设置注册单位名称格式:功能:该名称配合License实现按使用者单位名称注册。这种注册不限制域名,注册者可把Lodop用于多个WEB工程,适合软件开发公司注册。License名称:设置注册号格式:〈paramname=”License"value="注册号XXX">功能:该注册号有两项功能:一、当CompanyName不空时,该注册号配合其实现按使用者单位名称注册。这种注册不限制域名,注册者可把Lodop用于多个WEB工程,适合软件开发公司注册。二、当CompanyName空时,这是域名注册号之一,一般是域名的名称注册号。这种注册只限该域名使用,价格便宜,适合最终使用单位注册。LicenseA名称:设置附加注册号A格式:〈paramname=”LicenseA”value="附加注册号A”>功能:当CompanyName空时,这是域名注册号之二,一般是内网IP注册号,随主注册号免费赠送。29

27LicenseB名称:设置附加注册号B格式:〈paramname="LicenseB"value=”附加注册号B">功能:当CompanyName空时,这是域名注册号之三,一般是外网IP注册号,随主注册号免费赠送。六、打印维护和打印设计打印设计的目标用户是软件开发者,详细功能解释略.打印维护的目标用户是页面操作者,详细功能解释略。七、使用样例演示样例清单如下(样例内容参见发行包):1。如何在页面内嵌入控件见样例一2.如何裁剪打印当前页面内容见样例二3.如何用代码生成打印页见样例三4.如何打印设计和定位套打见样例四5。如何控制纸张大小和连续打印见样例五6。如何打印多页长文档及双面打印见样例六7.如何定向输出见样例七8.如何打印图片见样例八9.如何用程序加载打印维护背景图见样例九10如何控制打印样式(STYLE)见样例十11如何打印条码图案见样例十一12如何读写本地文件见样例十二13如何打印旋转内容见样例十三14如何按URL打印见样例十四15如何打印表格的页头页尾见样例十五16如何设置预览窗口大小见样例十六17如何发打印机指令或直接写端口见样例十七18如何打印幅面高度不固定的票据见样例十八19如何内嵌显示及预览时包含背景图见样例十九20如何一次性预览多页卡片见样例二十21如何控制打印维护的功能权限见样例二十一22如何构建自己的纯WEB打印预览见样例二十二29

28八、计量单位本文所述px单位固定换算关系如下,与像素类似但不是一个概念,也不受显示影响:1英寸=2。54厘米=25.4毫米=96px<完〉29

当前文档最多预览五页,下载文档查看全文

此文档下载收益归作者所有

当前文档最多预览五页,下载文档查看全文
温馨提示:
1. 部分包含数学公式或PPT动画的文件,查看预览时可能会显示错乱或异常,文件下载后无此问题,请放心下载。
2. 本文档由用户上传,版权归属用户,天天文库负责整理代发布。如果您对本文档版权有争议请及时联系客服。
3. 下载前请仔细阅读文档内容,确认文档内容符合您的需求后进行下载,若出现内容与标题不符可向本站投诉处理。
4. 下载文档时可能由于网络波动等原因无法下载或下载错误,付费完成后未能成功下载的用户请联系客服处理。
最近更新
更多
大家都在看
近期热门
关闭