combit List & Label - Programmierer-Referenz - combit GmbH

3.1.2. Erläuterung
Aufruf des Designers
Wenn die Einstellung von List & Label Optionen gewünscht ist, müssen diese vor Aufruf
des Designers vorgenommen werden.
Normalerweise wird nun der Benutzer über eine Dialogbox gefragt, welche Datei er
bearbeiten möchte. In unserem Fall nehmen wir an, dass er ein Etikett bearbeiten will.
Wichtig ist, dass 'buf' vorinitialisiert wurde - entweder auf einen leeren String (""), oder
auf einen Dateinamenvorschlag, incl. Pfad:
TCHAR buf[_MAX_PATH];
_tcscpy(buf, "c:\\mylabel.lbl");
LlSelectFileDlgTitleEx(hJob,hWindow, "Etikett auswählen", LL_PROJECT_LABEL, buf,
sizeof(buf), NULL);
Bei Verwendung des OCX- oder VCL-Controls kann man sich den Puffer sparen:
sFilename = "c:\mylabel.lbl";
LL1.LlSelectFileDlgTitleEx(me.hWnd, "Etikett auswählen", LL_PROJECT_LABEL, sFilename,
"")
Natürlich können Sie den Aufruf auch mit einer eigenen Dialogbox realisieren, oder Sie
können den Dateinamen ohne Benutzerabfrage dem Designer übergeben, falls nicht
gewünscht ist, dass der Benutzer wählen kann.
Jetzt müssen List & Label die möglichen Variablen mitgeteilt werden, damit es diese
dem Benutzer in der Variablenliste zur Verfügung stellt. Sonst könnte der Benutzer nur
festen Text in die Objektdefinitionen übernehmen.
Zuerst wird der Variablenpuffer gelöscht (falls schon Variablen definiert wurden, aber der
Aufruf ist zur Sicherstellung eines leeren Variablenpuffers empfehlenswert):
LlDefineVariableStart(hJob);
Jetzt kann man die Variablen auf mehrere Arten angeben. Wenn der Designer zu einer
Variablen eine Beispiel-Übersetzung kennt, wird diese im Preview-Fenster statt des
Variablennamens verwendet, um eine realistischere Preview-Darstellung zu gewährleisten.
LlDefineVariable(hJob, "Vorname", "Otto");
LlDefineVariable(hJob, "Name", "Normalverbraucher");
Im Preview wird der auf dem Designer-Arbeitsblatt stehende Ausdruck
'Vorname+" "+Name'
in die Ausgabe
'Otto Normalverbraucher'
umgesetzt.
Die erweiterte Variablendefinition mit LlDefineVariableExt() wird benutzt, um andere
Variablentypen als Text, z.B. für Barcode-Objekte oder Zeichnungen zu definieren.
Wenn auch Listenobjekte gebraucht werden, also ein Projekt des Typs LL_PROJECT_-
LIST bearbeitet werden soll, muss der Programmierer die hier möglichen Felder zur Verfügung
stellen. Dies geschieht analog zu oben (auch z.B. Barcode-Felder und Zeichnun-
35