Rave报表介绍之二: 可视报表设计器

可视报表设计器

Rave有自己的可视报表设计器,以自己的文件格式保存报表。这有一些优势，你可以把报表
独立于应用程序之外，可独立进行升级，甚至可以通过网络进行更新,或者使用Nevrona的
Rave Report Server。当然，你也可以把报表保存为标准的DFM文件格式。

为了启动可视报表设计器,防止一个TRvProject部件在form上，这个TRvProject部件将是你
的应用程序和你即将要创建的报表的联系。 如果需要，可加一个TRvSystem部件到窗体上，
通过设定RvProject的Engine属性与它挂接。RvSystem部件是作为一个通用的报告系统配置
部件：可通过它设置将要使用的打印机，边界，页数等等。为了开始一个新的报表项目，双
击RvProject部件,或者通过敏感菜单选择"Rave Visual Designer..." 。

一个Rave项目文件将可能由多个报表组成。通过全局页面(Global Pages)可以保存一些报表
间共享的品项。

如果一个属性从缺省值改变为特定值，在属性编辑器中会显示成粗体。

当在可视报表设计器设计好报表后，返回到delphi的IDE中，改变RvProject部件的
ProjectFile属性为你刚才完成并保存的报表文件名。为了运行报表,加一个调用RvProject
对象的Execute方法的过程即可。

如果我们设计的报表项目中只有一个报表，我们仅仅调用RvProject.Execute即可。如果我
们的报表项目中有多个报表，我们不得不在调用Execute前，调用SelectReport来选择特定
的报表，或者调用直接调用ExecuteReport方法。


与报表项目进行交互

参数(Parameters)

参数可以存在于报表项目，报表，报表页面这三个地方，可通过对应对象的parameters属性
进行设定。

你仅能通过报表项目的对象树来选择报表项目和特定的报表。对于报表页面可以通过报表项
目的对象树或页面设计的标题来选择。


参数可通过DataText部件来输出。在页面上加一个DataText组件,打开属性编辑器的
DataField属性。你能在此选择项目变量、参数、后初始化变量。

procedure TFormMain.btnExecuteClick(Sender: TObject);
begin
RvProject.Open; //打开报表项目
RvProject.SelectReport('ParametrizedReport',False); //通过报表名称选择特定的报表
RvProject.SetParam('Name','Leonel'); //给特定参数设定值
RvProject.Execute; //执行报表
RvProject.Close; //关闭报表项目
end;


后初始化变量

后初始化变量是只有在报表已经被打印了才知道值的变量。比如页的总数(TotalPages)就是
后初始化变量，其使用方式类同于一般变量，也是通过DataTexts来打印的。

全局页面
如果有些报表的部分在两个或更多报表中是相同的公用的，你能把这些放置到全局页面中。
比如公司名称、日期和时间、当前页号和总页数等。我们需要每个报表都有这些东西，我们
应该怎么做？

首先，加一个全局页面到报表项目中。在这个页面中，加一个section组件。Sections组件
用于组件的逻辑分组。
在section组件中加入我们想要共享的东西。

在特定报表的特定页，增加另一个section组件。设定该组件的Mirror属性为前面那个全局
页面中的Section组件。你能看见全局页面中的Section组件及其包含的对象均被映射进来
了。对于其它特定的页面，同法炮制，现在多个页面就可以共享一些组件了。



条件打印
有时我们会根据特定的条件打印报表的特定部分。Rave对此提供了强劲的支持。我们可以根
据字段值和参数的条件映射一些sections 。

在新的一个页面中创建一个参数HeaderKind。 它可能的值为H0 (无页头), H1(第一种页
头), H2 (第二种页头)。在全局页面中增加一个新的section组件,它具有第二种页头风格。

返回到ConditionalReport报告Page1的页面，加一个DataMirrorSection部件，设定它的
DataField字段为Param.HeaderKind。打开它的DataMirrors属性编辑器，增加两个Data
Mirrors: 如果值是H1,将打印第一种页头；值是H2, 将打印第二种页头；因为值为H0并不匹
配任何mirrors,将不打印页头。

procedure TFormMain.btnExecuteClick(Sender: TObject);
begin
RvProject.Open; //打开报表项目
RvProject.SelectReport(cmbReports.Text,False); //通过报表名称选择特定的报表
case cmbReports.ItemIndex of
1: RvProject.SetParam('Name',edName.Text); //给特定参数设定值
2: RvProject.SetParam('HeaderKind',Format('H%d',[cmbHeaderKind.ItemIndex])); //
给特定参数设定值
end;
RvProject.Execute; //执行报表
RvProject.Close; //关闭报表项目
end;

镶嵌报表项目文件到应用EXE文件中

通常，当你发布应用程序时，你必须同时包括你的报表项目文件。如果你让报表项目文件成
为一个独立文件,你就可以采用简单方式对其更新而不需要重新编译你的应用程序。如果你
想把报表项目文件包含在你的应用程序的EXE中，也是很简单的，你需要：设定RvProject组
件的StoreRAV属性。你通过Load一个报表项目文件把它包含在DFM中,通过Save可以提取出先
前的一个报表项目文件，通过Clear可以删除镶嵌的报表项目文件。当报表项目文件被装载
进应用程序的EXE中后，你就不再需要同时把报表项目文件打包进发布的应用程序了！

结论

我们学习了如何使用可视报表设计器，以及相应的一些提示。