墙外打印控件(QWPrint)1.0正式版帮助手册

Version:1.0.1.1

一、欢迎使用QWPrint打印控件

墙外打印控件（QWPrint）是由作者墙外行人，根据实际的工作经历写的一个IE下的打印控件。本控件现向广大网站程序员免费发布。

本控件基于IE下的打印模板制作，可以方便网站程序员控制打印效果。主要的特点有以下几种：

1.符合网页制作者使用习惯：控件打印的内容是网页形式的，只要程序员制作好网页，嵌入本控件即可打印。

2.设置多种打印属性：控件使用者可以通过控件设置打印机的页边距，页眉页脚，纸张大小等打印参数。

3.精确控制打印：可以实现Web下的套打操作。

 

作者：墙外行人(QQ85161676)

邮箱：xwangye@qq.com

网站：http://www.xwangye.com

 

二、安装说明

由于本控件是在IE中运行，并且没有进行数字签名，因此在一些浏览器安全级设置过高的机器中可能会被禁止下载。这时我们只要手动将IE中的安全选项修改一下即可下载。修改方法如下：

在IE中->工具->internat选项->安全选项卡->自定义级别->ActiveX控件和插件->下载未签名的ActiveX控件  修改为提示即可。

如果还不行，可以试一下其他ActiveX选项以为提示。

如果还是不行，那你也可以手动把cab下载下来。然后把里面的dll拷到system32目录下，然后使用regsvr32 QWPrint.dll即可。

 

三、 使用示例

我们在要打印的页面head中放置下面的代码：

Codebase是你放控件打印包的路径。

我们把下面的代码放置到body的最后：

//以0.1毫米为单位

PrintActiveX.paddingTop=120;

PrintActiveX.paddingRight=0;

PrintActiveX.paddingBottom=0;

PrintActiveX.paddingLeft=170;

PrintActiveX.isHtmlHeadFoot=false;

PrintActiveX.header="页&p总页数&P";

PrintActiveX.pageWidth=2000;

PrintActiveX.pageHeight=800;

PrintActiveX.orientation=1;

PrintActiveX.PrintView();

以上将出现打印一个宽20cm 高8cm的纸张打印预览。

 

四、功能概述

1.       自定义纸张：

我们可以通过设置控件的pageWidth属性和pageHeight属性来自定义不规则纸张的打印功能，注意，长度是以0.1mm为单位的。当然我们也可以通过使用pageName属性设置一些常见纸张的打印，如A4纸的打印我们可以设置：PrintActiveX.pageName=”A4”;

2.       不可打印区域：

此属性一般不需要设置。如想设置要通过marginTop,marginRight,marginBottom,marginLeft这几个属性来设置。是为了设置打印机的不可打印区域的。我们一般是通过页边距来控制，所以通常不设置此属性。

3.       页边距：

我们通过四个属性值分别上下左右四个边距。单位也是以0.1mm为单位。具体说明如下：

paddingTop:上边距的值。paddingRight:右边距的值。

paddingBottom:下边距的值。paddingLeft:左边距的值。

以上四个属性若未设置，则以浏览器页面设置中的默认值为准。

4.       页眉页脚：

本控件页眉页脚支持HTML格式，可以自由插入图片作为页眉上的logo等内容。

常见的参数变量如下：

 

5.       打印(预览)：

我们可以通过调用控件的Print方法来执行打印，调用PrintView方法来调用打印预览。

Print方法如果传递false参数，则打印时不会弹出选择打印机的打印框，而是直接打印。

 

五、属性参考

1.       属性：

a)       纸张属性

（1）       marginTop

不可打印上边距。只在自定义纸张大小时有效。以0.1mm为单位。

（2）       marginRight

不可打印右边距。只在自定义纸张大小时有效。以0.1mm为单位。

（3）       marginBottom

不可打印下边距。只在自定义纸张大小时有效。以0.1mm为单位。

（4）       marginLeft

不可打印左边距。只在自定义纸张大小时有效。以0.1mm为单位。

（5）       pageWidth

纸张宽度。以0.1mm为单位。

（6）       pageHeight

纸张高度。以0.1mm为单位。

（7）       orientation

纸张的横向纵向。为1时为纵向，设为2 则为横向。只在自定义纸张大小时有效。

（8）       pageName

常用纸张名称。必须是打印机支持的纸张。

b)      打印属性

（1）       paddingTop

纸张上边距。默认值为浏览器页面设置上的上边距。以0.1mm为单位。

（2）       paddingRight

纸张右边距。默认值为浏览器页面设置上的右边距。以0.1mm为单位。

（3）       paddingBottom

纸张下边距。默认值为浏览器页面设置上的下边距。以0.1mm为单位。

（4）       paddingLeft

纸张左边距。默认值为浏览器页面设置上的左边距。以0.1mm为单位。

（5）       header

打印页眉。默认值为浏览器页面设置上的页眉。支持打印的参数如下

支持html格式，可以使用div或table标签自由定位。

注意：如果想在页眉中使用图片，必须使用图片的绝对地址如：http://www.xwangye.com/skins/images/logo.gif。

（6）       footer

打印页脚。默认值为浏览器页面设置上的页脚。支持打印的参数如下

支持html格式，可以使用div或table标签自由定位。

注意：如果想在页脚中使用图片，必须使用图片的绝对地址如：http://www.xwangye.com/skins/images/logo.gif。

（7）copies

打印份数。

2.       方法：

a)       打印预览

(1)  PrintView

控件的打印预览方法，调用此方法，可使打印者进一步设置打印属性的参数。

b)      打印

（1）Print

打印方法。如果传递false参数，则打印时不提示选择打印机的对话框。

该文章在 2011/11/2 8:43:49 编辑过