ReportListener Foundation Classes
The Visual FoxPro 9 Report System includes a number of new features designed for extensibility, including a new ReportListener base class. When you use ReportListener-based classes, the Visual FoxPro Report Engine executes your REPORT FORM or LABEL FORM command in a new*, object-assisted*, reporting mode.
The classes in the _REPORTLISTENER.vcx Foundation Class Library showcase these features. They provide easy access to the derived ReportListener classes delivered with the Report Output Application.
.png)
The ReportListener-based classes in this class library are identical to the classes built into the Report Output Application. However, they do not rely on REPORTOUTPUT.APP. When you want to use these classes in applications, you can include the _REPORTLISTENER.vcx class library from the Foundation Class (FFC) folder into your project and be assured that you have all the necessary files.
Tip
Some of the classes in this library use helper classes. You will find these helper classes in a companion library, _FRXCURSOR.vcx, which is also included in the Foundation Class folder. When you build _REPORTLISTENER.vcx into your application, the Project Manager will take note of the reference to the _FRXCURSOR class library and include the appropriate files automatically.
In This Section
| Class | Description |
|---|---|
This class, _ReportListener, serves as the superclass for the other classes in _REPORTLISTENER.vcx. It provides core services similar to the superclasses for other Visual FoxPro base classes available in _BASE.vcx. |
|
The FXListener class enables you to change the display characteristics of report controls during a report run. It uses two member collections: FXs (adjust content and format instructions) and GFXs (adjust or replace GDIPlus-graphics rendering). |
|
The UtilityReportListener class provides run-time configuration options and file-handling. |
|
The UpdateListener class provides user feedback during report runs. The Report Output Application uses UpdateListener as its designated default ReportListener class for Print and Preview output (ListenerType values 0 and 1). |
|
The XmlListener class provides XML output from a report run. The Report Output Application uses XmlListener as its designated default ReportListener class for XML output (ListenerType value 4). |
|
XmlDisplayListener tunes XmlListener's XML settings suitably for presentation output needs. It adds image-file-publishing functionality. |
|
HtmlListener applies custom specifications for HTML production to the XML output of XmlDisplayListener. The Report Output Application uses HtmlListener as its designated default ReportListener class for HTML output (ListenerType value 5). |
|
The DebugListener class provides debugging output to help developers understand what happens during an object-assisted report run. |
Related Sections
Extending Report Functionality in Visual FoxPro
Understanding the Report Output Application
See Also
Reference
Visual FoxPro Foundation Classes A-Z
Genhtml.prg
FRX Cursor Foundation Class
FRX Device Helper Foundation Class