combit List & Label - Programmierer-Referenz - combit GmbH

Einführung in die Programmierung
für List & Label überhaupt keine Rolle. In den meisten Fällen dürfte vermutlich durch Sie
ein Lesezugriff auf ein entsprechendes Datensatz-Feld einer Datenbank erfolgen.
Um den Designer zur Gestaltung der Druckformulare in Ihre Anwendung einzubauen,
melden Sie per Funktionsaufruf jedes Ihrer vorhandenen bzw. gewünschten Datenfelder
einmal bei List & Label an. Dabei können Sie neben dem Datenfeld-Namen auch noch
optional einen Datentyp (z.B. Text, Numerisch, Logisch, Datum, etc.) übergeben, der
bspw. für die Behandlung der Datenfelder in Formeln u.ä. im Designer relevant wird. Sie
können außerdem einen Beispiel-Feldinhalt übergeben, der zur Designzeit für die Darstellung
im Arbeitsbereich genutzt wird. Wenn Sie eine Echtdatenvorschau unterstützen
wollen, berücksichtigen Sie die Hinweise im Kapitel "6. Direkter Druck und Export aus
dem Designer".
Zur Druckzeit erfolgt die Datenübergabe im Prinzip analog, außer, dass anstatt des Beispiel-Feldinhaltes
von Ihnen der Echtdaten-Feldinhalt übergeben werden muss. Dies
geschieht für alle Felder, während Sie insgesamt über alle Ihre zu druckenden Datensätze
iterieren.
2.6.2. Echtdatenvorschau oder Druck?
Prinzipiell läuft Ihre Druckschleife immer gleich ab, unabhängig davon, ob auf Drucker
(LL_PRINT_NORMAL), Vorschau (LL_PRINT_PREVIEW) oder Datei (LL_PRINT_FILE) gedruckt
wird. Die Unterscheidung wird lediglich in einem Parameter beim Start des
Druckvorganges programmierseitig festgelegt (siehe LlPrint[WithBox]Start()). Sie können
allerdings diese Entscheidung auch dem (End-)Anwender überlassen (LL_PRINT_-
USERSELECT), indem Sie ihm im Drucker-Dialog von LlPrintOptionsDialog() eine Auswahlmöglichkeit
des Druckziels anbieten. Sie selbst bräuchten dann lediglich nach dem
Druckvorgang den Fall, dass sich der Anwender für Preview-Druck entschieden hat,
abzufragen und in diesem Falle den Preview (mittels LlPreviewDisplay()) anzuzeigen.
2.6.3. Exportmodule
Um zusätzlich zu Druck und Preview-Druck die Export-Module benutzen zu können,
können nicht die o.g. LL_PRINT_xxx Flags benutzt werden, in diesem Falle sollten die
Ausgabemedien über die Funktionen LlPrintGetOptionStr() und LlPrintSetOptionStr() mit
den Flags LL_OPTIONSTR_EXPORTS_ALLOWED, LL_PRNOPTSTR_EXPORT eingestellt
werden. Weitere Informationen finden Sie im Kapitel "15. Die Export-Module".
2.6.4. Grundlegender Ablauf
Zunächst wird ein List & Label Job geöffnet (LlJobOpen[LCID]()) und ggf. anschließend
globale List & Label Optionen (LlSetOption()) eingestellt. Nun muss List & Label der Beginn
des Druckvorgangs mitgeteilt werden (LlPrint[With]BoxStart()). Dabei wird außerdem
spezifiziert, welche Etiketten- bzw. Formular-Definitionsdatei genommen werden soll. Zu
diesem Zeitpunkt wird List & Label die angegebene Definitionsdatei öffnen und parsen.
Dabei erfolgt auch eine syntaktische Überprüfung aller verwendeten Variablen, Felder
und Formel-Ausdrücke. Dies bedeutet allerdings, dass List & Label bereits zu diesem
Zeitpunkt alle von Ihnen zur Verfügung gestellten Variablen und Felder kennen muss. Sie
30