How to: Configure the Report Builder's Event Handling

The Report Builder can be set to respond to events in the Report Designer in a number of different ways. It can:

• Use a lookup table mapping Report Designer events with specific handler classes. This is the default handle mode.

• Use a "debug" handler class for all events.

• Notify you of each event as it occurs with a MESSAGEBOX() alert containing information about the parameters that would be passed to the builder. The Report Designer then processes the event as if the builder were not active.

• Ignore the events completely.

This setting is adjusted from the Report Builder's Options dialog box, or by using the Report Builder's command-line parameters.

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

Setting the builder's Event Handling mode using the Options dialog

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

To use the event handler lookup table (default)

1. Open the Report Builder Options dialog box.

2. Set the Report Designer event handling option to Search for a handler class in the handler registry table.

3. Select Close to dismiss the dialog box.

For more information, see How to: Specify an Alternate Report Event Handler Table.

To use the Debug Event handler class

1. Open the Report Builder Options dialog box.

2. Set the Report Designer event handling option to Use the debug handler for all events.

3. Select Close to dismiss the dialog box.

See Report Builder Debug Event Dialog Box (Report Builder) for more information.

To signify each event with a MESSAGEBOX() alert

1. Open the Report Builder Options dialog box.

2. Set the Report Designer event handling option to Use the event inspector for all events.

3. Select Close to dismiss the dialog box.

In this mode, the report builder alerts you to the event occurring, but does not handle the event, passing it back to the Report Designer for normal handling.

To ignore all report builder events

1. Open the Report Builder Options dialog box.

2. Set the Report Designer event handling option to Ignore builder events completely.

3. Select Close to dismiss the dialog box.

The Report or Label Designer will respond to the event normally as though _REPORTBUILDER were empty. See _REPORTBUILDER System Variable for more information.

Setting the builder's Event Handling mode using the command-line

The Report Builder also exposes this setting via a command-line parameter:

To set the event handle mode from the Command Window

• Type the following command:

  DO (_REPORTBUILDER) WITH 4, iHandleMode

  - OR -

  DO (HOME()+"reportbuilder.app") WITH 4, iHandleMode

The iHandleMode must be an integer from 1 to 4, representing the four possible event handling modes described above.

See Also

Reference

Report Builder Options Dialog Box (Report Builder)

Report Builder Event Handler Registry Table

Other Resources

Extending Reports at Design Time