combit List & Label - Programmierer-Referenz - combit GmbH

4.2. Aufruf des Designers
Aufruf des Designers
Zunächst müssen alle Tabellen bei List & Label bekannt gemacht werden, die Sie dem
Benutzer für das Design zur Verfügung stellen möchten:
LlDbAddTable(hJob, "", ""); // evtl. vorhandene Tabellen löschen
LlDbAddTable(hJob, "Orders", "Bestellungen");
LlDbAddTable(hJob, "OrderDetails", "Bestellposten");
Der erste Parameter ist wie üblich das Job-Handle des List & Label-Jobs. Der zweite
Parameter ist die TableID, dies ist der Wert, den Sie beim Druckvorgang von LlPrintDb-
GetCurrentTable() zurückgeliefert bekommen. Der dritte Parameter ist der Anzeigename
der Tabelle im Designer. Wenn Sie NULL bzw. einen Leerstring übergeben, sind TableID
und Anzeigename identisch.
Eine besondere Rolle kommt dabei dem Tabellennamen "LLStaticTable" zu. Dieser ist
reserviert und kann für das Einfügen von 'statischen' Inhalten (feste Texte oder Inhalte
von Variablen, Chartunterschriften etc.) verwendet werden. Eine solche statische Tabelle
kann vom Benutzer im Designer nur mit Datenzeilen befüllt werden. In Ihrem Code
müssen Sie entsprechend auf die Tabelle reagieren - wie wird im Druck-Unterkapitel
erläutert.
Im nächsten Schritt werden die Beziehungen zwischen den Tabellen definiert. List &
Label unterscheidet hierbei nicht direkt zwischen unterschiedlichen Beziehungstypen
(n:m, 1:n) – Sie melden eine Beziehung einfach mit einer ID an, die Sie hinterher im
Druck abfragen können:
LlDbAddTableRelation(hJob, "OrderDetails", "Orders",
"Orders2OrderDetails", NULL);
Mit diesem Befehl haben Sie bekanntgemacht, dass "OrderDetails" im Designer als Untertabelle
für die Tabelle "Orders" zur Verfügung stehen soll. In diesem Falle wurde nur
die ID der Relation übergeben, diese erscheint dann auch im Designer.
Zuletzt können Sie noch Sortierungen übergeben, die für die jeweiligen Tabellen zur
Auswahl stehen sollen. Auch hier erhält wieder jede Sortierung eine eindeutige ID, die
Sie im Druck abfragen können:
LlDbAddTableSortOrder(hJob, "Orders", "OrderDate ASC",
"Order Date [+]");
LlDbAddTableSortOrder(hJob, "Orders", "OrderDate DESC",
"Order Date [-]");
Nun kann der Benutzer im Designer eine dieser Sortierungen sowie die Grundeinstellung
"unsortiert" auswählen.
57