1         安装

1)         自动检测安装(推荐)

1.         即由引入的 jcpfree.js来检测是否安装 JCP free,如果没有安装,会自动提示用户下载安装,如下:

 

2.         用户点击确认后,jcpfree.js自动下载,下载完成后,用户点击下载到的 setup.exe ,完成安装:

3.         安装完成后,jcp会自动继续未完成的任务,如本例中取得版本号。

 

 

2)         手动安装

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

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

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

 

提示:

ü  JCP 只需要安装在客户端;

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

 

2         查看 JCP 在线示例

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

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

提示:

ü  本版本仅支持IE8+, IE内核浏览器,其他浏览器均不支持;

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

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

3         JCP 打印 WEB页面

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

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

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

1.  <html>  

2.  <head>  

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

4.  <script type="text/javascript" src="jcpfree.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)    引入 jcpfree.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打印成一页,这种分页方法称之为预分页方式。本版本不支持自动分页;

ü  本例中page div来自于本文档,即myDoc.documents设置到了document对象。除此之外,page div 也可以来自iframe中的文档;

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

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

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