LODOP41.040技术手册

WEB打印控件Lodop技术手册Ver 4.0.4.0Email: gungho999QQ: 932131686Caoyanqing 2009目 录一、概述3二、系统文件3install_lodop.exe4CheckActivX.js4npActiveX0712SFx31.xpi5三、控件参数5CompanyName5License5LicenseA6LicenseB6四、功能函数6基本函数6VERSION6PRINT_INIT7SET_PRINT_PAGESIZE7ADD_PRINT_HTM8ADD_PRINT_TABLE8ADD_PRINT_URL9ADD_PRINT_TEXT9ADD_PRINT_IMAGE10ADD_PRINT_RECT10ADD_PRINT_ELLIPSE11ADD_PRINT_LINE11SET_PRINT_STYLE12PREVIEW13PRINT13PRINT_SETUP14PRINT_DESIGN14GET_PRINTER_COUNT14GET_PRINTER_NAME14SET_PRINTER_INDEX15SELECT_PRINTER15SET_SHOW_MODE15SET_PREVIEW_WINDOW16ADD_PRINT_SETUP_BKIMG16SEND_PRINT_RAWDATA17WRITE_PORT_DATA17GET_PRINT_INIFFNAME17WRITE_FILE_TEXT18GET_FILE_TEXT18GET_FILE_TIME18IS_FILE_EXIST19扩展函数19SET_PRINT_PAPER19ADD_PRINT_HTML20ADD_PRINT_TBURL20ADD_PRINT_TEXTA20SET_PRINT_ STYLEA21SET_PRINT_TEXT_STYLEA21ADD_PRINT_SHAPE22SET_PRINTER_INDEXA23PREVIEWA23PREVIEWB23PRINTA23PRINTB24SET_LICENSES24五、打印维护和打印设计24六、使用样例24七、计量单位25一、概述Lodop是一款专业的WEB打印控件，其设计目标是简单易用、功能足够强大，开创WEB打印开发的新局面。Lodop设计者对WEB下的打印开发任务进行了分类汇总，高度抽象，设计出仅用几个功能函数，就可实现复杂的打印任务，尽量减少使用者的知识累赘。控件发布包有3个系统文件组成，全部功能用4个控件参数和2组功能函数来实现。尽管我们有个理想化的目标，那就是您不用详细了解这些参数或函数，仅仅看懂几个样例文件就能很轻松地开始使用本控件，为此Lodop提供了一个足够完善的设计界面，用它可以实现大多数打印开发任务，但事实上了解这些参数和函数总还是有好处的，特别是当你的开发任务很复杂时，这就是本文目的，但愿本文档足够详细且简单明了。如果此前曾看过lodop的入门样例程序，本文会更容易理解！二、系统文件Lodop发布包内主要有如下三个文件：install_lodop.exe该文件是控件安装和升级的主文件，提供给用户或开发者下载安装，如果不特意拦截一般都能100%安装，对“网页插件安装难”有一定改善。如果将其复制或改名为uninstall_lodop.exe (名前加un)就可用其卸载控件。Lodop安装后，在操作系统目录WINDOWSsystem32下会安装一个OCX文件：CAOSOFT_WEB_PRINT_LODOP.OCX，有特殊需要的使用者可以将该文件自主签名，用传统的OCX安装方式发布。CheckActivX.js该文件是用来引导安装控件的一个JS文件，是个样例，但建议直接采用。其中CheckLodop的任务是检查控件是否安装、是否最新版本、并引导安装或升级。文件内容如下：function CheckLodop() var oldVersion=LODOP.Version; newVerion=4.0.0.0; if (oldVersion=null)document.write(打印控件未安装!点击这里执行安装,安装后请刷新页面。);if (navigator.appName=Netscape)document.write(（Firefox浏览器用户需先点击这里安装运行环境）); else if (oldVersionnewVerion)document.write(打印控件需要升级!点击这里执行升级,升级后请重新进入。);其中的关键点是Version函数，Lodop提供了一个“读版本号”功能，这样控件的安装和升级任务就交给JS来实现，以下是控件在页面内的调用代码，其中包含CheckLodop的利用： CheckLodop();以上两段代码相互配合实现了Lodop的安装、调用和升级。之所以将CheckActivX.js作为一个资源文件来部署，既可以利用浏览器的缓存减少页面内容的重复下载，同时还实现了控件发布统一管理，整个应用系统中只要这一个地方发布Lodop。其它页面直接拷贝嵌入第2段代码就可以了。npActiveX0712SFx31.xpi该文件是Firefox浏览器需要的安装附加文件。目前Lodop支持IE系列浏览器、Firefox系列浏览器和IE内核类浏览器(遨游、腾讯TT、麒麟、世界之窗等)及其它支持ActiveX的各类浏览器。三、控件参数Lodop有如下4个控件参数,主要用于软件注册，以网页插件(ActiveX)参数形式使用：CompanyName名称：设置注册单位名称格式：功能：该名称配合License实现按使用者单位名称注册。这种注册不限制域名，注册者可把Lodop用于多个WEB工程，适合软件开发公司注册。License名称：设置注册号格式：功能：该注册号有两项功能：一、 当CompanyName不空时，该注册号配合其实现按使用者单位名称注册。这种注册不限制域名，注册者可把Lodop用于多个WEB工程，适合软件开发公司注册。二、当CompanyName空时，这是域名注册号之一，一般是域名的名称注册号。这种注册只限该域名使用，价格便宜，适合最终使用单位注册。LicenseA名称：设置附加注册号A格式：功能：当CompanyName空时，这是域名注册号之二，一般是内网IP注册号，随主注册号免费赠送。LicenseB名称：设置附加注册号B格式：功能：当CompanyName空时，这是域名注册号之三，一般是外网IP注册号，随主注册号免费赠送。四、功能函数Lodop的功能函数不多，但参数比较复杂。全部函数分“基本函数”和“扩展函数”两类，两类函数有类似性，基本函数使用简单，达不到要求时请使用扩展函数，二者无本质区别。基本函数VERSION 名称：获得软件版本号格式：VERSION结果：返回字符型结果版本号有四个数字组成，样式为：X.X.X.XPRINT_INIT名称：打印初始化格式：PRINT_INIT(strTaskName)功能：初始化运行环境，清理异常打印遗留的系统资源，设定打印任务名。参数：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的相同功能。结果：无建议或要求：打印初始化之后调用。如果打印纸张不固定，希望由操作者自主选择纸张时，则不要调用本函数。ADD_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：超文本代码内容，字符型，未限制长度。可以是一个完整的页面，也可以是代码段。结果：无建议或要求：要求在打印初始化后调用，建议在画线类函数之后调用。ADD_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：纯文本内容，字符型，未限制长度。结果：无建议或要求：要求在打印初始化后调用，建议在画线类函数之后调用。ADD_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。结果：无建议或要求：要求在打印初始化后调用，建议在文本类函数之前调用。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。当上边距超过纸张高度时，打印项被输出在下一页(或更下页)。IntLeft2：端点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”：线条风格。varStyleValue：打印风格值，相关值如下：FontName的值： 字符型，与操作系统字体名一致，缺省是“宋体”。FontSize的值：数字型，单位是pt，缺省值是9。FontColor的值：整数型，颜色的十进制RGB值。Bold的值：数字型，1代表粗体，0代表非粗体，缺省值是0。Italic的值：数字型，1代表斜体，0代表非斜体，缺省值是0。Underline的值：数字型，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-双点划线 缺省线条是实线。结果：无建议或要求：打印初始化后、增加打印项之前调用本函数。PREVIEW名称：打印预览格式：PREVIEW()功能：打印预览输出页。参数：无结果：弹出打印预览界面，详见打印预览说明。建议或要求：建立打印页之后运行。PRINT名称：直接打印格式：PRINT()功能：不经打印预览的直接打印。参数：无结果：打印机开始实际打印，返回逻辑结果，正确打印时返回真，打印出错时返回假。建议或要求：建立打印页之后运行。PRINT_SETUP名称：打印维护格式：PRINT_SETUP()功能：对整页的打印布局和打印风格进行界面维护，它与打印设计的区别是不具有打印项增删功能，目标使用者是最终用户。参数：无结果：弹出打印维护界面，详见打印维护说明。建议或要求：建立打印页之后运行。PRINT_DESIGN名称：打印设计格式：PRINT_DESIGN ()功能：对整页的打印布局和打印风格进行界面设计，它与打印维护的区别是具有打印项增删功能，目标使用者是开发者。参数：无结果：弹出打印设计界面，详见打印设计说明。建议或要求：建立打印页之后运行。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。结果：返回逻辑值返回逻辑真表示指定成功，逻辑假表示指定失败，失败原因有：该打印设备不存在。建议或要求：直接打印前或打印预览前调用。SELECT_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”： 打印预览时是否包含背景图。varModeValue模式类型值，变量型，相关值如下：PREVIEW_IN_BROWSE的值：变量型，1或“1”-表示是 其它表示不是。SETUP_IN_BROWSE的值：变量型，1或“1”-表示是 其它表示不是。DESIGN_IN_BROWSE的值：变量型，1或“1”-表示是 其它表示不是。BKIMG_IN_PREVIEW的值：变量型，1或“1”-表示是 其它表示不是。结果：无建议或要求：进入功能（打印预览、打印维护或打印设计）界面前调用本函数。SET_PREVIEW_WINDOW名称：设置预览窗口格式：SET_PREVIEW_WINDOW(intDispMode, intToolMode,blDirectPrint,inWidth,intHeight, strTitleButtonCaptoin)功能：设置预览窗口的显示模式和大小。参数：intDispMode 预览比例，数字型，0-适高1-正常大小2-适宽。intToolMode工具条和按钮，数字型 0-显示工具条1-显示按钮 2-两个都显示 3-两个都不显示 blDirectPrint打印按钮是否“直接打印” 1-是 0-否（弹出界面“选机打印”）inWidth 窗口宽，整数型，单位是px intHeight 窗口高，整数型，单位是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)功能：直接向端口写数据或指令。参数：strPortName：端口名，同操作系统的端口名称，如LPT1COM1等。strData：数据或指令值，字符型，未限制长度。结果：返回逻辑结果，发送成功时返回真，发送失败时返回假。建议或要求：任何时间调用。GET_PRINT_INIFFNAME名称：获得配置文件名格式：GET_PRINT_INIFFNAME (strPrintTask)功能：获得某打印任务的本地配置文件全路径名。参数：strPrintTask：打印任务名，字符型，即初始化时所设的任务名。结果：返回字符返回字符结果表示本地配置文件全路径名（并非文件内容），空表示失败。建议或要求：在初始化之后调用。WRITE_FILE_TEXT名称：写本地文件内容格式：WRITE_FILE_TEXT(intWriteMode,strFileName, strText)功能：向本地文件写入文本内容。参数：intWriteMode：写入模式，数字型，0(或其它)-文件覆盖模式 1-文件尾追加模式 2-文件首插入模式。strFileName：本地文件名，字符型，文件名包含全路径。strText：写入的文本内容，字符型。结果：调用函数后控件启动安全提示，等待操作许可。返回字符值表示写入情况：“ok”-写入成功“file not exist”-文件不存在“do nothing”-未写入，一般原因有：操作者禁止读写、文件只读属性等建议或要求：任何时间调用。GET_FILE_TEXT名称：读本地文件内容格式：GET_FILE_TEXT(strFileName)功能：读本地文件文本内容。参数：strFileName：本地文件名，字符型，含全路径。结果：调用函数后控件启动安全提示，等待操作许可。返回字符值，文本内容。返回空原因：文件不存在；内容真实空；操作者禁止读写；建议或要求：任何时间调用。GET_FILE_TIME名称：读本地文件时间格式：GET_FILE_TIME (strFileName)功能：读本地文件最后修改时间。参数：strFileName：本地文件名，字符型，含全路径。结果：返回字符值，最后修改时间，时间样式：yyyy-mm-dd hh:mm:ss。返回空原因：文件不存在；建议或要求：任何时间调用。IS_FILE_EXIST名称：判断本地文件是否存在格式：IS_FILE_EXIST (strFileName)功能：判断本地文件是否存在。参数：strFileName：本地文件名，字符型，含全路径。结果：返回逻辑值，逻辑真表示文件存在，逻辑假表示文件不存在。 建议或要求：任何时间调用。扩展函数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。如果打印页有上边距或左边距要求，或可视编辑区域大小用实际纸张大小不合适时，调用本函数。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。当打印项序号比较难以控制时，用本函数。SET_PRINT_ STYLEA名称：(扩展型) 设置打印项风格A格式：SET_PRINT_ STYLEA(varItemNameID, strStyleName,varStyleValue)功能：类似函数SET_PRINT_ STYLE的功能，二者的区别是本函数只对某打印项有效。参数：varItemNameID：要设置的目标项序号或项目名，数字型或字符型。l 数字型时，表示是序号，以其增加的先后自然顺序为准，从1开始，所有打印对象都参与排序，包括超文本、纯文本、矩形线、椭圆线、直线等。l 字符型时，表示是打印项的项目名，见ADD_PRINT_TEXTA的strItemName其它参数同函数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,intColor)功能：设置某纯文本项的打印风格。参数：varItemNO：要设置的目标项序号或项目名，数字型或字符型。l 数字型时，表示是序号，以其增加的先后自然顺序为准，从1开始，所有打印对象都参与排序，包括超文本、纯文本、矩形线、椭圆线、直线等。l 字符型时，表示是打印项的项目名，见ADD_PRINT_TEXTA的strItemNameStrFontName：设定该文本打印项的字体名，字符型，与操作系统字体名一致，缺省（不调用本函数时）字体是“宋体”。IntSize：设定该文本打印项的字体大小，数字型，单位是pt，缺省值是9。IntBold：设定该文本打印项是否粗体，数字型，1代表粗体，0（或非1）代表非粗体，缺省值是0。IntItalic：设定该文本打印项是否斜体，数字型，1代表斜体，0（或非1）代表非斜体，缺省值是0。IntUnderline：设定该文本打印项是否下划线，数字型，1代表有下划线，0（或非1）代表无下划线，缺省值是0。IntAlign：文本内容在打印区域内靠齐方式，数字型，1(或其它)-左靠齐 2-居中 3-右靠齐，缺省值是1。intColor：打印项的颜色，整数型，颜色的十进制RGB值。结果：无建议或要求：要求在目标对象增加(ADD_PRINT_TEXT)后调用本函数。ADD_PRINT_SHAPE名称：(扩展型)增加图形格式：ADD_PRINT_SHAPE(intShapeType, intTop, intLeft,intWidth,intHeight,intLineStyle,intLineWidth, intColor)功能：增加矩形框、椭圆、直线等图形打印项，设定该图形在纸张内的位置和大小，设定线条的类型和线条宽度。参数：intShapeType：该图形的类型，数字型参数。0(或其它)-仰角直线 1-俯角直线 2-矩形框线 3-椭圆线 4-实心矩形 5-实心椭圆intTop：该图形在纸张内的上边距，整数型，单位是px。当上边距超过纸张高度时，打印项被输出在下一页(或更下页)。IntLeft：该图形在纸张内的左边距，整数型，单位是px。intWidth：该图形(直线的外缘矩形或椭圆的外缘矩形)的宽度，整数型，单位是px。intHeight：该图形(直线的外缘矩形或椭圆的外缘矩形)的高度，整数型，单位是px。intLineStyle：线条类型，数字型，0(或其它)代表实线 1破折线 2点线 3点划线 4双点划线缺省线条是实线。intLineWidth：线条宽，整数型，单位是px，缺省值是1px，非实线的线条宽也是1px。结果：无建议或要求：要求在打印初始化后调用，建议在文本类函数之前调用。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。建议或要求：同函数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一样。结果：无建议或要求：任何时间调用，本函数适合以隐蔽方式设置注册信息。五、打印维护和打印设计打印设计的目标用户是软件开发者，详细功能解释略。打印维护的目标用户是页面操作者，详细功能解释略。六、使用样例演示样例清单如下：样例内容参见发行包1. 如何在页面内嵌入控件见样例一 2. 如何裁剪打印当前页面内容见样例二 3. 如何用代码生成打印页见样例三 4. 如何打印设计和定位套打见样例四 5. 如何控制纸张大小见样例五 6. 如何打印多页长文档见样例六 7. 如何定向输出见样例七 8. 如何打印图片见样例八 9. 如何用程序加载打印维护背景图见样例九 10 如何控制打印样式(STYLE)见样例十 11 如何打印条码图案见样例十一 12 如何读写本地文件见样例十二 13 如何打印旋转内容见样例十三 14如何按URL打印见样例十四15如何打印表格的页头页尾见样例十五16如何设置预览界面见样例十六七、计量单位本文所述px单位换算如下：1英寸=2.54厘米=25.4毫米=96px(固定)