楚琳Web打印控件的使用说明修改版

楚琳Web打印控件的使用说明

本报表控件为Activex控件，通过JavaScript语言进行调用。本报表控件包含在PrintActivex.exe文件中，其报表预览和打印基本上可以达C/S架构的报表效果。

本报表控件提供了ASP，，PHP，JSP语言的示例，用户可以参照示例进行开发。这些示例中核心为三个函数，为TableToStr、FileToStr、TablePictureToStr。在实际开发中，请把此三个函数拷贝至程序中。

TableToStr函数是把数据集的内容转化为报表控件所需的XML字符串，对于JSP示例则需要修改一下JavaBean类中所对应的连接字符串。

FileToStr函数是把报表文件或图片转化为报表控件所需的字符串。

TablePictureToStr则把数据集中所对应的图片文件转化为报表控件所需的字符串。

报表控件的名称为WebPrint.WebPrintUnit，

Version属性为版本号，有此属性便于用户自动检测更新。

ReportFileName属性，用于调用DesignReport函数编辑报表之前，指定报表的名称，以便上传服务器。

PrinterList属性，获取客户端本地已经安装的打印机列表，各打印机名称之间以“;”分隔。此属性便于在网页上设置指定的打印机进行打印(有示例)。

Printer属性，可以指定打印时的打印机名称，对于打印预览方式，系统则把指定打印机设为首选打印机；对于直接打印，系统则把打印任务直接分配给指定打印机。若为空则为默认打印机。指定的打印机必须是客户端电脑已安装好的，本地打印机和网络打印机都可以，对于网络打印机的名称，注意“\”改为“\\”，比如：ObjPrintMange.Printer='\\\\192.168.1.88\\Epson LQ-300K'; ，若指定的打印机不存在，则还是默认的打印机。

pbPrint属性，为0则打印预览时隐藏按钮；

pbLoad属性，为0则打印预览时隐藏按钮；

pbSave属性，为0则打印预览时隐藏按钮；

pbExport属性，为0则打印预览时隐藏按钮；

pbZoom属性，为0则打印预览时隐藏按钮；

pbFind属性，为0则打印预览时隐藏按钮；

pbOutline属性，为0则打印预览时隐藏按钮；

pbPageSetup属性，为0则打印预览时隐藏按钮；

pbNavigator属性，为0则打印预览时隐藏按钮；

pbExportQuick属性，为0则打印预览时隐藏按钮；

LeftMargin属性，设置页面设置的左边距，单位为毫米；

RightMargin属性，设置页面设置的右边距，单位为毫米；

TopMargin属性，设置页面设置的上边距，单位为毫米；

BottomMargin属性，设置页面设置的下边距，单位为毫米；

PageSetURL属性，设置此属性，则在报表预览时，单击了按钮，在弹出的页面设置窗口后点击“确定”按钮时，通过Http的Post方式直接提交到所设置的URL页面，用户可以在URL处理用户所设置的页面设置的左边距、右边距、上边距、下边距。Post的字段名指定为LeftMargin、RightMargin、TopMargin、BottomMargin，此参数为用户所设置的左边距、右边距、上边距、下边距。PageSet 属性的设置示例：

ObjPrintMange.PageSetURL='/ASPPost/PageSet.asp ?FileName=DepsitAmt.fr3';&UserID=15';

问号后FileName=DepsitAmt.fr3&UserID=15的参数为用户指定的参数，用户指定的参数以Http的Get方式上传，上传用户指定的参数便于识别。

PostURL属性，设置此属性，则在报表在线编辑时，单击“保存”按钮或“保存”菜单项，则把报表内容组织为String，且通过Http的Post方式直接提交到所设置的URL页面，用户可以在URL接收报表内容，把报表内容保存在指定文件或数据库中。Post的字段名指定为ReportFileValue，用户可以通过接收此字段的值保存在线编辑的报表内容。报表的内容为String，打印或预览时可以直接调用此内容，无需用FileToStr函数进行转换。PostURL属性的设置示例：ObjPrintMange.PostURL='/ASPPost/Show.asp?FileN ame=DepsitAmt.fr3'; 问号后FileName=DepsitAmt.fr3的参数为用户指定的参数，用户指定的参数以Http的Get方式上传，上传用户指定的参数便于识别。

