收藏 分销(赏)

第二十一章QReport报表程序开发-C++-Builder--简体中文版.ppt

上传人:天**** 文档编号:14653278 上传时间:2026-10-25 格式:PPT 页数:52 大小:2.11MB 下载积分:10 金币
下载 相关
第二十一章QReport报表程序开发-C++-Builder--简体中文版.ppt_第1页
第1页 / 共52页
第二十一章QReport报表程序开发-C++-Builder--简体中文版.ppt_第2页
第2页 / 共52页


点击查看更多>>
资源描述
按一下以编辑母片标题样式,按一下以编辑母片文字样式,第二层,第三层,第四层,第五层,*,第二十一章QReport报表程序开发,报表程序能把程序的执行结果转成报表的形式透过打印机进行输出,是很多应用程序不可或缺的功能,而透过,C+Builder,提供的报表开发组件能大幅简化这类程序的开发过程,但却不因此而丧失其功能性,透过本章的说明,相信开发报表程序对你,(,妳,),将不再是个难题。,大纲,21-1浅谈QReport,21-2QuickRep组件,21-3,条列式报表程序,21-4,图案式报表程序,21-5,卷标式报表程序,21-6,合成式报表程序,21-7,报表进阶技巧,21-1.浅谈QReport,在C+Builder中的报表以带状的概念来呈现整份文件,而这些带状的内容分别对应到一般熟悉的报表格式,包括页首、标题、内容、页尾等部分。底下为文件格式和C+Builder中各带状间的对应关系描述。,21-1.浅谈QReport,对应到的带状则如下所列:,文件格式,对应带状名称,描述,页首,rbPageHeader,打印于每一页报表的最顶端,其中第一页可透过属性的设定决定是否打印。,表头,rbTitle,打印于报表的首页,紧接在页首打印之后。,字段标头,rbColumnHeader,打印于数据集合的最顶端,可用来显示数据集合的字段,若数据集合内容超过一页时,字段标头亦会重复出现在每页的数据集合顶端。,群组标头,rbGroupHeader,若字段内容以群组方式打印时,该标头内容出现在打印群组数据之前。,21-1.浅谈QReport,实际编辑的带状画面则如下图所示,图中各颜色的带状分别对应了上表不同的带状名称,而画面中的颜色纯粹只供方便显示之用。,rbPageHeader,rbTitle,rbColumnHeader,rbGroupHeader,rbDetail,rbGroupFooter,rbSummary,rbPageFooter,21-1.浅谈QReport,上图中如此多样的带状设定其实是个别分开的,也就是每个不同的带状各自为一个,VCL,组件,放置在一个称为,QuickRep,的组件上,而该组件才真正代表一份文件,不过,QuickRep,组件并没有要求就所有的带状内容进行设定,因此你可以根据实际使用情形来决定带状使用的种类与数目。,当设定好报表使用的带状类型后,还必须设定每个带状所要显示的内容,而这些内容的显示亦必须透过其它,Quick Report,的显示组件来达成,就像一张空白的窗体必须加上,Label,、,Edit,、,Memo,或是,Image,等组件才能显示其它数据,报表程序最常使用到的组件不外乎,QRLabel,、,QRDBText,、,QRSysData,等,每个组件同样可就显示位置、字型或颜色等属性进行设定,部分组件的功能说明如下表所示。,21-1.浅谈QReport,组件名称,叙述,QRLabel,打印文字,而文字内容取决于,Caption,属性的设定,类似,Label,组件的使用。,QRDBText,打印数据库的字段数据,类似,DBText,组件的效果,同样必须指定,DataSource,和,DataField,属性。,QRExpr,多功能的显示组件。允许显示数据集合的字段内容、运算处理后的内容和单纯的文字数据,而内容的决定则靠,Expression,属性值的设定。,QRSysData,专门打印系统信息,包括页数、时间或是打印日期等。,QRMemo,适合打印大量非数据库内的文字数据使用。,QRShape,负责在报表上绘制图形,包括方形、圆形或直线等。,QRRichText,报表上的,RichEdit,组件,可以在该组件的范围内填入,RichText,的文字数据。,21-2.QuickRep组件,前一节中简单的介绍了报表的运作方式和C+Builder提供的报表相关组件,其中QuickRep组件用来表示整份报表,而其它带状元件或显示组件皆置于QuickRep组件之上,由此可了解QuickRep组件在报表程序中的重要性,而其提供的属性和方法自然也直接影响到报表输出的方法和形式,因此,我们独立一个小节来专门说明QuickRep组件。,21-2-1.,常用属性,属性,说明,Options,该属性共分三个小项:,FirstPageHeader:设定报表的第一页是否显示页首(PageHeader)带状内容。,LastPageFooter,:设定报表的最后一页是否显示页尾,(PageFooter),带状内容。,Compression,:设定报表产生时是否在内存中进行压缩,默认值为,False,不压缩。,PrintIfEmpty,设定如果所打印的数据集合不含任何数据时是否仍需执行打印的动作,默认值为,True,,代表无论如何皆执行报表的打印工作。,ReportTitle,设定报表的标题,当执行预览打印时,该属性设定值决定预览窗口左上角的标题内容。,ShowProgress,设定在传递报表内容至打印机输出时,是否显示目前的传递进度,默认值为,True,显示进度。,21-2-1.,常用属性,除了上述属性设定外,还可就报表的输出格式进行设定。请先拖拉QuickRep组件至窗体上,并在QuickRep组件内单按鼠标右键点选【Report Settings】进行设定,操作方式如下图所示:,21-2-1.,常用属性,属性,说明,Paper size,设定纸张的格式,可直接选择一般格式或是自订纸张大小,其中,Portrait,设定为直印,而,Landscape,设定为横印。,Margins,设定内容显示于窗体上的边界。,Other,设定整份报表的预设字型,该属性会影响到整份报表内组件的字型属性。,Page frame,设定是否加上表格外框和设定外框格式。,Bands,透过选取方式设定整份报表内含有的,Bands(,带状格式,),,省去拖拉带状组件的麻烦。,21-2-2.常用方法,ExportToFilter,利用该方法的呼叫转换报表文件成不同的格式输出,包括,HTML,、,TXT,、,CSV,和,xls,等,其中转换,HTML,格式范例如下,详细说明请参考,21-7,小节的介绍。,#include,void _fastcall TForm1:Button3Click(TObject*Sender),TQRHTMLDocumentFilter*htmlfilter=new TQRHTMLDocumentFilter(Report.htm);,Form2-Table1-Open();,Form2-QuickRep1-ExportToFilter(htmlfilter);,Form2-Table1-Close();,delete htmlfilter;,21-2-2.常用方法,Preview和PreviewModel,两方法的功用皆为产生预览窗口,不同的是:,Preview,产生的窗口并非,Modal Window,,也就是可在未关闭该窗口情况下变换作用中的窗口,但必须关闭该预览窗口后才能继续执行后面的程序内容;反之,,ShowModal,即为,Modal Window,,不允许在未关闭该预览窗口前变更作用中的窗口。两者的差别类似于开启窗体的,Show,和,ShowModal,两方法。,PrinterSetup,开启打印机的设定对话框,类似对,PrinterSettings,属性的设定。,Print,把产生的报表内容传至打印机并输出。,21-2-3.常用事件,属性,说明,AfterPrint,输出报表内容至打印机后触发。,BeforePrint,输出报表内容至打印机前触发。,AfterPreview,预览打印后触发。,OnStartPage,在产生一页新报表后触发,可用来指定绘制在该报表上的内容或是对报表上任何计算进行归零的动作。,最后,由于,QuickRep,是透过,Print,、,Preview,或,PreviewModal,等方法的呼叫来呈现报表格式的内容,而非像一般的,VCL,组件是藉助窗体来直接显示,所以一般皆是利用额外的窗体来放置报表组件,再对该窗体内,QuickRep,组件的方法,(Print,、,Preview,和,PreviewModal,等,),进行呼叫达成显示的目的,因此,最基本的报表项目程序皆会有两个窗体,其中的主窗体为程序执行时的显示画面,副窗体则包含,QuickRep,报表相关组件供主窗体呼叫之用。往后的操作实例中皆会看到这样的应用。,21-3.,条列式报表程序,在对报表组件稍有概念后,本小节将以实例操作的方式说明如何制作一个条列式报表程序,而这类报表也是一般最常使用到的打印方式。简单来说就是从数据集合内逐笔的读取数据并显示在报表内。,【,操作实例,21-1】,条列式报表程序,透过,BDE,连结方式读取,employee.db,范例数据表的内容,并产生对应的报表程序。,21-3.,条列式报表程序,开启新项目,在窗体中,(,窗体名称为,Form1,,程序代码为,Main.cpp),新增,Table,、,DataSource,、,DBGrid,和,Button,组件如下图所示,重要属性如下表所列。,属性,组件,Name,DatabaseName,TableName,Active,DataSet,DataSource,Table,Table1,BCDEMOS,employee.db,True,-,-,DataSource,DataSource1,-,-,-,Table1,-,DBGrid,DBGrid1,-,-,-,-,DataSource1,21-3.,条列式报表程序,新增一个窗体,(,窗体名称为,Form2,,程序代码为,Report.cpp),并拖拉,QuickRep,组件至该窗体中,接着双击该,QuickRep,组件就报表格式进行设定。在设定对话框中我们勾取,Title,、,Columnheader,和,DetailBand,三种带状格式选项,如下图所示。,设定完成后的报表编辑画面,21-3.,条列式报表程序,新增报表内显示组件。此程序使用的报表显示组件有,QRLabel,和,QRDBText,两种,其中,QRLable,组件单纯显示文字内容;,QRDBText,组件则从数据集合内的指定字段读取数据,报表编辑画面如下所示:,属性,组件,Name,Alignment,DataField,DataSet,QRDBEdit,QRDBEdit1,taLeftJustify,EmpNo,Form1-Table1,QRDBEdit,QRDBEdit2,taRightJustify,FirstName,Form1-Table1,QRDBEdit,QRDBEdit3,taLeftJustify,LastName,Form1-Table1,QRDBEdit,QRDBEdit4,taLeftJustify,PhoneExt,Form1-Table1,QRDBEdit,QRDBEdit5,taLeftJustify,HireDate,Form1-Table1,QRDBEdit,QRDBEdit6,taLeftJustify,Salary,Form1-Table1,QuickRep,QuickRep1,-,-,Form1-Table1,21-3.,条列式报表程序,回到,Form1,窗体设定按钮对应的程序代码如下,并在,Form1,所属的,Main.h,中加入,#include Report.h,程序代码。,void _fastcall TForm1:Button1Click(TObject*Sender),if(Table1-Active=false),Table1-Active=true;,Form2-QuickRep1-Print();/执行打印的动作,/-,void _fastcall TForm1:Button2Click(TObject*Sender),if(Table1-Active=false),Table1-Active=true;,Form2-QuickRep1-PreviewModal();/预览打印,21-3.,条列式报表程序,执行程序后按下按钮即可看到报表画面。,【,执行结果,】,说明:,更改QuickRep的ReportTitle属性即可改变预览窗口中左上的标题内容(上图中由于没设定,所以标题内容为Print Preview)。,21-4.,图案式报表程序,在前一节中了解了报表的基本操作,本小节将更进一步的为报表加入显示图片的功能,而使用到的组件为,QRDBImage,,底下为操作实例的说明。,【,操作实例,21-2】,图案式报表,透过组件的使用制作一个能显示图案内容的报表程序,而数据来源为,C+Builder,提供的,Biolife.db,范例数据表。,21-4.,图案式报表程序,开启新项目,在窗体中加入两个按钮和,RadioGroup,组件,除此,额外新增一个窗体供报表制作之用,并在该新增窗体中加入,Table,组件。窗体和报表格式如下两图所示。,21-4.,图案式报表程序,在主表單,(Form1),中加入對應事件的程式碼。,(,檔名為,Main,.cpp,),在,Main.h,中加入,include,程序代码。,执行程序,根据,RadioGroup,的选取状态呈现不同的报表效果。,【,执行结果,】,#include Report.h /-include Report,21-4.,图案式报表程序,【,执行结果,】,透过,QRDBImage,和,QRDBRichText,组件的使用,报表输出的内容变得更多样化:其中,QRDEImage,显示图文件;,QRDBRichText,显示不限字数的长字符串,由于这些格式皆不确定其内容大小,因此透过单纯的拖拉并不能保证能完整显示其内容,为此,QRDBImage,提供了,Stretch,属性;,QRDBRichText,提供了,AutoStretch,属性来确保内容能完整呈现,也就是说,Stretch,为,true,时,影像会根据,QRDBImage,组件所设定的大小来调整;,AutoStretch,为,true,时会自动调整,QRDBRichText,的大小以让文字内容能完整输出在报表上,而本实例则透过选取属性值的方式让读者实际了解属性作用的差异。,21-5.,卷标式报表程序,所谓的卷标报表就是非单字段的报表,以一张A4的输出可能为3*4的形式,适合用于名片或是商品标签的打印,因为这类东西本身的宽度均不及报表的一半,如果一列只印一份数据将造成纸张的浪费,所以才会考虑一列包含多份数据的内容以节省报表的长度,而在实际使用上,和前面小节介绍的报表仅在QuickRep属性设定上略有差异。请看下面的操作实例说明。,21-5.,卷标式报表程序,【,操作实例,21-3】,员工识别证的打印,从C+Builder提供的employee.db数据表中读取所有员工数据,以制作每位员工的识别证。,开启新项目,设定窗体画面如下显示,(,窗体名称为,Form1),。,21-5.,卷标式报表程序,新增一个窗体并拖拉,Table,和,QuickRep,组件至该窗体中,接着双击,QuickRep,组件以开启报表设定对话框就报表格式进行设定,而设定内容则如右图所示:在这里我们点选了,Page header,和,Detail hand,两个带状,并设定,Number of columns,为,2,。,(,窗体名称为,Form2),21-5.,卷标式报表程序,按下上图的,【OK】,按钮以关闭对话框,接着编辑窗体内容如下图所示,重要属性以下面表格呈现,而详细属性设定请参考书附光盘内的原始码。,属性,组件,Name,DatabaseName,TableName,DataSet,Brush,Pen,Data,Table,Table1,BCDEMOS,employee.db,-,-,-,-,QuickRep,QuickRep1,-,-,Table1,-,-,-,QRShape,QRShape1,-,-,-,color=,clMoneyGreen,【同,Brush,】,-,QRShape,QRShape2,-,-,-,color=clWhite,color=clBlack,-,QRSysData,QRSysData1,-,-,-,-,-,qrsPageNumber,21-5.,卷标式报表程序,本步骤专门说明,QRExpr,的设定方式。,QRExpr,为功能强大的报表显示组件,不但能显示数据集合内字段,还可显示,QReport,额外提供的函式计算结果与表达式结果,而在本操作实例中,我们将透过该组件来显示两个数据域位的内容。首先请设定该组件的,Master,属性为,QuickRep1(,这里的,QuickRep,必须先设定好,DataSet,属性为,Table1,,且,Table1,的,Active,必须为,true),,接着点选,Expression,属性以弹出,Expression Wizard,对话框,并依照以下的图解步骤设定,Expression,内容。,开启Express Wizard,21-5.,卷标式报表程序,Expression Wizard设定步骤(如光标所示),Step 1.,Step 2.,Step 3.,Step 4.,21-5.,卷标式报表程序,Step 5.,Step 6.,Step 7.,Step 8.,验证,完成设定,21-5.,卷标式报表程序,回到主表單對應的程式檔,(Main,.cpp,),中,加入各按鈕對應事件的程式片段,並在,Main.h,中加入,Include,的內容。,Main,.cpp,Main.h,內容。,执行程序。,【,执行结果,】,【,实例说明,】,本程序透过,QuickRep,的,Report Settings,内的,Number of columns,属性达到卷标打印的效果,另外也介绍了功能强大的,QRExpr,组件使用方法,和能增添报表美观的,QRShape,组件。,21-6.,合成式报表程序,前面范例中,一份报表的内容均为同一来源,但当内容来源变得复杂而不再是单一格式,或是一份报表是由多份报表组合而成时,前面的方法就显的有点力不从心,此时,若能合成多份报表于一份时就可克服格式或来源不一的难题了,而本小节就将透过操作实例的说明来带领读者进入更复杂的报表世界。,【,操作实例,21-4】,不同报表的合并输出,透过,QRCompositeReport,组件的使用,我们合并,【,操作实例,21-1】,和,【,操作实例,21-2】,所介绍的报表于一张报表中。,21-6.,合成式报表程序,开启新项目,设计主窗体,(,窗体名为,Form1),画面如下。,新增窗体,Form2,,并在该窗体中设定两份报表,QuickRep1,和,QuickRep2:,其中,QuickRep1,参考,【,操作实例,21-1】,;,QuickRep2,参考,【,操作实例,21-2】,,两窗体的内容如下:,属性,组件,DatabaseName,TableName,DataSet,Font,Table1,BCDEMOS,employee.db,-,-,QuickRep1,-,-,Table1,Name=,细明体,Size=12,报表一,21-6.,合成式报表程序,属性,组件,DatabaseName,TableName,DataSet,DataField,Stretch/AutoStretch,Font,Table2,BCDEMOS,biolife.db,-,-,-,-,QuickRep2,-,-,Table2,-,-,Name=,细明体,Size=12,QRDBRichText,-,-,Table2,Notes,false,【同上】,QRDBImage,-,-,Table2,Graphic,true,【同上】,报表二,21-6.,合成式报表程序,在,Form2,中新增,QRCompositeReport,组件,而该组件为本程序运作的灵魂中心:透过,QRCompositeReport,组件的,Add,方法把所有合成的报表加入,QRCompositeReport,中,也就是本程序中的,QuickRep1,和,QuickRep,。,在,Form2,表單中,(Report,.cpp,和,Report.h),編輯下列的程式碼。,Report.h,Report,.cpp,在,Form1,中加入對應的程式碼。,Main.h,Main,.cpp,执行程序。,21-6.,合成式报表程序,【执行画面】,报表一,报表二,主窗体画面,21-6.,合成式报表程序,【实例说明】,QRCompositeReport组件允许合并多个报表进行输出,而所要合并的报表透过QRCompositeReport的Add方法加入到QRCompositeReport中,所以QRCompositeReport可视为一个特大号的报表组件,同样也包含ReportTitle、PrinterSettings等属性设定。执行打印的方法同样为Print()和Preview(),而比较值得注意的是:Add方法的呼叫必须在QRCompositeReport的OnAddReports事件中完成,另外,本程序亦在QuickRep2的BeforePrint事件中加入换页的方法,以确保同时打印两份报表时能有所区别,这些说明都可再上面程序代码中看到实际的用法。,21-7.,报表进阶技巧,前面介绍的操作实例中,我们直接透过报表组件的Preview和Print方法进行打印的动作,虽然完成透过打印机输出的目的,但却无法对打印机的内容或是输出的范围进行设定,似乎仍稍嫌美中不足。因此,在本小节中我们将介绍如何透过打印对话框来对打印机的内容进行设定,这些设定内容包括:打印机选择、打印范围、打印份数等,另外,除了单纯的纸张输出外,C+Builder的报表组件还允许报表内容以HTML、TXT和CSV档进行输出,提供的更多样的显示弹性。,21-7.,报表进阶技巧,【,操作实例,21-5】,进阶报表应用,对,【,操作实例,21-1】,的程序稍作修改,使其能对打印机的内容进行设定,并允许报表内容以,HTML,档案呈现。,开启,【,操作实例,21-1】,所介绍的项目,并修正主窗体画面如下,在画面中,我们新增的一个按钮和一个,PrintDialog,组件,其中,PrintDialog,组件负责打印对话框的显示。,属性,组件,Name,FromPage,MaxPage,MinPage,ToPage,Options,PrintDialog,PrintDialog1,1,999,1,1,poPageNums=true,21-7.,报表进阶技巧,在,Form2(,报表组件所在的窗体,),中新增,QRHTMLFilter,组件如下。该组件并不需要额外的属性设定。,修改主表單的程式片段。,Main,.cpp,在,Main.h,中加入,#include,的程序代码。,21-7.,报表进阶技巧,执行程序。当按下,【,打印,】,按钮后会弹出打印对话框供使用者就打印方式进行设定,而按下,【HTML,输出,】,则直接产生,HTML,输出档。,【,执行画面,】,主画面,打印对话框,HTML,格式输出,21-7.,报表进阶技巧,【执行画面】,本实例利用,PrintDialog,显示标准的打印对话框,而打印对话框中的设定则反映到,QuickRep,的,PrinterSettings,属性中,进而影响报表的输出,至于,HTML,档案的输出则透过,QReport,提供的转换组件,QRHTMLFilter,组件来完成,而标准,C+Builder,内附的,QReport,还支持,TXT(QRTextFilter),和,CSV(QRCSVFilter),的转换,其中,CSV,档案可由,Excel,开启,不过,转换组件并不支持对,QRRichText,、,QRDBRichText,、,QRShape,、,QRImage,、,QRDBImage,组件的转换。,本章习题,习题,QReport,报表打印的基本组件为何?该组件以何种概念作为报表的输出?,简述,QuickRep,组件内各带状的功用。,简述,QuickRep,组件内,Preview,和,PreviewModal,方法的不同。,试实作三份报表的合并输出,其中每份报表亦允许单独输出。,试透过,QRTextFilter,组件将报表内容改以,TXT,档案格式输出。,
展开阅读全文

开通  VIP、SVIP  下载更划算
下载10份以上建议开通 VIP 会员
下载20份以上建议开通SVIP会员


开通VIP      成为共赢上传

当前位置:首页 > 通信科技 > 开发语言

移动网页_全站_页脚广告1

关于我们      便捷服务       自信AI       AI导航        关注我们

©2010-2026 宁波自信网络信息技术有限公司  版权所有

客服电话:0574-28810668  投诉电话:18658249818

gongan.png浙公网安备33021202000488号   

icp.png浙ICP备2021020529号-1  |  浙B2-20240490  

关注我们 :微信公众号    抖音    微博    LOFTER 

客服