事件控制脚本

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

根据脚本的用途，有的脚本可能偶尔才执行，一个打印作业只执行一次，有的则需要频繁执行，每一个打印项目就要执行一次。这分别是打印作业中发生的最不频繁和最频繁的“事件”。不过，在这二者之间，还存在多种事件，其发生频率要高于整个作业一次，低于每一个项目一次。

为尽量简化起见，BarTender 通常会检查单行表达式和多行脚本，试着确定脚本的理想执行频率。对于大多数用户和用途而言，这已足够。不过，有时您可能需要更精确地控制并需要明确指出脚本的执行时间。

事件类型

尽管您总是要这么做的可能性很小，但对于 BarTender 支持的每种事件类型，模板中每个数据源仍有可能各有一个脚本。 It is more realistic that, if you do need to write an event script, you will need to do so only for one particular event type and probably just for one or a few data sources.

BarTender 支持使用以下“事件控制”脚本：

OnAutoSelectedEvent：当“类型”设置为“多行脚本”时，以调用脚本的相同频率执行。

使用常用多行脚本时，应用程序会根据某些预定的规则来分析脚本和标签格式的设计，确定脚本的理想调用次数。其总的目的是，评估文档设置其序列化机会和打印份数选项的方式，然后足够频繁地调用多行脚本，以便根据需要为文档提供新数据，但调用次数不超过必需的次数。使用 OnAutoSelectedEvent，您可以编写一个脚本，它会按照“理想”次数调用该脚本，即使您可能使用的是与特定事件关联的其他脚本，也是如此。
OnScreenUpdate：每当关联对象的字符串在屏幕上更新时执行。

OnScreenUpdate：此脚本是唯一的，因为执行并不限于只有在打印时才能进行。相反，OnScreenUpdate 事件脚本将在更新屏幕上的对象的任意时间执行。屏幕上的对象会进行更新以响应大量的事件，包括单击“确定”返回模板。虽然可能存在其他使用情况，但是该事件最重要的任务是编写脚本，以便将屏幕值赋给用于创建打印作业日志文件的非打印对象。
OnPrintStart：关闭文档时执行该代码。
OnPrePrompt：在显示数据输入表单之前执行（如果启用数据输入）。
OnPostPrompt：在用户单击“确定”关闭数据输入表单后执行。
OnNewRecord： Executes when reading from a data source file. An OnNewRecord event script will be executed each time a new record is read from your database or text file at print time. （仅输入文件数据。）
OnSerialize：当可能发生序列化时执行。有关更多信息，请参见 OnSerialize。

OnIdenticalCopies：将在打印期间为每个打印项执行该代码，即使是相同份数，也是如此。

当您在“打印”对话框中的“份数数”选项中设置大于 1 的值时，BarTender 可以将模板发送到打印机 1 次并指导打印机打印所需份数。不过，如果您为 OnIdenticalCopies 事件编写了脚本，则在打印每个项目时都将执行该脚本，即使项目是副本也如此。这就要求 BarTender 禁用前面提到的打印机优化功能，否则会大大降低性能。

OnPrintCancel：取消打印作业时执行。
OnPrintEnd：当打印作业刚刚完成时执行。

选择要为之编写脚本的事件

“脚本”窗格中每行的项都对应一个单独的脚本。如果要为某个事件编写脚本，只须在“脚本”窗格中单击该项。

现在，您可以将所需的任意行 VBScript 插入“脚本”窗格中。 (Don’t forget that to assign a value to a data source, a line of script beginning with "Value =" needs to appear somewhere in the script.) You can click on as many different items in the Script pane as you want and define a script for each one.

相关主题