用导航打开主题

脚本的用途不同，运行频率也不同，有的需要偶尔运行（每打印作业一次），而有的则需要频繁运行（每打印项目一次）。打印作业中既会有偶尔发生的“事件”，也会有频繁发生的“事件”，但多数事件的发生频率都要高于每作业一次，而低于每项目一次。

为了简化流程，BarTender 通常会检查单行脚本和多行脚本，并尝试确定脚本的理想运行频率。对于大多数用户和用途而言，这就足够了。不过，有时可能需要更明确地控制脚本的运行时间。

事件类型

对于 BarTender 支持的每个事件类型以及模板上的每个数据源，可以单独为它们编写脚本。但是，这种情况很罕见。实际上，只需要为一个特定的事件类型以及一个或几个数据源编写脚本即可。

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

• OnAutoSelectedEvent：当“类型”设置为“多行脚本”时按脚本调用频率来运行。

  使用常规的多行脚本时，应用程序会根据预设的规则来分析脚本和模板的设计，并确定脚本的理想调用次数。一般的目标是评估文档的序列化机会和打印份数的配置，然后频繁调用多行脚本来为文档提供新数据，但不会超过必需的次数。可使用 OnAutoSelectedEvent 编写一个脚本，以按照“理想”次数调用该脚本，即使还使用了与特定事件关联的其他脚本也没关系。

• OnScreenUpdate：每当屏幕上关联对象的字符串更新时运行。

  OnScreenUpdate 事件脚本会在屏幕上的对象每次更新时运行，而不仅是在打印时运行。屏幕上的对象会不时地更新以响应一系列事件，包括用户单击“确定”以返回到模板。虽然可能存在其他使用情况，但是该事件最重要的任务是编写脚本，以便将屏幕值赋给用于创建打印作业日志文件的非打印对象。

• OnPrintStart：关闭文档时运行。

• OnPrePrompt：仅在显示数据输入表单之前运行（前提是已启用数据输入）。

• OnPostPrompt：在用户单击“确定”以关闭数据输入表单后运行。

• OnNewRecord：从数据源文件中读取数据时运行。在打印时，每次从数据库或文本文件中读取新记录时，都会运行 OnNewRecord 事件脚本。仅适用于输入文件数据。

• OnSerialize：发生序列化时运行。有关更多信息，请参阅“OnSerialize”。

• OnIdenticalCopies：在每个打印项目（包括副本）的打印作业期间运行。

  在“打印”对话框中的“份数”选项中设置大于 1 的值时，BarTender 可以将模板发送到打印机一次，并指示打印机打印所需的份数。不过，如果为 OnIdenticalCopies 事件编写了脚本，那么会针对每个打印的项目运行该脚本，即使是副本亦然。此过程要求 BarTender 关闭前面提到的打印机优化功能，否则会大幅降低性能。

• OnPrintCancel：取消打印作业时运行。

• OnPrintEnd：打印作业完成时运行。

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

“脚本”窗格中每行的项都对应一个单独的脚本。要为给定事件编写脚本，请在“脚本”窗格中单击该事件。

现在，可以根据需要将任意行数的 VBScript 插入到编辑器窗格中。请注意，要为数据源分配值，必须在脚本中的某处添加一行以“value =”开头的代码。在“脚本”窗格中，可以根据需要单击任意多个不同的项目，然后为每个项目定义一个脚本。

相关主题

• 使用 VBScript 作为数据源类型
• 单行表达式
• 多行脚本