Share via


Event Handler Registry Dialog Box (Report Builder)

Allows you to browse the Report Builder's current event handler registry table. If the Report Builder is using its internal registry table, then this dialog box is read-only, and you will not be able to customize the settings.

When the Report Builder has been configured to use an external registry table, the grid becomes editable and you may customize the behavior of the Report Builder for each individual Report Designer event.

Make sure that you have read and understood the Report Builder Event Handler Registry Table topic before you make changes to the table.

Grid

Displays the current Report Designer event handler registry table for editing. This will be read-only unless the Report Builder How to: Specify an Alternate Report Event Handler Table.

  • Type
    Specifies the Handler Type. Valid values are H,F,X,G,E.
  • Class
    Specifies the class name.
  • Library
    Specifies the class library file. This can be a visual (.vcx) or non-visual (.prg) filename.
  • Description
    Allows miscellaneous notes to be entered against each record. Not used by the Report Builder.
  • Event
    Specifies the event type that the handler class is registered to. Use a value of -1 to represent a "wild card" match.
  • Objtype
    Specifies the value of OBJTYPE that the handler class is registered to. Use a value of -1 to represent a "wild-card" match.
  • Objcode
    Specifies the value of OBJCODE that the handler class is registered to. Use a value of -1 to represent a "wild-card" match.
  • Native
    Specifies that, for this event type and object type combination, the Report Builder will not intercept the event but will pass it back to the Designer for "normal" processing.

    Note

    This is not the same as deleting the record from the table. You can use this to force native event handling for a specific event/object, even if more generic/wild-card matches are registered.

  • Debug
    Specifies that, for this event type and object type combination, the Report Builder will use the DebugHandler class rather than that specified by the Class and Library columns.

Add Record

Appends a record to the current event handler registry table and highlights it in the grid, ready for editing. This option will be disabled if the event lookup table is read-only. This is true when the Report Builder's internal lookup table is being used by default.

See Also

Reference

Report Builder Options Dialog Box (Report Builder)

Concepts

Understanding Report Builder Events