How to: Specify an Alternate Report Event Handler Table

  • Article

Reportbuilder.app contains an internal lookup table that defines whether certain report object / builder event combinations are ignored or directed to specific classes for handling.

See Report Builder Event Handler Registry Table for detailed information on the required structure of the lookup table.

Reportbuilder.app has a mechanism that allows you to specify alternate event handler lookup tables so that you can completely customize how the report builder responds to events in the Report or Label Designer.

Important

Unlike the settings in the Visual FoxPro Options Dialog Box (Visual FoxPro), this preference setting does not persist between Visual FoxPro sessions.

Setting the Event Registry Table using the Options Dialog

The Report Builder Options Dialog Box (Report Builder) includes the ability to specify which event handler lookup table the report builder uses.

The Current registry table text box displays the filename of the lookup table that the report builder is using. If the builder is using the table built-in to the application, this will read "internal lookup table."

To specify an alternate lookup table

  1. Open the Report Builder Options dialog box. See How to: Display the Report Builder Options Dialog Box for detailed steps describing how to display the dialog box.

  2. Select Use alternate lookup table.

  3. Click the ellipsis (…) to display the File Open dialog box.

  4. Select the desired table, and click OK.

  5. Select Close to dismiss the options dialog box.

To revert to using the internal lookup table

  1. Open the Report Builder Options dialog box. See How to: Display the Report Builder Options Dialog Box for detailed steps describing how to display the dialog box.

  2. Select Use internal lookup table.

  3. Select Close to dismiss the options dialog box.

Setting the Event Registry Table using Command-line parameters

You can use the report builder's command-line parameters to set the lookup table that it uses to locate builder event handler classes.

To select an alternate lookup table

  1. Open the Command window.

  2. Type one of the following commands:

    • DO (HOME() + "reportbuilder.app") WITH 3, cFilename

    • * OR:

    • DO (_REPORTBUILDER) WITH 3, cFilename

The cFilename parameter must be a fully pathed file specification of a table (.dbf) file that contains the required fields. For more information on the required table structure, see Report Builder Event Handler Registry Table .

You can use an asterisk to force the report builder to use its internal lookup table:

To force the use of the internal lookup table

  1. Open the Command window.

  2. Type one of the following commands:

    • DO (HOME() + "reportbuilder.app") WITH 3, "*"

    • * OR:

    • DO (_REPORTBUILDER) WITH 3, "*"

If you pass the report builder an empty string, the report builder will revert to default behavior, which is to look for a table named "reportbuilder.dbf" in the current PATH, and use it if found. If it isn't found, the report builder will use the internal lookup table.

To revert to default behavior

  1. Open the Command window.

  2. Type one of the following commands:

    • DO (HOME() + "reportbuilder.app") WITH 3, ""

    • * OR:

    • DO (_REPORTBUILDER) WITH 3, ""

See Also

Tasks

How to: Configure the Report Builder's Event Handling

Reference

Report Builder Options Dialog Box (Report Builder)

Other Resources

Extending Reports at Design Time