PAZU 组件

1. 入门基础


PAZU 是一个ActiveX组件（NP版本是一个Plugin），本文档只讨论ActiveX版本（IE内核浏览器适用），NP版本的说明文档我们将另文发布。

PAZU 是一个已经通过微软代码认证签名的控件，用户可以在使用到这个控件的时候会自动提示安装，保证发布的便利性。

在你的WEB页里面使用 <Object> 标签可以引用PAZU控件，如下：


<object classid="clsid:AF33188F-6656-4549-99A6-E394F0CE4EA4"
codebase=“http://www.4Fang.net/4ff/sc_setup.exe”
id="pazu"
name="pazu" >
<param name="License" value="You Need a License from 4Fang"/>
</object>

说明： <object> 元素是用于嵌入ActiveX的，Flash也是通过这种方式嵌入到页面里面的。

Classid里面的字符串是指向PAZU的专属标识，是不能更改的。系统通过这个值检索并载入PAZU控件

Codebase 是指向用户可以下载到PAZU安装包的网址，如果安装包在你自己的网站上，你可以更改这个codebase属性，使得用户可以顺利下载安装PAZU控件。如果这个网址设置错误，IE将不会提示用户下载安装。

Id 属性允许你通过javascript或者vbscript使用getElementById方法，获得PAZU控件对象。

Name属性和id属性类似

按我们的免费授权约定，您不应该也不允许更改id 和 name 的值。

Param 参数，必须有一个License 的属性，value 是这个参数属性的值。它的意义是4Fang的授权许可。

您可以向4Fang申请一个免费的授权，详细的申请方法请看本文的许可授权章节，你要把你获得的授权码填入到Value值里面，PAZU才能正常工作。

注意：当你用http://127.0.0.1/ 开头去访问你的应用的时候，或者是双击的你网页文件直接打开网页的时候，不填入许可PAZU也可以正常运作。因此如果你要测试或者体验PAZU的功能而不打算使用PAZU发布你的应用，您就不必要向4Fang提成免费许可申请。

2. 属性和方法

PAZU内置两个对象：TWin 和 TPrinter

PAZU这个对象结构的属性和方法如下：

PAZU

|--------- TWin 对象

| |------------ appWin 方法隐藏IE菜单、工具条、标题栏、状态栏等

| |------------ MaxWin 方法 窗口最大化

| |------------ MinWin 方法 窗口最小化

| └----------- CloseWin 方法 关闭窗口

|

|--------- TPrinter 对象

| |------------ marginTop 属性上边距

| |------------ marginBottom 属性下边距

| |------------ marginLeft 属性 左边距

| |------------ marginRight 属性 右边距

| |------------ footer 属性页脚

| |------------ header 属性 页眉

| |------------ orientation 属性整型：纸张方向 1=纵向 2=横向

| |------------ paperName 属性 纸张大小名称

| |------------ printerName 属性 打印机名称

| |------------ isPrintBackground 属性 是否打印背景 true / false

| |------------ isZoomOutToFit 属性 是否缩放以适应大小打印 true / false

| |------------ printTemplate 属性 打印模板的URL

| |------------ copies 属性 打印份数

| |------------ range 属性 页面范围

| |------------ isCopyByCopy 属性 是否整份打印结束后再打印下一份 true / false

| |------------ getDefaultPrinter 方法 获得默认打印机的对象

| |------------ printToDefaultPrinter 方法 把要打印的字符串输送到默认打印机（配合getDefaultPrinter 使用）

| |------------ getPaperForms 方法 返回所有纸张格式的列表，以vbCrlf 分割

| |------------ getPrinters 方法 返回一个打印机列表，以vbCrlf 分割

| |------------ createPaper 方法 按指定的宽度和高度创建自定义纸张

| |------------ doPrint 方法 执行打印

| |------------ doPrint_ 方法 执行打印但是不进行页面参数设置

| |------------ doPreview 方法 打印预览

| |------------ doPageSetup 方法 执行页面参数的设置

| |------------ showPageSetup 方法 弹出页面设置窗口

| └----------- writeHTMLtoOfficeFile 方法 把HTML导出为Office EXCEL或者 Word格式文件

|

|--------- appWin 方法 旧版本兼容

|--------- doPrint 方法 旧版本兼容

|--------- pageSetup 方法 旧版本兼容

|--------- Fly 方法 LAPUTAC平台专用

|--------- Run 方法 LAPUTAC平台专用

└-------- AddObj 方法 LAPUTAC平台专用

<!-- body -->

<!-- body -->

3. TWin对象详解

jangogo @ 2009-6-22 11:12:00


TWin 对象

|------------ appWin 方法 隐藏IE菜单、工具条、标题栏、状态栏等,有一个bool的参数： appWin(true) appWin(false) 两个的区别在于是否隐藏标题栏

|------------ MaxWin 方法 窗口最大化 MaxWin()

|------------ MinWin 方法 窗口最小化 MinWin()

└----------- CloseWin 方法 关闭窗口 CloseWin()

演示页面（新窗口打开）

代码：


//1.把IE窗口变成App窗口，不隐藏标题栏
pazu.TWin.appWin(false);
//2.把IE窗口变成App窗口，隐藏标题栏
pazu.TWin.appWin(true);
//3.最大化
pazu.TWin.MaxWin();
//4.最小化
pazu.TWin.MinWin();
//5.关闭窗口
pazu.TWin.CloseWin();

4. TPrinter对象详解

jangogo @ 2009-6-22 11:15:00


DEMO和实例网页请看pazu_tprinter.html


marginTop 属性上边距 数据类型：数字 单位：毫米

marginBottom 属性下边距 数据类型：数字 单位：毫米

marginLeft 属性 左边距 数据类型：数字 单位：毫米

