深入QuickReport（一）
作者：董维春
（本文已在《CSDN开发高手》04年第一、二、三期上发表，应广大网友的要求，经编辑同意，发表在CSDN作者本人文档中，略有修改，但仅即于此，未经CSDN或作者本人同意任何个人与网站不得转载、摘抄，否则任何涉及到版权的行为后果自负）
报表是数据库应用程序的基本组成部分之一，完整的数据库应用程序总要提供报表功能。与传统的数据库应用程序设计工具相比，C++ Builder中提供了QuickReport组件，使C++ Builder的数据库功能得到了极大的丰富。
QuickReport是挪威Qusoft AS公司专门为C++ Builder设计的用于报表的一组控件，在C++ Builder上我们使用的QuickReport与专业版的QuickReport相比，在功能上还有很大的差距，但对于我们来说只要充分利用好她，就可以非常快捷的设计出功能强大、模式多样的数据报表，最重要的是她不需要我们花额外的钱去购买。
其实QuickReport并不难，但介绍的这方面的内容实在太少，并且她的帮助文档写得也不太好，让那些想学习QuickReport的C++ Builder爱好者找不到一个正确的、合适的方法。如果你想了解她、使用她，那好吧，让我来帮你认识这个妖女吧，如果此文对你能有所帮助，那是我最大的快乐！
第一部分：QuickReport基本知识
BCB引进的Qusoft公司的报表组件系列，它包括多个组件。首先有必要先简单的了解一下这二十三个组件的基本位置与功能。
一、组件功能简介
上面的两个图是QuickReport组件页的中所有组件，在BCB6中提供给我们使用的不会少于上面的23个的。
下表是按上图中组件的位置先后，对各控件的使用功能逐一做了简单的介绍：
| 1）QuickRep | 带有坐标，作为其他报表控件(如TQRBand)的容器,通过它的Band属性可以自动添加各种类型的TQRBand | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
|
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| 2）QRSubDetail | 建立一个主/明细(master/detail) 报表，连接明细文件的组件 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| 3）QRStringsBand | 可建立一读取 TStrings 中项次值的组件。在这个组件里有一个Items属性，若Items一个值（一行空、一回车行）都没有，那他上面的组件将不会起作用。当String List Editor中有几行，该组件上的内容就重复几次。若只有一行内容时，她与一个DetailBand是一样的；而多行时，也是差不多的，即先重复该区段内的可视组件几次（几行就几次），然后下一个再重复。比如三行，那就是第一个数据来三行，然后第二个数据来三行，再然后，直到最后
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| 4）QRBand | 用来确定在报表的不同位置应该显示什么内容，它上面可以放控件 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| 5）QRChildBand | 在报表中基础子项条列组件。他有一个ParentBand属性，你必须把他与其它band连接起来，只有这样在她里面布置的组件才有效。说直接就是已经有了一个Band而你还需要一个这样的组件，那就用她吧 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| 6）QRGroup | 在报表中对资料做逻辑上分组的组件。当你连接了几个datasets到报表时可以通过Groups成组的对dataset进行操作 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| 7）QRLabel | 打印静态的文本（即不是根据数据库值来改变的），作用象Tlabel 。 Caption的内容就打印出来的内容；AutoStretch是布尔型变量，当标签标题在设定范围内不能打印时，该属性将起作用，若为true，报表将继续打印没有打印完的文本，其它需要打印的文本将依次向后移动，反之，则超出部分不被打印 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| 8）QRDBText | 在报表中具有显示连结资料来源的文字功能的组件 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| 9）QRExpr | 在报表中具有显示陈述句或计算表示式值的组件 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| 10）QRSysData | 在报表中具有显示系统信息的组件 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| 11）QRMemo | 在报表中显示备注文字的组件 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| 12）QRExprMemo | 在报表中是TQRExpr 和 TQRMemo 的混合组件 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| 13）QRRichText | 在报表中具有显示区域文字功能的组件 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| 14）QRDBRichText | 在报表具有显示连结资料来源的区域文字功能的组件 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| 15）QRShape | 在报表中处理几何图形的组件，如方形、圆角方形、椭圆 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| 16）QRImage | 在报表中显示静态的图片，包括（BMP,WMF,ICON） | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| 17）QRDBImage | 在报表中显示从数据库接收的图片 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| 18）QRCompositeReport | 在报表中连结有关与无关的报表组件 ，用于创建混合报表的组件，可以把两个或两个以上的报表连接在一起，组成一个报表 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| 19）QRPreview | 在执行阶段建立自订预览报表组件 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| 20）QRTextFilter | 将报表内容输出于ASCII text 文件 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| 21）QRCSVFilter | 将报表内容输出于CSV文件 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| 22）QRHTMLFilter | 将报表内容输出于HTML文件 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| 23）QRChart | 可以在报表上应用的图表工具 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
二、组件关系表
下图说明了与QuickReport相关组件之间的连接与关系：
┌ADOTable<=| ┌QRChilderBand┐
DataBase<=ADO<=│ |<=====QuickRep<=====├QRBand │<===可视化组件
└ADOQuery<=| └QRStringBand ┘
数据库 ADO引擎 报表容器组件 Band区段（容器） 可视化控件(显示)
注意：可视化组件必须布置在相应的TQRBand区段上，否则将得不到要显示的内容。BDE引擎与这个差不多，他与ADO只是与库联接方式不一样，对QuickReport没有什么影响。
有时有些朋友不小心把可视化组件放在窗体上了，而没有直接放在TQuickRep组件中的各Band区段上，当把这些组件移到想要放置的区段时，发现这些组件不能用，所以你要切记：一定要把组件放在固定的区段上，并且在区段之间也是不能移动的。我们从Object TreeView中可以看到这些组件与TQuickRep是同一层，当然他不可能为TQuickRep工作了，只有他成为TQuickRep中的某一个区段（某个Band）的下一层时，才能正常工作。并且一定要放在一个区段中，不要误认为放在TQuickRep上就行，如果你直接放在TQuickRep上，你的报表中将得不到什么L
三、最大容器TQuickRep
QuickReport中组织层次是特别严格的，TQuickRep是报表组件中必须有的，并且所有Band组件都必须放在她的上面，如果说每个Band区段都是一个小容器的话，那她就是一个最大的容器。想用好QuickReport，TQuickRep绝对不能只看作是一个类似Form的容器，如何用好她对我们用好QuickReport会起到关键性作用。
1）主要属性：
DataSet是TDataSet数据集类型变量，用来设置报表使用的数据集组件对象，在主/明细报表中是主报表的数据集。若我们的报表要用到数据库，她必须指定数据库连接工具的名称，否则你的程序将看不到数据库中的数据。当然，在数据库的连接组件中也一定要把Active设为true，让不你只能在程序运行中动态的把数据库打开，而在程序设计阶段将看不到什么L
RecordCount 是数据集组件对象中记录的数量；
RecordNumber是当前正在打印/显示的记录的索引（第一条记录的索引是0）；RecordCount、RecordNumber两个属性只有打开数据集对象之后，它们才可以访问。
若报表组件成功地从数据集组件对象中提取数据，并生成报表，则Available的属性值为true。
State属性是报表状态信息，它是枚举型变量，可以有以下的取值：
qrAvailable：报表资源已准备好，可以预览或打印；
qrPrepare：正在生成报表；
qrPreview：正在预览报表；
qrPrint：正在打印报表；
qrEdit：正在编辑报表。
Description是TStrings类型属性，它可以用来保存程序员对报表的简单描述。主要是起提示作用。
Page属性是TQuickRep组件中最重要属性，它是TQRPage类型变量，用来设置报表的页面属性。报表组件为她提供了特殊的编辑器，使用组件的快捷菜单Report settings就可以打开Page的属性编辑器窗口。在报表页面属性对话框上可以设置页面的尺寸、边框、分栏、区段等等页面的属性。当然我们也可以在对象查看器中点击 Page前面的“+”展开它的所有属性，并分别设置这些属性。其中PagerSize是设置纸张大小的，他与Width、Length是密切相关的，改变PagerSize的值，后面两个的值也会做出相应的变化，同样，改变后两个属性时，PagerSize的值也会做出相应的改变。我们可以通过改变Orientation的值来改变打印的方向。Margins指的是报表显示内容在PagerSize中的位置。Columns属性我们一定注意，它是分栏设置，与WORD里的分栏设置是一样的，无论出于何种目的，有时我们要把打印内容分成两栏（或多栏）时，这时我们就要用到它，把它的值改为2（或实际栏数），至于栏间的距离我们通过Column space来设定。
Units属性是用来设置纸张的显示单位的，我们通常都选用mm（毫米），当然你要对其它比较了解也可以选用，但我认为最好不要选用其它项。
2）主要方法及事件
TQuickRep提供了大量方法以实现生成、预览和打印报表的功能，但是，它的许多方法是私有成员函数，在类外不允许访问。在实现报表功能时，应用程序经常需要调用Cancel、NewColumn、Preview、PreviewModal、PreviewModeless、Print、PrinterSetup和ResetPageFooterSize几个方面。
Cancel 方法用来撤销当前正在进行的操作，它与把TQuickRep 组件对象的Cancelled属性设置为true是一样的。
NewColumn、Print与PrinterSetup都是与打印有关的方法。其中NewColumn用来强制打印机从新栏开始打印，如果当前栏是页面的最后一栏，则该方法将自动调用方法NewPage ，从新页开始打印。
Preview、PreviewModal和PreviewModeless都是用来预览报表的。
这些方法都不需要使用任何参数。
TQuickRep能够响应的事件主要有：AfterPreview、AfterPrint、BeforePrint、OnEndPage、OnStartPage和OnPreview事件，这些事件的触发与使用方法比较简单，另外在实际应用中运用的并不多，这里就不再多说了。
四、 报表控件摆放的区段
作为报表，它通常有一个固定的模式，最常见的报表主要是由以下六部分组成：
PageHeader：页眉，每页均会出现
|
Title：标题， 只出现在第一页
|
ColumnHeader：所有列的标题，即报表文件的字段区域，每页只会出现一次
|
Detail：记录的内容，一个字段一列，即报表的文本区域（重复区）
|
Summary：摘要（只出现在最后一页）
|
PageFooter：页脚，每页均会出现
在QuickReport中，是通过不同的TQRBand区段来实现的。
TQRBand 是放在TQuickRep组件上面的一个容器，我们在其上面可以放置我们要打印的可视化QuickReport组件。而通过对TQRBand的BandType属性的设置，我们可以改变TQRBand区段的类型，来实现不同区段的功能。
BandType是一个枚举型变量，显然上面常见报表组成表中的那六个部分也一定会出现在BandType的枚举值中，只不过每个前面都加上了前缀rb。我们选择不同的BandType值，就代表不同的区段类型，实现不同的功能，这一点必须注意。
实际上TQRBand的BandType属性值不止上面的六个，她还有以下几个值：
rbGroupHeader：组页眉表格元，用于标志组页中每一页的开始，也用于TQRSubDetail；
rbGroupFooter：组页脚表格元，与rbGroupHeader结合分隔出单页，适用于TQRGroup和TQRSubDetail；
rbSubDetail：字数据表格元，无需手工设置；
rbChilder：字表格元，无需手工设置。
事实上，我们还可以在TQuickRep上来布置区段，我们只要把TQuickRep组件的Band属性前面的“+”点开，就会看到上面那六个值（当然每个前面都加上了Has，可不是rb了），这些值都是布尔型的，我们想要用哪个区段类型的TQRBand，只要把其值设为true，就可以了。从这一点可以看出：前者可以更加灵活的布置Band区段，后者使用起来更加方便、快捷，至于到时候你用哪个，那就看你当时的心情与实际情况了。单纯从结构严谨性上来讲，还是通过TQRBand的BandType来设定区段类型更好一些，并且这样做出的报表出现的问题最少。
五、报表运算组件TQRExpr与系统功能组件TQRSysData
报表运算组件TQRExpr用来提供一些简单的计算功能。Expression属性是她的最重要属性，我们有必要而且也必须掌握好她。
只要单击Expression右端的编辑按钮就可以打开表达式编辑窗口。利用这个编辑器，我们可以比较方便的设计表达式。通过表达式编辑器窗口中的按扭，可以在表达式中插入数据库中的表的字段、函数、数学和逻辑运算符，并可以通过Validate按扭来测试表达式的正确性。
当然，我们也可以直接在编辑器中输入表达式。
在她的函数中IF你一定要用好，因为她会帮我们很多忙，这个函数的对于学过DBASE的程序爱好者来说应该是非常熟悉的，因为在这里她们的使用是一样的；在C中，她与for(;;)语句或“？：”表达式差不多。她的具体使用格式如下：
IF（条件式，为真用这句，为假用这句）
系统功能组件TQRSysData可以为我们提供一些经常用到的系统功能。为了实现这些功能，他提供了两个重要属性Data和Text。
Data是一个枚举类型变量，它有七个取值，如下表：
系统功能类型表（Data取值表）
| 系统功能类型 | 功能描述 |
| qrsTime | 系统时间 |
| qrsDateTime | 系统日期和时间 |
| qrsDetailCount | 需要打印的记录数量 |
| qrsDetailNo | 正在打印的记录索引 |
| qrsPageNumber | 正在打印的页 |
| qrsReportTitle | 报表标题 |
| qrsDate | 系统日期 |
Text属性是字符串类型变量，用来构成完整的系统功能字符串。
Data和Text这两个属性通常是一起使用的。如果将Text设置为“打印时间：”，而将Data设置为qrsDataTime，则系统打印结果为“打印时间：2003-9-21 13：08：12”的形式。
许多情况下，我们更想打印如“第1页”这样格式的页码，使用上面的属性是不能实现的，这就要我们编写代码来实现。在打印/显示报表时，应用程序将触发OnPrint事件句柄。这样我们只要在报表运算组件TQRExpr或系统功能组件TQRSysData的OnPrint中写下如下代码就可以实现了：
void __fastcall TForm1::TQRExpr1Print(TObject *sender, AnsiString &Value)
{
Value="第"+Value+"页";
}
//-------------------------------------------------------------------
或
void __fastcall TForm1::TQRSysData1Print(TObject *sender, AnsiString &Value)
{
Value="第"+Value+"页";
}
//-------------------------------------------------------------------
通过这两段代码我们可以知道，原来这两个组件显示或起作用的就是Value，如果我们不修改Value的值，则直接打印Value内容。由于我们在OnPrint事件中修改了她的值，从而改变了打印的内容。
注意：有些朋友把上面代码输入了进去，却得不到正确的内容，原因很简单:TQRSysData的Data属性值设置不对，这个例子中我们要得到页数，看一下Data的值是不是qrsPageNumber，并且Text的值是否为空；对于TQRExpr组件，你是否通过Expression编辑器的Variable按钮进入了下一页，选择了PAGENUMBER值？这是你不能正确实现代码的问题所在。
六、TQRShape组件
TQRShape组件可以在报表上输出一些简单的图形，设置它的Shape属性可以选择不同的图形，但它主要用于绘制表格线，因此与TShape有些不同，下面我们来看一下Shape的取值：
TQRShape组件Shape属性取值表
| Shape属性取值 | 意义 |
| qrsCircle | 画圆 |
| qrsHorLine | 画水平直线（Height要设为1或其它） |
| qrsRectangle | 画矩形 |
| qrsRightAndLeft | 仅在矩形左右绘直线 |
| qrsTopAndBottom | 仅在矩形上下绘直线 |
| qrsVertLine | 画垂直线（Width要设为1或其它） |
作为画图组件她的四个位置属性最为重要，它们是Top、Left、Height和Width。其实对于QuickRep的绝大多数组件来说，这四个属性也是非常重要的。
在Shape属性值为QrsHorLine/ QrsVertLine时，Height/Width的属性值要改为1或其它，这取决于你线条的宽度。
Brush属性用来设置几何图形内部的填充风格，它包括填充颜色Color和填充图案Style。
Pen属性用来设置用于画图的画笔的属性，它包括Color、Style、Mode、Wide等。
TQRShape组件与TShape组件有许多相同之处，但也有一些不同之处，象Shape属性的取值等等，我们一定注意。其实通过对两个类似组件的对比学习，会加深我们对她们的掌握。如果运用得当，漂亮的线条就会出现在我们面前。
对于TQRShape组件的使用来说更多的是熟练，她应该是所有QuickReport组件中最好掌握的一个了，使用率也是最高的一个，并且TQRShape在表格设计中的作用是其它组件所不能取代的，但本文限于篇幅就不在做过多的解释了。
扫一扫
1283
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
