WebPrint3.0

主页 | 文档 |

WebPrint3.0的对象、属性和方法

一、对象

1.WebPrint对象

二、属性

1.defaultPrinterName

6.header

7.footer

8.copies

三、方法

2.SetMarginMeasure(int units)

3.Preview()

4.Print([bool] prompt)

WebPrint对象

描述：打印对象。

在页面中嵌入此对象实现定制打印。如：

示例：

<html>

<body>

<p>

方成打印演示示例。

</body>

</html>

defaultPrinterName属性

描述：获得当前默认打印机名称，通过获得默认打印机名称可以判断是否安装了打印机。

语法：WebPrint.defaultPrinterName = [stringValue]

应用到：WebPrint对象

示例：

下面是一个判断当前是否设置了打印机的javascript代码，PrintCtl是WebPrint的对象id。

if (WebPrint.defaultPrinterName.length==0)

{

alert("没有设置打印机！")

return;

}

marginTop属性

描述：设置打印页面的上边距。设置值的单位默认为毫米，通过SetMarginMeasure()方法可以改变到英寸。

语法：WebPrint.marginTop = [numMarginValue]

应用到：WebPrint对象

示例：

WebPrint.setMarginMeasure(1);

WebPrint.marginTop = 20; //20mm的上边距

marginLeft属性

描述：设置打印页面的左边距。设置值的单位默认为毫米，通过SetMarginMeasure()方法可以改变到英寸。

语法：WebPrint.marginLeft = [numMarginValue]

应用到：WebPrint对象

示例：

WebPrint.setMarginMeasure(1);

WebPrint.marginLeft = 20; //20mm的左边距

marginRight属性

描述：设置打印页面的右边距。设置值的单位默认为毫米，通过SetMarginMeasure()方法可以改变到英寸。

语法：WebPrint.marginRight = [numMarginValue]

应用到：WebPrint对象

示例：

WebPrint.setMarginMeasure(1);

WebPrint.marginRight = 20; //20mm的右边距

marginBottom属性

描述：设置打印页面的下边距。设置值的单位默认为毫米，通过SetMarginMeasure()方法可以改变到英寸。

语法：WebPrint.marginBottom = [numMarginValue]

应用到：WebPrint对象

示例：

WebPrint.setMarginMeasure(1);

WebPrint.marginBottom = 20; //20mm的底边距

header属性

描述：设置打印页面的页眉信息。

语法：WebPrint.header = [stringValue]

设置值可以和下面IE的页眉页脚代码合并设置，例如：（page &p of &P）

描述	代码
窗口标题	&w
页面地址(URL)	&u
短格式日期 (在控制面板的区域选项中修改短日期格式)	&d
长格式日期 (在控制面板的区域选项中修改长日期格式)	&D
时间 (在控制面板的区域选项中修改时间格式)	&t
24小时格式	&T
当前页号	&p
总页数	&P
文本居中(在&b后面的文本)	&b
文本靠右 (在 &b&b 后面的文本)	&b&b
单个&(&)	&&

应用到：WebPrint对象

示例：

WebPrint.header = “WebPrint3.0 打印演示”

footer属性

描述：设置打印页面的页脚信息。

语法：WebPrint.footer = [stringValue]

设置值可以和下面IE的页眉页脚代码合并设置，例如：（page &p of &P）

描述	代码
窗口标题	&w
页面地址(URL)	&u
短格式日期 (在控制面板的区域选项中修改短日期格式)	&d
长格式日期 (在控制面板的区域选项中修改长日期格式)	&D
时间 (在控制面板的区域选项中修改时间格式)	&t
24小时格式	&T
当前页号	&p
总页数	&P
文本居中(在&b后面的文本)	&b
文本靠右 (在 &b&b 后面的文本)	&b&b
单个&(&)	&&

应用到：WebPrint对象

示例：

WebPrint.footer = “第 &p 页 / 共 &P 页” ;

copies属性

描述：设置打印份数。

语法：WebPrint.marginBottom = [numMarginValue]

应用到：WebPrint对象

示例：WebPrint.copies = 2; //打印两份

pageFrom属性

描述：设置打印开始页数，通常与pageTo一起使用。

pageFrom和pageTo的设置必须在selectedPages属性值为true时才能生效。

语法：WebPrint.pageFrom = [numValue]

应用到：WebPrint对象

示例：下面代码实现选择从第二页打印到第四页。

WebPrint.selectedPages = true ;

WebPrint.pageFrom = 2;

WebPrint.pageTo = 4;

pageTo属性

描述：设置打印结束页，通常与pageFrom一起使用。

pageFrom和pageTo的设置必须在selectedPages属性值为true时才能生效。

