使用瀏覽打開主題

根據指令碼的目的，您可能需要僅針對每個列印工作執行一次指令碼，或針對每個列印項目頻繁地執行指令碼。這兩種分別是列印工作中發生頻率最低和最高的事件，但大多數事件的發生頻率都會比針對每個列印工作執行的頻率高，而比針對每個列印項目執行的頻率低。

為了簡化程序，BarTender 通常會檢查您的單行和多行指令碼，並嘗試確定指令碼的理想執行頻率。對於大多數使用者和大多數目的來說，這已足夠。但是，有時候您可能需要更明確地控制指令碼的執行時間。

事件類型

您可以為 BarTender 支援的每種事件類型以及範本上的每個資料來源撰寫單獨的指令碼。但是，這是非常極端的情況。實際上，您只需為一種特定的事件類型以及一個或幾個資料來源撰寫事件指令碼即可。

BarTender 支援使用下列事件控制指令碼：

• OnAutoSelectedEvent：當「類型」設定為「多行指令碼」時，其執行頻率與指令碼呼叫頻率相同。

  當您使用一般的多行指令碼時，應用程式會根據預先設定的規則來分析指令碼和範本的設計，並確定呼叫指令碼的理想時間。總體目標是評估文件序列化機會的組態和份數選項，然後經常呼叫多行指令碼以向文件提供新資料，但不超過必要的頻率。使用 OnAutoSelectedEvent 可以撰寫在「理想」時間呼叫的指令碼，即使您還使用與特定事件關聯的其他指令碼亦然。

• OnScreenUpdate：在螢幕上更新關聯物件的字串時執行。

  OnScreenUpdate：在螢幕上更新物件時執行，而不僅是在列印時執行。系統會透過在螢幕上更新物件來回應許多事件，包括當使用者按一下「確定」以返回至範本時。儘管可能存在其他用途，但此事件的最重要任務是撰寫指令碼，以便為用於建立列印工作日誌檔案的非列印物件提供螢幕值。

• OnPrintStart：在文件關閉時執行。

• OnPrePrompt：如果啟用了資料輸入，則在顯示資料輸入表單之前執行。

• OnPostPrompt：在使用者按一下「確定」以關閉資料輸入表單後執行。

• OnNewRecord：在讀取資料來源檔案時執行。在列印時，每次從資料庫或文字檔案讀取新記錄時，都會執行 OnNewRecord 事件指令碼。僅適用於輸入檔案資料。

• OnSerialize：在可能發生序列化時執行。如需更多資訊，請參閱「OnSerialize」。

• OnIdenticalCopies：即使項目為副本，在列印工作期間也會針對每個列印項目執行。

  當您在「列印」對話方塊的「份數」選項中設定大於 1 的值時，BarTender 可以將範本傳送至印表機一次，並指示印表機列印所需的份數。但是，如果您為 OnIdenticalCopies 事件撰寫指令碼，則即使項目為副本，也會針對每個列印項目執行該指令碼。此程序會要求 BarTender 關閉前面提到的印表機最佳化，印表機最佳化可能會導致效能大幅降低。

• OnPrintCancel：在取消列印工作時執行。

• OnPrintEnd：在完成列印工作時執行。

選取要為其撰寫指令碼的事件

「指令碼」窗格中的每個行項目都對應一個單獨的指令碼。若要針對指定的事件撰寫指令碼，請在「指令碼」窗格中按一下該項目。

現在，您可以將所需的任何 VBScript 指令碼行插入至編輯器窗格中。請記住，若要為資料來源指派值，必須在指令碼中的某處新增一行以 "value =" 開頭的指令碼。您可以根據需要在「指令碼」窗格中按一下任意多個不同項目，並為每個項目定義一個指令碼。

相關主題

• 使用 VBScript 作為資料來源類型
• 單行運算式
• 多行指令碼