Functions for Event Handling

AddEvent procedure

Adds an event handler for a specific event. The event handler is the name of a macro.

AddEvent(event, handler, event_specific_parameters)

Name	Required?	Type	Documentation
`event`	yes	string	The name of the event that should trigger the handler
`handler`	yes	string	The name of the script that should handle the event. The script must be stored in the Digas registry in the DBM\Macros key under this name.
`event_specific_parameters`	depends	string	Additional parameters; number and meaning depends on the event.

The event parameter can have one of the following values:

Event name	Triggered when	Additional Parameters
`PreDrawGrid`	when a grid is about to be updated	`grids` – comma-separated list of grids to which the handler should apply. If empty or not present, applies to all grids.
`PreDrawGridField`	when a field (cell) of a grid is about to be updated	`grids` – comma-separated list of grids to which the handler should apply. If empty or not present, applies to all grids. `columns` – comma-separated list of grid column names or titles to which the handler should apply. If empty or not present, applies to all columns.

Event name

Triggered when

Additional Parameters

PreDrawGrid

when a grid is about to be updated

grids – comma-separated list of grids to which the handler should apply. If empty or not present, applies to all grids.

PreDrawGridField

when a field (cell) of a grid is about to be updated

grids – comma-separated list of grids to which the handler should apply. If empty or not present, applies to all grids.

columns – comma-separated list of grid column names or titles to which the handler should apply. If empty or not present, applies to all columns.

Nothing

AddEvent("PreDrawGridField", "PreDrawGridField_Handler", "ENTRIES, GROUP_MEMBERS, SEARCH_RESULT", "special/custom_field")

Currently not available.