《jatoolsPrinter使用手册》由会员分享，可在线阅读，更多相关《jatoolsPrinter使用手册（62页珍藏版）》请在金锄头文库上搜索。
1、jatoolsPrinter 使用手册使用手册（更新日期：2012-11-13）简介安装快速入门最简单的打印预览打印前设置打印参数保留打印时的打印参数第一次打印用当前配置，后续打印用最后一次打印配置批量打印文档多个文档共存在同一 web 页面中，区别打印不显示文档，直接指定 url 打印打印隐藏对象仅在预览时可见，不输出到打印机的套打底图打印时样式类的自动插入(实现不打印表格线等)样式文件(*.css)的显式导入 打印结束后提交数据为什么要使用回调方法打印后关闭窗口可视化设计套打 视频演示 打印内容相对位置的事后调整及保存 视频演示调整后的套打位置信息保存到服务端连续打印的套打偏移校正 使用自
2、动分页表格自动分页，表头每页可见页内多表自动分页含合并单元格的表格自动分页 表格的横向自动分页 大单元格分页自动缩放打印指定缩放比例打印零边距打印预览时提示生成监视打印任务状态手动双面打印模式自动双面打印模式打印份数控制打印指定页 监听打印页数事件显示页面设置对话框后打印选择打印机进行打印选择打印机,纸张类型,边距进行打印纵横打印(有些页纵向打印，有些横打) Excel 导出 打印非 HTML 文档(*.doc,*.xls,*.ppt,*.pdf)附件方式打印非 HTML 文档(*.doc,*.xls,*.ppt,*.pdf)打印 TIFF 文件 设置图文并茂的页脚页眉个性化的页脚页眉(首页不
3、打印页脚页眉)一次打印中的页号分组指定显示的起始页号取本地 MAC 地址取 CPU 序列号用控件设置 IE 打印背景使用插件，使 jatoolsPrinter 支持 firefox、chrome、safari 支持繁体中文、英文、日文等界面附录：API 参考手册简简介介:jatoolsPrinter 是一款实现网页套打的专门工具。作为 web 应用开发者，我们经常会遇到在浏览器中打印报表、票据的需求，浏览器本身 提供的打印功能一般不能满足这些需求，如精确分页，套打等。jatoolsPrinter 正是为了解决这些需求而专门研发的。使用 jatoolsPrinter 可以最大限度地实现对 web
4、 页面的打印控制，比如，输出到哪个打印机，什么纸张类型，是否打印附件等。设置图文并茂的页眉、页脚，自动分页或程序分页。你也可以利用 jatoolsPrinter 随心所欲地定制出自己的打印设置界面，更好地满足项目需求。jatoolsPrinter 不同于报表工具，它只解决 web 客户端的 html 页面的打印问题，至于这些页面如何生成，格式怎样需要你自己做后端的开发（使用 jsp,asp,或 php 等） ，因此，你可以有很大的自由度来定制格式。jatoolsPrinter 也没有可视化的票据或报表设计工具，而一般报表工具都有可视化的报表设计器。jatoolsPrinter 只需要在 web
5、 服务器的一个目录中，放置一个控件文件即算配置完成，而报表工具一般在服务端需要配置报表服务引擎。jatoolsPrinter 是本公司报表产品杰表的一个组件，2006 年起单独发展成品。如果你需要可视化的套打设计工具、各种格式(Excel,pdf)导出、表格无折断分页等更为强大的功能，建议你采用本公司的报表产品，杰表.2008。安安装装:服务端：可以是任何操作系统，任何 web 服务器，比如iis、tomcat、weblogic、websphere 等。客户端：windows 操作系统（除 win95/98 外），Internet Explorer5.5 及以上版本。1. 服务端 先来看一个示
6、例网页 test.htm. .如果你访问该网页的地址是: http:/ 则你必须将 jatoolsPrinter.cab 放在 http:/ 可以访问到的地方。总之，jatoolsPrinter.cab 位置，需要根据当前网页路径与 codebase 属性，来确定。请体会以下示例： 例一、 网页地址： http:/ codebase 属性： xyz/jatoolsPrinter.cab#version=5,7,0,0 jatoolsPrinter.cab 地址： http:/ 例二、 网页地址： http:/ codebase 属性： /jatoolsPrinter.cab#version=5
7、,7,0,0 jatoolsPrinter.cab 地址： http:/ 2. 浏览器端 当你访问使用打印控件的网页时，浏览器将从服务器上下载控件，自动安装到 ie 中。 当然，如果你的 IE 安全设置过高，也可能不能自动安装，这时，你需要改变 IE 的安全设置，或进行离线安装。如果你需要离线安装，可以向我们申请离线安装包。 IE 安全设置方法如下：IE 浏览器-工具- internet 选项-安全-自定义级别，设置下载未签名的 ActiveX 为启用状态。如下图所示：注：注：jatoolsPrinter 4.0 以后的版本，都经过微软认证的签名，因此，多数情况下无须设置 IE安全属性。快快速
8、速入入门门我们先来设计一个 web 页面，如下所示： 我的第一个打印文档 发票 1 金额:80 发票 2 金额:100 在这个文档中，有两个 div 对象，假设每个 div 中包括一张要打印的发票，现在要求是把这两张发票打印出来，而且，一张发票占据一页，如果你使用 ie 自带的打印菜单来打印，有可能只打印一页，有可能打印超过两页，有可能发票打印到一半时就分页，总之，如何分页取决于打印纸张的大小，及发票的大小，你不能控制页数及分页位置。那么，jatoolsPrinter 是如何处理这样的需求的呢？首先，我们在页面中插入这个控件，如下所示。 我的第一个打印文档 codebase=“jatoolsP
9、rinter.cab#version=5,7,0,0“ 发票 1 金额:80 发票 2 金额:100 其次，调用控件的 print 方法实现打印，如下所示： function doPrint() myDoc = documents:document; / 要打印的 div 对象在本文档中，控件将从本文档中的 id 为 page1 的 div 对象，作为首页打印 / id 为 page2 的作为第二页打印 ; jatoolsPrinter.print(myDoc,false); / 直接打印，不弹出打印机设置对话框 由上可见，你打印若干 div 对象时，需要告诉控件，这些 div 们所属的文档对
10、象(html 的document 对象)，另外，这些 div 对象的 id，也需要按 page+序号 的规则命名，序号从1 开始计，也就是说，id 为page1的 div 对象，总是作为首页打印。这些设置使用一个javascript 对象来描述，也就是上面的 myDoc 对象，下面是完整的 html 代码： 我的第一个打印文档 function doPrint() myDoc = documents:document, / 要打印的 div 对象在本文档中，控件将从本文档中的 id 为 page1 的 div 对象，作为首页打印 / id 为 page2 的作为第二页打印 copyrights
11、:杰创软件拥有版权 / 版权声明,必须 ; jatoolsPrinter.print(myDoc,false); / 直接打印，不弹出打印机设置对话框 发票 1 金额:80 发票 1 金额:100 运行示例最后，有几点需要说明：1. 控件在打印指定 div 对象时，如果纸张太小不够打印时，超出部分将被截掉(clip)。如果你不想被截掉，你可以使用自动分页功能，参照自动分页打印，如果是一个大表格，想分析打印，参照表格分析打印功能。 。 2. 被指定的 div 中的内容，可以是 html 任何可见对象，图片，flash，或文本等等。 3. 控件打印时，边距可设，不设则取打印机默认值。 4. di
12、v 的 id 必须连续，如果你的 div，存在 page1、page2、page4，而不存在page3，则控件只打印前两页，page4不会被打印。 5. div 对象在页面中的位置，可以是随意的，比如，page1 显示在 page2 后面，也是合法的。 6. 指定的 div 会被打印，没被指定的 html 元素将不会被打印，比如，本示例中的打印按钮，不会被打印。 7. copyrights 属性是版权信息，必须写。 8. 一个 div 打印成一页，这种分页方法称之为预分页方式，或称为套打分页方式。除此之外，控件也支持自动分页方式，即可以将一个内容较多的网页，由控件自动按纸张大小来分页，方法是使
13、用 autoBreakPage 属性，具体参照下文。9. 控件打印时，将不会打印 ie 默认的页脚页眉(ie 通常在上面显示网页的网址，网页标题等)，多数情况下是不必要的，当然，如果你确实需要页脚页眉，你也可以自己定义，具体方法参照下文。最最简简单单的的打打印印预预览览 下面是一个最简单的打印，打印按默认设置进行。 运行此示例/打印文档对象 var myDoc = documents: document, / 打印页面(div)们在本文档中 copyrights : 杰创软件拥有版权 / 版权声明必须 ; . jatoolsPrinter.print(myDoc,false); 打打印印前前
14、设设置置打打印印参参数数 你可以打印前设置打印参数，如设置输出的打印机，打印方向，纸张大小。 运行此示例/打印文档对象 var myDoc = settings: / 如果想使用默认打印机,不需要设置 / printer: 联想激打, / 指定纸张的高宽以十分之一毫米为单位,本设置实际是指定为 a4 大小 paperWidth : 2100, paperHeight : 2970, / 指定打打印方向为横向, 1/2 = 纵向/横向 orientation : 2 , documents: document, / 打印页面(div)们在本文档中 copyrights : 杰创软件拥有版权 /
15、 版权声明必须 ; 保保留留打打印印时时的的打打印印参参数数 可以保留打印时的打印参数，待下一次打印同一文档时自动配置打印参数 。 运行此示例/打印文档对象 var myDoc = /待保留的打印设置 id,打印后将被保存在注册表中, /下一次启动相同值的 settingsID,打印文档时, /控件将用保留的参数,自动设置打印机 settingsID:“mysettings1“, documents: document, copyrights : 杰创软件拥有版权 ; 为什么需要保存设置功能为什么需要保存设置功能?保存设置功能，通常用在以下两种情况：（1）一个套打系统，由于各客户端打印机不同，或者进纸盒的位置不同，或者其他原因，可能引起打印出来的票据位置发生偏移，用户希望能根据自己打印机的状况，自行调整边距以纠正位置，但不希望每次打印前，都进行一次手工调整。（2）一个客户端配置了多台打印机，分别
