_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