combit List & Label - Programmierer-Referenz - combit GmbH

Programmiergrundlagen
Beim Druck auf Preview generiert List & Label eine Datei, welche alle gedruckten Vorschau-Seiten
als Grafik enthält. Diese Datei hat die feste Endung .LL und kann auch
jederzeit mit dem eigenständigen LLVIEW-Programm angesehen werden. Der Pfad, in
dem die LL-Datei erzeugt wird, lässt sich mittels LlPreviewSetTempPath() angeben.
Bei Druck auf eines der Exportmodule werden Dateien in einem vom Programm oder
dem Benutzer anzugebenden Pfad angelegt. Bitte informieren Sie sich in der Dokumentation
des Exportmodules über dessen Eigenschaften. Abfragen kann man eine Liste der
erstellten Dateien mit LL_OPTIONSTR_EXPORTFILELIST.
Wenn eine Projektdatei gespeichert wird, wird eine Sicherungskopie angelegt. Der Name
der Sicherungskopie wird erstellt, indem eine Tilde ("~") vor die Projekt-Endung gesetzt
wird, beispielsweise wird aus der Endung ".LST" die Endung ".~LST".
Wenn das Laufwerk, auf der die Projektdatei liegt, keine langen Dateinamen unterstützt,
wird eine solchermaßen berechnete Endung auf 3 Zeichen gekürzt, hier also ".~LS".
2.4. Programmiergrundlagen
Dieses Kapitel soll den schnellen und einfachen Einstieg in die Programmierung von
Druckausgaben mit List & Label ermöglichen. Aus diesem Grund werden hier lediglich
die Grundlagen erläutert, für eine fortgeschrittenere Programmierung lesen Sie bitte die
weiterführenden Kapitel.
2.4.1. Der List & Label Job
Damit List & Label die einzelnen Anwendungen, die mit List & Label drucken möchten,
unterscheiden kann, ist ein sog. Jobmanagement erforderlich: Jede Anwendung, die
eine Funktionalität von List & Label nutzen möchte (Druck, Designer, etc.) muss dazu
vorher einen Job öffnen (LlJobOpen(), LlJobOpenLCID()) und das zurückerhaltene Jobhandle
dann bei allen anderen List & Label Funktionsaufrufen mit übergeben.
Entwickeln Sie mit einer der mitgelieferten Komponenten, so wird dieses Jobmanagement
automatisch durch das Control erledigt. Dementsprechend entfällt bei allen OCX-,
VCL- und .NET-Funktionen das Jobhandle als Parameter.
2.4.2. Variablen und Felder in List & Label
In List & Label werden zwei Arten von Datenfeldern grundlegend unterschieden: Es gibt
Datenfelder, die pro gedruckter Seite (bzw. pro Etikett oder Karteikarte) nur einmal mit
Daten gefüllt werden (sprich: von Ihrer Anwendung mit Echtdateninhalt angemeldet
werden), dies sind in der List & Label Terminologie "Variablen". Dem gegenüber stehen
die Datenfelder, welche mehrfach auf einer Seite mit unterschiedlichen Daten gefüllt
werden, zum Beispiel die einzelnen Datenfelder einer Postenliste einer Rechnung. Diese
Datenfelder werden in der List & Label Terminologie "Felder" genannt. Diese Felder stehen
in Tabellenobjekten, die in List & Label für solche "Listen- oder Wiederholbereiche"
zuständig sind, zur Verfügung.
21