marginRight 属性 右边距 数据类型：数字 单位：毫米

例子：把上边距设置为10mm

pazu.TPrinter. marginTop=10


footer 属性页脚 数据类型：字符串

header 属性 页眉 数据类型：字符串

例子：设置页眉

pazu.TPrinter.header=”这是新的页眉”

要取消页眉和页脚，只要赋给它们一个空字符串就行了，例如不要页眉：

pazu.TPrinter.header=””

同时页眉和页脚也支持左中右的对齐方式和自动用日期、URL、页码等的填充。这方面的信息可以参考IE这方面的相关文档


orientation 属性纸张方向 数据类型：整数1或者2 ， 1=纵向 2=横向

例子：设置纸张方向为横向

pazu.TPrinter. orientation=2


paperName 属性 纸张大小名称 数据类型：字符串

printerName 属性 打印机名称 数据类型：字符串

这两个属性我们都不要求完全匹配，可以采用左匹配的方式，举例：

假设您有两台打印机，一台是 Epson 1600K III ，一台是 HP Deskjet 300。如果你要制定打印机为 HP Deskjet 300 你有两种方式：

方式一：全匹配 pazu.TPrinter. printerName=” HP Deskjet 300”

方式二：左匹配 pazu.TPrinter. printerName=” HP”

纸张的大小也是一样的道理，例如，指定用B5纸:

pazu.TPrinter. paperName=”B5”

提示：所有纸张格式和所有打印机的列表都可以通过pazu的相应方法取得，你还可以自定义纸张的大小。请看本文相应的章节。


isPrintBackground 属性 是否打印背景 数据类型：Boolean true / false

isZoomOutToFit 属性 是否缩放以适应大小打印 数据类型：Boolean true / false

printTemplate 属性 打印模板的URL

copies 属性 打印份数 数据类型：整数，默认为1

range 属性 页面范围 数据类型：字符串

isCopyByCopy 属性 是否整份打印结束后再打印下一份 数据类型：Boolean true / false

说明：

copies属性允许你当前内容打印多份拷贝

range 你可以指定打印的页面，例如：

只打印1到5页：pazu.TPrinter.range=”1-5”

只打印1,3,5,7页：pazu.TPrinter.range=”1,3,5,7”

提示：利用range属性可以实现双面打印功能

printTemplate属性是打印模板的URL，详细的内容请参考微软的printTemplate技术的说明。


getPrinters 方法 返回一个打印机列表，返回以一个回车换行符分隔的字符串

例如：获得所有的打印机

var ps=pazu.TPrinter.getPrinters();

//获得是一个以回车换行分隔的字符串

//alert(ps);

var pa=ps.split("\r\n");

for(var i=0;i <pa.length;i++){

alert(pa);

}


getPaperForms 方法 返回所有纸张格式的列表，返回以一个回车换行符分隔的字符串

和getPrinters类似，不同的是getPaperForms是带参数的，你可以指定获得那个打印机的纸张类别，没有参数或者参数为空字符表示获得当前默认打印机的纸张列表

例如：var ps=pazu.TPrinter.getPaperForms(“HP deskjet 300”);


getDefaultPrinter 方法 获得默认打印机的对象，返回一个Printer Object

printToDefaultPrinter 方法 把要打印的字符串输送到默认打印机（配合getDefaultPrinter 使用），参数：字符串

通过返回的对象，你可以控制该打印机，调用该打印机的EndDoc等方法，来实现直接输出内容到打印机

createPaper 方法 按指定的宽度和高度创建自定义纸张

有两个参数，paperWidth 和 paperHeight ，参数类型都是数字，单位是厘米。如果你指定的大小的纸张存在，则返回该纸张的名称，如果不存在，就先创建新的纸张格式并放回新的格式名称

例如：strDefaultPaper=pazu.TPrinter.createPaper(20,14); //创建20cm*14cm的纸张格式

alert('成功创建纸张格式：'+strDefaultPaper);

doPrint 方法 执行打印

有一个Boolean的参数，该参数表示是否要弹出打印机选择对话框

例如：不提示用户直接打印：

pazu.TPrinter.doPrint(false)


doPrint_ 方法 执行打印但是不进行页面参数设置

和doPrint类似，但是没有参数，而且执行打印前不去进行页面参数的设置，也不提示用户


doPreview 方法 打印预览没有参数

doPageSetup 方法 执行页面参数的设置没有参数

showPageSetup 方法 弹出页面设置窗口没有参数

PAZU 是4Fang 四方为配合“四方在线”软件于2004年开发的WEB打印控件，适用于各种WEB软件项目的打印。


PAZU是客户端软件，使用于IE作为客户端的所有应用，与服务器端开发语言无关，即PAZU支持所有的开发语言开发的WEB应用，无论是Java还是Dot Net还是PHP 还是…都没有问题，客户端是IE就可以了。

如果你的应用的客户端不是IE，是firefox/chrome等非IE浏览器，您就需要PAZU的NP版本(NP版本我们的项目小组正在内部测试，估计在2009年10月份会推出给大家使用，敬请留意)


PAZU广泛支持IE6、IE7、IE8，支持WinXP以上操作系统，包括Windows Vista 和 Windows 7。


PAZU还支持IE内核的非IE浏览器， 如傲游、QQ浏览器、世界之窗等。


PAZU还支持使用IE浏览器编程对象自己编写的各种应用浏览器。

由于Windows Vista 以上操作系统和IE8以上版本在系统权限校验、安全性方面的巨大提升，使得目前网上公布的绝大部分WEB打印控件都不能完美支持WinVista和Win7、IE8等新一代WEB应用平台。PAZU的开发小组花费了大量的时间来使得PAZU具备最完全的兼容能力。