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

1、楚琳Web打印控件的使用说明本报表控件为ActiveX控件，通过JavaScript语言进行调用。本报表控件包 含在PrintActivex.exe文件中，其报表预览和打印基本上可以达C/S架构的报表效果。本报表控件提供了 ASP, ASP.NET，PHP, JSP语言的示例，用户可以参照 示例进行开发。这些示例中核心为三个函数，为TableToStr、FileToStr、TablePictureToStr 。在实际开发中，请把此三个函数拷贝至程序中。TableToStr函数是把数据集的内容转化为报表控件所需的XML字符串，对于JSP示例则需要修改一下JavaBean类中所对应的连接字符串。F

2、ileToStr函数是把报表文件或图片转化为报表控件所需的字符串。TablePictureToStr则把数据集中所对应的图片文件转化为报表控件所需的 字符串。报表控件的名称为WebPrint.WebPrintUnit ，Version属性为版本号，有此属性便于用户自动检测更新。ReportFileName属性，用于调用 DesignReport函数编辑报表之前，指定报 表的名称，以便上传服务器。Prin terList属性，获取客户端本地已经安装的打印机列表，各打印机名称之间以“；”分隔。此属性便于在网页上设置指定的打印机进行打印（ASP.NET有示例）。Prin ter属性，可以指定打印时的

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

4、属性，为0则打印预览时隐藏pbFind属性，为0则打印预览时隐藏按钮;pbOutline属性，为0则打印预览时隐藏 按钮;pbPageSetup属性，为0则打印预览时隐藏按钮；pbNavigator属性，为0则打印预览时隐藏按钮;pbExportQuick属性，为0则打印预览时隐藏按钮；LeftMargin属性，设置页面设置的左边距，单位为毫米；RightMargin属性，设置页面设置的右边距，单位为毫米；TopMargin属性，设置页面设置的上边距，单位为毫米；BottomMargin属性，设置页面设置的下边距，单位为毫米；PageSetURLS性，设置此属性，贝恠报表预览时，单击了按钮，在

5、弹出 的页面设置窗口后点击“确定”按钮时，通过Http的Post方式直接提交到所设 置的URL页面，用户可以在URL处理用户所设置的页面设置的左边距、右边距、 上边距、下边距。Post的字段名指定为 LeftMargin、RightMargin、TopMargin、 BottomMargin，此参数为用户所设置的左边距、右边距、上边距、下边距。PageSet 属性的设置示例：ObjPri ntMa nge.PageSetURL=http:/www.x in /ASPPost/PageSet.asp ?FileName=DepsitAmt.fr3;&UserlD=15;问号后F

6、ileName=DepsitAmt.fr3&UserlD=15 的参数为用户指定的参数，用户指 定的参数以Http的Get方式上传，上传用户指定的参数便于识别。PostURL属性，设置此属性，则在报表在线编辑时，单击“保存”按钮或“保 存”菜单项，则把报表内容组织为 String，且通过Http的Post方式直接提交 到所设置的URL页面，用户可以在URL接收报表内容，把报表内容保存在指定文 件或数据库中。Post的字段名指定为ReportFileValue ，用户可以通过接收此字 段的值保存在线编辑的报表内容。报表的内容为String，打印或预览时可以直接调用此内容，无需用 FileToSt

7、r函数进行转换。PostURL属性的设置示例： ObjPri ntMa nge.PostURL=http:/www.x in /ASPPost/Show.asp?FileN ame=DepsitAmt.fr3; 问号后 FileName=DepsitAmt.fr3 的参数为用户指定的参 数，用户指定的参数以Http的Get方式上传，上传用户指定的参数便于识别。PrintURL属性，设置此属性，则在报表打印时，在弹出的选择打印机的窗口 后点击“确定”按钮时，通过 Http的Post方式直接提交到所设置的URL页面， 用户可以在URL处理用户已打印的份数。Post的字段名指定为P

8、rintCopy，此参 数为用户打印时所选择的份数，默认为1。PrintURL属性的设置示例：ObjPri ntMa nge.Pri ntURL=http:/www.x in /ASPPost/Pri ntNum.asp? FileName=DepsitAmt.fr3&UserlD=15;问号后FileName=DepsitAmt.fr3&UserlD=15 的参数为用户指定的参数，用户指 定的参数以Http的Get方式上传，上传用户指定的参数便于识别。DataSetName1 DataSetName2 DataSetName3 DataSetName4 DataSetNam