语法：WebPrint.pageTo = [numValue]

应用到：WebPrint对象

示例：下面代码实现选择从第二页打印到第四页。

WebPrint.selectedPages = true ;

WebPrint.pageFrom = 2;

WebPrint.pageTo = 4;

selectedPages属性

描述：设置是否选择打印页。

语法：

WebPrint.selectedPages = [boolVlaue] true为选择页打印；false为默认值不选择页打印

当WebPrint.selectedPages = true ;时，再设置pageFrom,和pageTo达到选项打印页

应用到：WebPrint对象

示例：下面代码实现选择从第二页打印到第四页。

下面代码实现选择从第二页打印到第四页。

WebPrint.selectedPages = true ;

WebPrint.pageFrom = 2 ;

WebPrint.pageTo = 4

currentPage属性

描述：设置是否打印当前页。

语法：

WebPrint.currentPage = [boolValue] true为打印当前页；false为默认值不打印当前页。

当WebPrint.currentPage＝ true 和WebPrint.selectedPages = true时，则那个设置在最后则那个属性值有效。

应用到：WebPrint对象

示例：WebPrint.currentPage = true ;//打印当前页。

orientation属性

描述：设置打印方向，横向或者纵向。

语法：WebPrint.orientation = [numValue] 1为纵向，2为横向。

应用到：WebPrint对象

示例：

下面代码实现 B5纸的横向打印。

WebPrint.paperSize = “B5”;

WebPrint.orientation = 2 ;

paperSize属性

描述：设置打印纸张。

语法：WebPrint.paperSize = [stringValue] 设置值与打印机的纸型一致。

应用到：WebPrint对象

示例：

WebPrint.paperSize = “A4”; //定制A4 纸打印

下面代码实现用户自定义纸张尺寸打印。

WebPrint.setMarginMeasure(1);

WebPrint.paperSize = "US Std Fanfold"; //用户自定义

WebPrint.pageWidth = 297;

WebPrint.pageHeight = 210;

paperSource属性

描述：设置纸张来源。

语法：WebPrint.paperSource = [stringValue] 设置值与打印机的纸张来源一致。

应用到：WebPrint对象

示例：WebPrint.paperSource = “单张”;

pageWidth属性

描述：设置打印页面的宽。设置值的单位默认为毫米，通过SetMarginMeasure()方法可以改变到英寸。

如果不设置纸张型号，直接设置pageWidth和pageHeight的值，则在页面设置对话框中的纸型将显示当前打印机的默认纸型。

语法：WebPrint.pageWidth = [numValue]

应用到：WebPrint对象

示例：

WebPrint.setMarginMeasure(2);//英寸为单位

WebPrint.pageWidth = 6 ;

pageHeight属性

描述：设置打印页面的高。设置值的单位默认为毫米，通过SetMarginMeasure()方法可以改变到英寸。

如果不设置纸张型号，直接设置pageWidth和pageHeight的值，则在页面设置对话框中的纸型将显示当前打印机的默认纸型。

语法：WebPrint.pageHeight = [numValue]

应用到：WebPrint对象

示例：

WebPrint.setMarginMeasure(2); //英寸为单位

WebPrint.pageHeight = 8 ;

InitPrint()方法

描述：初始化所有的打印属性设置值。通常在设置一个打印作业之前调用一次此方法。

参数：

应用到：WebPrint对象

示例：

下面代码实现设置打印页眉和页脚为1英寸，在设置之前调用InitPrint()方法，初始化所有打印设置值。

WebPrint.InitPrint();

WebPrint.SetMarginMeasure(2);

WebPrint.marginTop = 1;

WebPrint.marginBottom = 1;

SetMarginMeasure(int units)方法

描述：设置打印页面尺寸和边距的单位。

参数：units

1 表示毫米默认值

2 表示英寸

应用到：WebPrint对象

示例：

WebPrint.SetMarginMeasure(2);//设置单位为英寸

Preview()方法

描述：打印预览。

参数：units

1 表示毫米默认值

2 表示英寸

应用到：WebPrint对象

示例：

下面代码实现A4纸纵向打印的预览。

WebPrint.paperSize = “A4”;

WebPrint.orientation = 2;

WebPrint.Preview();

Print([bool] prompt)方法

描述：打印。

参数：prompt 可选的

true 不出打印对话框直接打印

fase 弹出打印对话框默认值

应用到：WebPrint对象

示例：

下面代码实现A4纸纵向打印

WebPrint.paperSize = “A4”

WebPrint.orientation = 2;

WebPrint.Print(); // 弹出打印对话框的打印

WebPrint.Print(true); //不出打印对话框直接打印