Ereignissteuerungs-Skripts

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

Je nach Zweck Ihres Skripts kann dieses nur einmal pro Druckauftrag oder bei jedem einzelnen gedruckten Element ausgeführt werden. Bei einem Druckauftrag sind dies die Ereignisse mit der niedrigsten bzw. höchsten Ausführungshäufigkeit. Zwischen diesen Extremen liegt allerdings eine Vielzahl von Ereignissen, die häufiger als einmal pro Druckjob und weniger häufig als bei jedem Element eintreten.

Für größtmögliche Einfachheit analysiert BarTender im Normalfall Ihre ein- und mehrzeiligen Skripts und versucht dabei, die ideale Ausführungshäufigkeit zu ermitteln. Für die meisten Anwendungen ist dies ausreichend. In manchen Fällen möchten Sie jedoch genau bestimmen, wann Ihr(e) Skript(s) ausgeführt werden.

Ereignistypen

Theoretisch könnten Sie für jede Datenquelle auf Ihrer Vorlage und für jeden von BarTender unterstützten Ereignistyp ein separates Skript haben. Es ist allerdings wesentlich wahrscheinlicher, dass Sie ein Ereignissteuerungs-Skript nur für einen ganz bestimmten Ereignistyp und meist auch nur für eine oder einige wenige Datenquellen ausführen.

BarTender unterstützt die folgenden Ereignissteuerungs-Skripts:

OnAutoSelectedEvent: Wird mit der gleichen Häufigkeit ausgeführt, wie das der Fall wäre, wenn als Typ mehrzeiliges Skript gewählt worden wäre.

Bei Verwendung von regelmäßigen mehrzeiligen Skripts analysiert die Anwendung sowohl Ihr Skript als auch Ihre Vorlage(n) auf der Grundlage einiger voreingestellter Regeln und ermittelt so die besten Zeitpunkte zum Aufrufen des Skripts. Als übergeordnetes Ziel soll ermittelt werden, wie die Optionen für die Serialisierung und zum Druck mehrerer Kopien eingestellt sind. Anschließend ist das mehrzeilige Skript häufig genug auszuführen, um das Dokument wie erforderlich mit neuen Daten zu versorgen, aber nicht häufiger als nötig. Für das Ereignis OnAutoSelectedEvent können Sie ein Skript schreiben, das zu den idealen Zeitpunkten aufgerufen wird, auch wenn Sie andere Skripts verwenden, die mit spezifischen Ereignissen verknüpft sind.
OnScreenUpdate: Wird jedes Mal ausgeführt, wenn die Zeichenkette des verknüpften Objekts auf dem Bildschirm aktualisiert wird.

OnScreenUpdate: Dieses Skript ist ein Sonderfall, da es nicht nur beim Drucken auftritt. Stattdessen wird ein Skript für das Ereignis OnScreenUpdate jedes Mal dann ausgeführt, wenn ein Objekt auf dem Bildschirm aktualisiert wird. Objekte werden auf dem Bildschirm in Reaktion auf eine Reihe von Ereignissen aktualisiert, u. a. beim Klick auf OK, um zur Vorlage zurückzukehren. Zwar mag es andere Einsatzmöglichkeiten geben, die wichtigste Aufgabe dieses Ereignisses ist jedoch die, Skripts zu schreiben, die einem Objekt, das nicht gedruckt wird, auf dem Bildschirm einen Wert zuweisen, der dazu verwendet wird, eine Protokolldatei für einen Druckauftrag anzulegen.
OnPrintStart: Wird ausgeführt, wenn das Dokument geschlossen wird.
OnPrePrompt: Wird unmittelbar vor Anzeige des Dateneingabeformulars ausgeführt – vorausgesetzt, die Dateneingabe ist aktiviert.
OnPostPrompt: Wird ausgeführt, nachdem ein Benutzer zum Schließen des Dateneingabeformulars auf OK geklickt hat.
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. (Nur Daten aus Eingabedatei.)
OnSerialize: Wird ausgeführt, wenn die Serialisierung eintreten könnte. Weitere Informationen siehe OnSerialize.

OnIdenticalCopies: Wird für jedes gedruckte Element ausgeführt, auch wenn es sich um eine Kopie handelt.

Wenn Sie einen Wert größer als Eins in der Option Kopien des Dialogfelds Drucken vorgeben, kann BarTender die Vorlage einmal an Ihren Drucker senden und diesen anweisen, die entsprechende Anzahl von Kopien zu drucken.Wenn Sie jedoch ein Skript für das Ereignis OnIdenticalCopies schreiben, wird dieses für jedes Element ausgeführt, das Sie drucken. Dies gilt dann auch für Kopien. Hierfür ist es erforderlich, dass BarTender die oben erwähnte Druckeroptimierung deaktiviert, was eine erhebliche Leistungseinbuße mit sich bringen kann.

OnPrintCancel: Wird ausgeführt, wenn ein Druckauftrag abgebrochen wird.
OnPrintEnd: Wird ausgeführt, wenn ein Druckauftrag gerade beendet wurde.

Auswahl der Ereignisse, für die Skripts geschrieben werden sollen

Jede Zeile im Fenster Skript entspricht einem eigenen Skript. Wenn Sie ein Skript für ein bestimmtes Ereignis schreiben möchten, klicken Sie auf das entsprechende Element im Fenster Skript.

Nun können Sie alle gewünschten Zeilen von VBScript in das Fenster Editor einfügen. (Denken Sie daran, einer Datenquelle einen Wert zuzuweisen. An einer beliebigen Stelle im Skript muss sich eine Zeile befinden, die mit der Zeichenkette „Value =“ beginnt.)Sie können auf beliebig viele verschiedene Elemente im Fenster Skript klicken und für jedes einzelne ein Skript definieren.

Verwandte Themen