1         安装

1.         下载试用版 http://print.jatools.com/jcp/jcp.zip

2.         解压 jcp.zip ,运行其中的 setup.exe

3.         安装完成后,右下角出现 JCP 图标,安装即成功:

 

提示:

ü  多数情况下,JCP 只需要安装在客户端;

ü  操作系统必须是 XP 及以后版本Windows系统;

ü  试用版能查看 print.jatools.com 上的在线示例,也可以在 127.0.0.1(端口和路径不限)上试用7天,当你第一次在 127.0.0.1上使用JCP时,JCP会自动弹出试用注册窗口,为了能访问我们的注册服务器,注册时,要确保系统能访问外网。每台机子只能注册一次。

2         查看 JCP 在线示例

安装成功以后,可以用浏览器查看官方在线示例:

http://print.jatools.com/demos.htm

 

提示:

ü  浏览器可以是IE8+,及其他浏览器,如chromefirefox360等,版本不限;

ü  使用JCP,不需要对浏览器作任何设置;

ü  可以通过浏览器的查看,源文件等命令,查看示例的js,HTML源代码,体会JCP 的用法。

3         JCP 打印 WEB页面

1.         在本机中开一个WEB 服务,端口任意;

2.         jcp.zip 中的 demo\jcp.js 复制到你的web服务器某一目录中;

3.         web 服务器的jcp.js 同一目录中,创建一个web 打印页面,如 htmlprint.htm,如下:

1.  <html>  

2.  <head>  

3.  <!--引入 jcp.js, 里面定义了 getJCP() 方法等, -->  

4.  <script type="text/javascript" src="jcp.js"></script>  

5.  <script>  

6.      function doPrint(how) {  

7.          var myDoc = {  

8.              documents : document, // 打印页面(div)们在本文档中  

9.              copyrights : '杰创软件拥有版权  www.jatools.com' // 版权声明必须  

10.         };  

11.         var jcp = getJCP();  

12.         if (how == '打印预览')  

13.             jcp.printPreview(myDoc, false);  

14.         else if (how == '弹出打印机选择对话框打印') {  

15.             jcp.print(myDoc, true);  

16.         } else  

17.             jcp.print(myDoc, false); // 不弹出对话框打印  

18.     }  

19. </script>  

20. </head>  

21. <body>  

22.     <div id='page1'>第一页(div#page1)</div>  

23.     <div id='page2'>第二页(div#page2)</div>  

24.     <input type="button" value="打印预览" onClick="doPrint('打印预览')">  

25.     <input type="button" value="弹出打印机选择对话框打印" onClick="doPrint('弹出打印机选择对话框打印')">  

26.     <input type="button" value="无对话框直接打印" onClick="doPrint('无对话框直接打印')">  

27. </body>  

28. </html> 

其中包含三部分内容:

1)    引入 jcp.js,见代码第4

2)    设置打印按钮,定义js打印方法

本例中,设置了三个按钮,分别用于打印预览,弹出打印机选择对话框打印,直接打印,并定义了 doPrint方法,用how 参数表示不同的打印方式。见代码24,25,26行代码。

 

doPrint方法调用 getJCP 方法得到 JCP实例,对JCP实例可以调用printprintPreview方法,进行实际的打印及打印预览。见第6行代码。

 

myDoc参数用documents 属性设置打印内容,本例打印内容来自于本文档。

 

3)    设置表示打印内容的 div 对象,见第22,23行代码

JCP 默认打印文档中idpage1page2page3... div 对象,每个div对象,表示一页,本例设置page1page2 两页。

 

4.         在浏览器上用 127.0.0.1,访问你的 htmlprint.htm,如下:

 

提示:

ü  指定的div会被打印,没被指定的HTML元素将不会被打印,比如,本示例中的打印按钮,不会被打印;

ü  divid必须连续,如果你的div,存在 'page1''page2''page4',而不存在'page3',则JCP只打印前两页,'page4'不会被打印;

ü  被指定的div中的内容,可以是HTML任何可见对象,图片、或文本等;

ü  一个div打印成一页,这种分页方法称之为预分页方式。除此之外,JCP也支持自动分页方式,即可以将一个内容较多的网页,由JCP自动按纸张大小来分页,方法是在div页上设置 breakable类,参考在线示例中自动分页部分;

ü  本例中page div来自于本文档,即myDoc.documents设置到了document对象。除此之外,page div 也可以来自iframe中的文档,URL,HTML字符串等,参考在线示例的打印页面来源设置部分 ;

ü  你可以在 myDoc对象中,设置不同的打印参数,比如,打印机,纸张,边距等,参照在线示例基本打印设置部分;

ü  copyrights属性是版权信息,必须写;

ü  打印时,必须先用 getJCP 方法取得一个 JCP 对象,然后,对该对象调用各种方法,比如,getPrinters(获取打印机列表),print/printPreview( 打印/打印预览),printDocument(打印pdf或者 Office 文档)等。


4         JCP 打印PDF

如果不需要pdf打印功能,请略过。

1.         在本机中,开一个 WEB 服务器,端口任意;

2.         jcp.zip 中的 demo\jcp.js 复制到你的web服务器某一目录中;

3.         web 服务器的jcp.js 同一目录中,创建一个PDF打印页面,如 pdfprint.htm,如下:

1.  <html>  

2.  <head>  

3.  <script type="text/javascript" src="jcp.js"></script>  

4.  <script type="text/javascript">  

5.      function doPrint() {  

6.          getJCP().printDocument('quickstart.pdf', {  

7.              fileType : 'pdf'  

8.          });  

9.      }  

10. </script>  

11. </head>  

12. <body>  

13.     <input type="button" value="打印" onClick="doPrint()" id="printbutton">  

14. </body>  

15. </html>  

以上是一个用JCP 打印web页面的示例:

1)    引入 jcp.js

2)    调用 JCP printDocument 方法,进行PDF打印。

 

4. 在浏览器上用 127.0.0.1,访问你的 pdfprint.htm

 

提示:

ü  printDocument 方法,包含两个参数,第一个参数是一个url,指定PDF所在位置,第二个参数,指定打印参数,比如打印机、打印份数、打印起始页、双面打印等。当打印 pdf时, fileType必须设置为 'pdf'

ü  printDocument可以打印一个静态的PDF文件,也可以是一个动态生成的PDF

ü  当第二个参数的 priview:true 时,JCP 进入PDF打印预览模式,弹出打印预览窗口。

ü  PDF 打印请参照在线示例,PDF 打印及预览部分