| | Visual FoxPro9.0中扩展报表系统功能 |
| | | | | | [文章信息] | | | 作者: | 陶刚编译 | | 时间: | 2004-12-07 | | 出处: | 天极网 | | 责任编辑: | 方舟 | |
| [文章导读] | | | 本文介绍Visual FoxPro 9报表监听器的概念、报表运行时它是如何接收事件、以及如何建立自己的监听器 | |
| |
|
| | | |
|
|
|
|
|
微软在2004年岁末发布最新版Visual Foxpro 9.0，这则消息让我们回想起曾经风光无限的Foxpro，现在它已经被Java、Delphi、VB等众多明星遮掩了光芒，有人认为如果不是诞生在豪门微软，它肯定已经消失。但了解Visual Foxpro的都知道，Visual Foxpro的卓越性能是无法代替的。新版Visual Foxpro 9.0在Foxpro社区引起了轰动，新版中将包含一个更快的本地数据引擎，支持更多的数据类型，SQL语句执行中有更大的一致性，一个完全重新设计的可扩展报表编写器，以及一系列效率和功能增强特性。
在Visual FoxPro 9.0的报表系统出现了难以置信的改进。在本文中，我只讨论几个新增功能中的一个——扩展运行时报表引擎（runtime reporting engine）的能力。
Visual FoxPro小组在处理运行时改进工作时一直紧记着几个目标，包括：
- 处理打印和预览之外的多种报表输出
- 使用GDI+进行报表输出。这会带来很多显著的改进，例如精确地显示、图像和字体的平滑调整，以及一些附加的能力（例如文本旋转）
- 提供一个更加灵活和可扩展的报表系统
你可以同时访问旧的和新的报表引擎，因此你可以根据需要选择在哪种引擎下运行报表。但是一旦你看到新的报表引擎的优点，你就再也不希望使用旧式报表了。
报表系统的架构
Visual FoxPro 9以前版本中的报表系统类似于单片电路：它处理所有细节信息，只有少量的例外（用户定义的函数、报表带条的OnEntry和OnExit表达式等等），在报表运行的时候，你是不能与它交互操作的。
新的报表引擎把报表的功能分成了两部分：现在的报表引擎只处理数据和对象定位；一种新对象（报表监听器）处理显示和输出的事务。由于报表监听器是类（class），因此我们现在可以使用以前梦寐以求的方式与报表进程交互操作。
新的报表语法
Visual FoxPro 9支持使用旧的报表引擎运行报表；你可以像以前一样使用REPORT命令（尽管你可以使用新命令重载REPORT的行为）。为了得到新式的报表行为，必须使用REPORT命令的OBJECT子句。OBJECT子句支持两种使用方法：指定报表监听器和指定报表样式。微软把它归纳为对象辅助（object-assisted）报表。
报表监听器是提供新式报表行为的对象。报表监听器是基于Visual FoxPro 9的新的基础类ReportListener的。为了让Visual FoxPro 9使用报表指定的监听器，需要实例化监听器类，并在REPORT命令的OBJECT子句中指出该对象的名称。下面是一个例子：
loListener = createobject('MyReportListener')
report form MyReport object loListener |
如果不希望手动实例化监听器，可以通过指定报表类型让Visual FoxPro自动为你完成实例化过程，例如：
| report form MyReport object type 1 |
已经定义好的类型有：
- 0——从打印机输出
- 1——预览
- 2——某个时刻的页面信息模式，但不会输出到打印机
- 3——所有页面模式，但不会调用预览窗口
- 4——XML输出
- 5——HTML输出
当然我们还可以使用其它的用户自定义类型。
使用这种方式运行报表的时候，将调用新的_REPORTOUTPUT系统变量（默认情况下它位于Visual FoxPro主目录的ReportOutput.APP中）中指定的应用程序来决定指定该类型使用哪种监听器类来实例化。它是通过查看APP中内建的监听器注册表（尽管你可以指定它使用一个外部表）中的监听器类型来实现的。如果它找到了需要的类，它就实例化该类并传递该监听器对象的一个引用到报表引擎中。因此，在REPORT命令中使用OBJECT TYPE 某种类型的效果与下面的代码的效果是相同的：
loListener = .NULL.
do (_ReportOutput) with SomeType, loListener
report form MyReport object loListener |
报表监听器
在报表运行的过程中，伴随着报表事件的发生，Visual FoxPro把这些事件暴露给基于ReportListener基类的对象。Visual FoxPro帮助文件记录了ReportListener的属性、事件和方法（PEMs），但是在本文中我只讨论其中最有用的一些。
表1列举了ReportListener类的最常使用的一些属性。
表1：ReportListener类的一些有用属性
属性
|
描述
|
CurrentDataSession
|
报表数据的数据对话ID
|
FRXDataSession
|
FRX游标的数据对话ID
|
GDIPlusGraphics
|
用于显示的GDI+绘图对象句柄
|
ListenerType
|
监听器生成的报表输出类型。默认值是-1（无输出），你应该把它改成符合需要的值。它的值与REPORT 命令的OBJECT TYPE 子句中规定的值是相同的。
|
OutputPageCount
|
被显示的页面的数量
|
QuietMode
|
如果它的值为.T. (默认值是 .F.) 就支持进度信息
|
表2显示了经常使用的ReportListener的事件和方法。
表2：ReportListener的一些有用的事件和方法
|
事件/方法
|
描述 |
LoadReport
|
在FRX被载入和打印机假脱机操作被打开前调用 |
UnloadReport
|
在报表运行之后调用 |
BeforeReport
|
在FRX被载入但是报表运行前调用 |
AfterReport
|
报表运行后调用 |
BeforeBand
|
处理某个报表条带前调用 |
AfterBand
|
处理某个报表条带后调用 |
EvaluateContents
|
显示某个字段前调用 |
Render
|
显示对象的时候调用 |
OutputPage
|
向特定的设备输出指定显示的页面 |
|
|
|
|
|
|
|
|
|
