Events and Scripts

This chapter talks about two interconnected features of DBM: events and scripts. Both features are new with DBM 5.12, and will be extended to cover additional use cases.

Events occur when DBM is about to do something, has finished doing something, or needs information while doing something. Events have names by which they can be identified.

Events can trigger execution of a script which can modify the action DBM is about to take, e.g. by providing additional or overriding information.

Scripts are short pieces of text which look like what you may have seen on a programmer’s computer screen. They can query information, perform some actions, trigger DBM actions, or provide information to the event.

If you have worked with Turbo Player macros before, you will immediately recognize the structure and syntax of DBM scripts because they build on the same basics. However, there are several DBM specific additions.

Examples

The event called “PreDrawGridLine” occurs (we also say: “is fired”) every time DBM starts to fill a grid line (also called “row”). When this event is connected to a macro, this macro can, for example, define the background color for this line.

The “PreDrawGridField” event is fired when DBM wants to display or update the content of a grid field (or “cell”). The connected macro can manipulate the value to be displayed. It can even substitute the value a set of icons.

Details

Please read more in the pages listed here.