_REPORTBUILDER System Variable

Specifies the application used by the Report Designer to handle builder events.

For more information on report builders, see How to: Extend or Replace the Report Builder

_REPORTBUILDER = cProgramName

Parameters

  • cProgramName
    Specifies the name of an application or program that the Report Designer calls when a builder event occurs. You can also specify an empty string (""), which causes dialog boxes to appear as in versions prior to Visual FoxPro 9.0.

    Note

    If the application is located in a directory other than the current default directory, include a path name with the program name.

Remarks

By default, _REPORTBUILDER specifies the path and file name for the ReportBuilder.app located in the main Visual FoxPro directory.

You can also specify a builder application file using the File Locations tab in the Options dialog box. For more information, see File Locations Tab, Options Dialog Box.

The application you specify with _REPORTBUILDER must be modal in operation, accept parameters passed to it from the Report Designer and return appropriate values for the first parameter, which is passed by reference.

Visual FoxPro does not generate an error if it does not locate an application for _REPORTBUILDER. The Report Designer raises builder events only if you specify a valid application or program file.

Note

When distributing report builders with your applications, you may find it convenient to explicitly set _REPORTBUILDER in the Visual FoxPro configuration file, Config.fpw. For more information, see Including Report Files for Distribution and Setting Configuration Options at Startup.

Example

The following line of code sets the _REPORTBUILDER system variable to the default Report Builder application:

_REPORTBUILDER = HOME(1)+"ReportBuilder.app"

See Also

Tasks

How to: Extend or Replace the Report Builder

Reference

System Variables
System Variables Overview