Event Control Scripts

Event Control Scripts are one of the most advanced features in BarTender and should only be used by technically knowledgeable individuals.

Depending on the purpose of your script, you might need it to execute as infrequently as once per print job or as often as every single printed item. These are respectively the least frequent and most frequent "events" that occur in a print job. In between, however, there are a variety of events that happen more frequently than once per job but less frequently than every single item.

To keep things as simple as possible, BarTender will normally examine your single-line and multi-line scripts and attempt to determine the ideal frequency with which a script should be executed. For most users and most purposes, this will be sufficient. Sometimes, however, you may need more control and need to explicitly state when your script(s) will execute.

Different Event Types

Although it is very unlikely you would ever need to do so, every data source on your template could potentially have a separate script for every event type supported by BarTender. It is more realistic that, if you do need to write an event script, that you will only need to do so for one particular event type and probably just for one or a few data sources.

Listed below are descriptions of some of the most notable kinds of events.

• When a print job is about to start.

• When a print job has just finished.

• Before displaying the data entry form.

• After a user has pressed OK to close the data entry form.

• On every single printed item. (Can cause significant performance loss.)

• On each new record (when reading from a data source file).

• When serialization might occur.

To see a list of all the event names as defined in BarTender:

1. Set the script Type to "Event Control Scripts."

2. Click on the Edit button to bring up the Script Assistant.

3. View the Event List option.

Open topic with navigation