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

楚琳Web打印控件的使用说明本报表控件为Activex控件，通过JavaScript语言进行调用。本报表控件包含在PrintActivex.exe文件中，其报表预览和打印基本上可以达C/S架构的报表效果。本报表控件提供了ASP，ASP.NET，PHP，JSP语言的示例，用户可以参照示例进行开发。这些示例中核心为三个函数，为TableToStr、FileToStr、TablePictureToStr。在实际开发中，请把此三个函数拷贝至程序中。TableToStr函数是把数据集的内容转化为报表控件所需的XML字符串，对于JSP示例则需要修改一下JavaBean类中所对应的连接字符串。FileToStr函数是把报表文件或图片转化为报表控件所需的字符串。TablePictureToStr则把数据集中所对应的图片文件转化为报表控件所需的字符串。报表控件的名称为WebPrint.WebPrintUnit，Version属性为版本号，有此属性便于用户自动检测更新。ReportFileName属性，用于调用DesignReport函数编辑报表之前，指定报表的名称，以便上传服务器。PrinterList属性，获取客户端本地已经安装的打印机列表，各打印机名称之间以“;”分隔。此属性便于在网页上设置指定的打印机进行打印(ASP.NET有示例)。Printer属性，可以指定打印时的打印机名称，对于打印预览方式，系统则把指定打印机设为首选打印机；对于直接打印，系统则把打印任务直接分配给指定打印机。若为空则为默认打印机。指定的打印机必须是客户端电脑已安装好的，本地打印机和网络打印机都可以，对于网络打印机的名称，注意“”改为“”，比如：ObjPrintMange.Printer=8Epson 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?FileName=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）。本报表控件支持直接写串口和并口的功能，这便于以指令方式操作票据打印机、钱箱和客显等设备(ASP.NET有示例)。ComName属性：设置串口或并口名称，COM1至COM255为串口，LPT1至LPT2为并口。BaudRate属性：串口的波特率，默认为9600。Stopbits属性：串口的停止位，默认为ONESTOPBIT = 0, ONE5STOPBITS = 1, TWOSTOPBITS = 2。这个一般不用修改设置。Bytesize属性：数据位的长度，默认为8。这个一般不用修改设置。TimeOut属性：数据发送超时，串口则为写一个数据位的超时，并口的超时为整个数据的传送时间，默认为3000毫秒。isCheckPrint属性：串口打印时是否检测打印机状态（标准EPSON或仿EPSON打印机有效），默认为0。WriteComData函数，功能为把数据写入端口，参数：要写入的数据。返回值0表示成功，-1表示端口打开失败，-2表示数据发送失败，-3表示打印机故障。此函数在写数据时，会打开端口、写入数据、然后关闭端口，所以在同一个函数中只要调用一次，先把数据组织好，然后再调用此函数一次性写入端口。 本报表控件支持多种语言，对于非简体中文的语言，在安装包中提供PrintActivex(English).exe文件，若要使用此安装包，可把此文件改名为PrintActivex.exe替换示例中的PrintActivex.exe文件，然后客户端再下载安装，也可以直接在客户端双击此文件进行安装。该文件包的语言为英文。本报表控件提供的函数不多，但因为是采用报表文件和数据集分开，可以通过报表设计器设计功能丰富的报表。其设计效率和报表的美观可以和C/S架构的报表设计进行媲美。示例中的ASP所采用的数据库为Access，直接把ASP这个文件夹拷贝到Web服务器所对应的Web文件夹下就可以运行。示例中的ASP.NET所采用的数据库为SQL Server 2000，数据库保存在App_Data目录，直接附加就可以，所采用的开发工具是Visual Studio 2008，运行之前要修改Web.config中PrintTestConnectionString字符串。示例中的PHP所采用的数据库为MySq