Share via


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.

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

ReportListener Base Foundation Class

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.

ReportListener FXListener Foundation Class

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).

ReportListener Utility and File-handling Foundation Class

The UtilityReportListener class provides run-time configuration options and file-handling.

ReportListener User Feedback Foundation Class

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).

ReportListener XML Foundation Class

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).

ReportListener XML Display-Style Foundation Class

XmlDisplayListener tunes XmlListener's XML settings suitably for presentation output needs. It adds image-file-publishing functionality.

ReportListener HTML Foundation Class

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).

ReportListener Debug Foundation Class

The DebugListener class provides debugging output to help developers understand what happens during an object-assisted report run.

Extending Report Functionality in Visual FoxPro

Understanding the Report Output Application

Using VFP Report Output XML

See Also

Reference

Visual FoxPro Foundation Classes A-Z
Genhtml.prg
FRX Cursor Foundation Class
FRX Device Helper Foundation Class

Concepts

Guidelines for Using Visual FoxPro Foundation Classes