PrintURL属性，设置此属性，则在报表打印时，在弹出的选择打印机的窗口后点击“确定”按钮时，通过Http的Post方式直接提交到所设置的URL页面，用户可以在URL处理用户已打印的份数。Post的字段名指定为PrintCopy，此参数为用户打印时所选择的份数，默认为1。PrintURL属性的设置示例：ObjPrintMange.PrintURL='/ASPPost/PrintNum.asp? FileName=DepsitAmt.fr3&UserID=15';

问号后FileName=DepsitAmt.fr3&UserID=15的参数为用户指定的参数，用户指定的参数以Http的Get方式上传，上传用户指定的参数便于识别。

DataSetName1、DataSetName2、DataSetName3、DataSetName4、DataSetName5、DataSetName6属性，设置此属性，则设置数据集的名称为指定名称（可以是中

文），否则数据集的名称默认为frxDataSet1至frxDataSet6。注意：若报表编辑时指定了数据集的名称，则报表预览和打印也必须指定相同的数据集名称，否则会报错。

CheckReg函数，功能为检测注册，参数：注册的公司名称或个人姓名，注册码。注册的时候请提供公司名称或个人姓名，作者会把对应的注册码发给注册人，在每次使用此报表控件时，必须调用此函数进行检测，请输入注册时所用的公司名称或个人姓名，还有注册码。注册后的报表控件在报表预览时会在工具栏的右上角显示“某某公司开发，为注册版”，打印的时候不会打印此字符串。

CheckDomainName函数，功能为按域名注册，参数：注册的域名、注册码。按域名注册时，会自动检测浏览器地址上的URL中的域名是否与注册的域名相符，若相符，且注册码与域名相符，则为已注册。按域名注册的打印控件，在报表预览和打印时，都不会显示注册信息那一行，这也是和CheckReg函数的差别。

ShowReport函数，功能为预览报表，参数：报表文件字符串，报表参数名称字符串，报表参数值字符串，数据集1的字符串，数据集2的字符串，数据集3的字符串，数据集4的字符串，数据集5的字符串，数据集6的字符串。报表文件字符串调用FileToStr函数产生；报表参数名称字符串为报表中所使用的参数的名称，各名称之间以`~分隔；报表参数值字符串为报表中所使用的参数所对应的值，各参数值之间以`~分隔；数据集的字符串通过调用FileToStr函数产生，若没有数据则为空。

PrintReport函数，功能为直接打印报表，参数和ShowReport相同。

DesignReport函数，功能为在线编辑报表，参数和ShowReport相同。编辑好

的报表可以通过FTP上传至服务器。报表编辑窗口的工具栏上有按钮，单击此按钮，再输入FTP服务名、用户名、密码和FTP文件夹就可以把报表上传至服务器。若设置了PostURL属性，则单击“保存”时可把报表的内容组织为String，且通过Http的Post方式直接提交到所设置的URL页面。

MasterOptions函数，功能为建立主从关系，参数：主数据集序号，关联字段名，字段是否为数值型。此函数是用于主从报表打印。主数据集序号通常为1，关联字段名为两个数据集共同的字段名，字段名若为数据型则为1，否则为0。

AddPicturePrint函数，功能为增加图片打印，若为单个图片的参数为：报表中图片对象名，数据表的字段（为0），图片文件名，数据集序号，是否清除旧数据（第1次调用时为1，其它时候则为0）；若为数据表中的图片打印的参数：报表中图片对象名，数据表的字段（为1），图片文件名所对应的字段名，数据集序号，是否清除旧数据（第1次调用时为1，其它时候则为0）。

本报表控件支持直接写串口和并口的功能，这便于以指令方式操作票据打印机、钱箱和客显等设备(有示例)。

ComName属性：设置串口或并口名称，COM1至COM255为串口，LPT1至LPT2为并口。

BaudRate属性：串口的波特率，默认为9600。

Stopbits属性：串口的停止位，默认为ONESTOPBIT = 0, ONE5STOPBITS = 1, TWOSTOPBITS = 2。这个一般不用修改设置。

Bytesize属性：数据位的长度，默认为8。这个一般不用修改设置。