9、e5DataSetName6属性，设置此属性，则设置数据集的名称为指定名称（可以是中 文），否则数据集的名称默认为frxDataSetl至frxDataSet6。注意：若报表编 辑时指定了数据集的名称，则报表预览和打印也必须指定相同的数据集名称， 否 则会报错。CheckReg函数，功能为检测注册，参数：注册的公司名称或个人姓名，注册 码。注册的时候请提供公司名称或个人姓名，作者会把对应的注册码发给注册人， 在每次使用此报表控件时，必须调用此函数进行检测，请输入注册时所用的公司 名称或个人姓名，还有注册码。注册后的报表控件在报表预览时会在工具栏的右 上角显示“某某公司开发，为注册版”，打印的时

10、候不会打印此字符串。CheckDoma in Nam函数，功能为按域名注册，参数：注册的域名、注册码。 按域名注册时，会自动检测浏览器地址上的UR中的域名是否与注册的域名相符， 若相符，且注册码与域名相符，则为已注册。按域名注册的打印控件，在报表预 览和打印时，都不会显示注册信息那一行，这也是和 CheckRegg数的差别。ShowReport函数，功能为预览报表，参数：报表文件字符串，报表参数名称 字符串，报表参数值字符串，数据集1的字符串，数据集2的字符串，数据集3的 字符串，数据集4的字符串，数据集5的字符串，数据集6的字符串。报表文件字 符串调用FileToStr函数产生；报表参数名称

11、字符串为报表中所使用的参数的名 称，各名称之间以分隔；报表参数值字符串为报表中所使用的参数所对应的值， 各参数值之间以分隔；数据集的字符串通过调用FileToStr函数产生，若没有 数据则为空。PrintReport函数，功能为直接打印报表，参数和 ShowReport相同。DesignReport函数，功能为在线编辑报表，参数和ShowReport相同。编辑好的报表可以通过FTPt传至服务器。报表编辑窗口的工具栏上有按钮，单击此按钮，再输入FTR服务名、用户名、密码和FTP文件夹就可以把报表上传至服务 器。若设置了 PostURLJS性，贝U单击“保存”时可把报表的内容组织为 String，

12、 且通过Http的Post方式直接提交到所设置的URIX面。MasterOptions函数，功能为建立主从关系，参数：主数据集序号，关联字 段名，字段是否为数值型。此函数是用于主从报表打印。主数据集序号通常为1, 关联字段名为两个数据集共同的字段名，字段名若为数据型则为1,否则为0。AddPicturePri nt函数，功能为增加图片打印，若为单个图片的参数为：报 表中图片对象名，数据表的字段（为0），图片文件名，数据集序号，是否清除 旧数据（第1次调用时为1,其它时候则为0）;若为数据表中的图片打印的参数： 报表中图片对象名，数据表的字段（为1），图片文件名所对应的字段名，数据 集序号，是否

13、清除旧数据（第1次调用时为1,其它时候则为0）。本报表控件支持直接写串口和并口的功能，这便于以指令方式操作票据打印 机、钱箱和客显等设备（ASP.NETt示例）。ComNan属性：设置串口或并口名称， COM至COM25为串口，LPT1至LPT2为 并口。BaudRate属性：串口的波特率，默认为 9600。Stopbits 属性：串口的停止位，默认为 ONESTOPBIT 0, ONE5STOPBITS1, TWOSTOPBITS =。2这个一般不用修改设置。Bytesize属性：数据位的长度，默认为 &这个一般不用修改设置。TimeOut属性：数据发送超时，串口则为写一个数据位的超时，并口

14、的超时 为整个数据的传送时间，默认为 3000毫秒。isCheckPrint属性：串口打印时是否检测打印机状态 (标准EPSO或仿EPSON 打印机有效)，默认为 0。WriteComData函数，功能为把数据写入端口，参数：要写入的数据。返回值 0表示成功， -1表示端口打开失败， -2表示数据发送失败， -3表示打印机故障。 此函数在写数据时，会打开端口、写入数据、然后关闭端口，所以在同一个函数 中只要调用一次，先把数据组织好，然后再调用此函数一次性写入端口。本报表控件支持多种语言，对于非简体中文的语言，在安装包中提供PrintActivex(English).exe 文件，若要使用此安装

15、包，可把此文件改名为PrintActivex.exe 替换示例中的 PrintActivex.exe 文件，然后客户端再下载安 装，也可以直接在客户端双击此文件进行安装。该文件包的语言为英文。本报表控件提供的函数不多， 但因为是采用报表文件和数据集分开， 可以通 过报表设计器设计功能丰富的报表。其设计效率和报表的美观可以和C/S架构的报表设计进行媲美。示例中的ASP所采用的数据库为Access，直接把ASP这个文件夹拷贝到Web艮 务器所对应的We文件夹下就可以运行。示例中的ASP.NET所采用的数据库为SQL Server 2000，数据库保存在 App_Data目录，直接附加就可以，所采用的开发工具是 Visual Studio 2008,运 行之前要修改 Web.config 中 PrintTestConnectionString字符串。示例中的PHP所采用的数据库为MySq