combit List & Label - Programmierer-Referenz - combit GmbH

Ansteuerung des Berichtscontainer-Objekts
4. Ansteuerung des Berichtscontainer-Objekts
List & Label bietet Ihnen komfortable Möglichkeiten, Druckprojekte mit mehreren Datenbanktabellen
(hierarchische Reports) zu gestalten. Dies stellt die für den Anwender komfortabelste
Art dar, mit mehreren Tabellen, Kreuztabellen und Charts zu arbeiten. Grundsätzlich
verwenden Sie für solche Projekte den Projekttypen LL_PROJECT_LIST.
Im folgenden wird "Tabelle" als Synonym für eine Gruppe zusammengehöriger Felder
im List & Label-Designer bzw. im Berichtsstruktur-Toolfenster verwendet. Sie sind hierbei
nicht an "echte" Datenbanken gebunden, auch Klassenarrays oder dynamisch erzeugte
Daten können eine "Tabelle" darstellen, z.B. alle Member-Variablen einer Klasse.
Beachten Sie, dass Sie im List & Label Designer dennoch nur mit einem einzigen Berichtscontainer-Objekt
arbeiten. Dieses kann aber mehrere Unterobjekte wie Tabellen,
Kreuztabellen und Charts enthalten.
Bei der Ausgabe im Druck sind sie ebenfalls nicht an die Tabellenausgabe gebunden –
mit dem gleichen Code werden auch Kreuztabellen sowie Chartobjekte (auch in Tabellenspalten)
gefüllt.
Sobald Sie einzelne Tabellen über LlDbAddTable() hinzugefügt haben, können Ihre Anwender
im Designer mit einem neuen Toolfenster arbeiten – dem Berichtsstruktur-
Fenster. Weitere Hinweise zum Design finden Sie im entsprechenden Kapitel des Designerhandbuchs.
Dieses Kapitel konzentriert sich auf die Fragen der Ansteuerung solcher
Reports.
Die .NET- und VCL-Komponenten bieten Ihnen eine komfortable Datenbankanbindung –
wenn Sie Ihre Daten in einem DataSet mit DataRelations (.NET) bzw. einem DataSet
(VCL) darstellen können, brauchen Sie sich in der Regel nicht um die Ansteuerung zu
kümmern – in diesem Falle können Sie die folgenden Abschnitte überspringen.
Für viele andere Programmiersprachen sind Beispiele für die Ansteuerung von List &
Label bei Verwendung mehrerer Tabellen im Lieferumfang enthalten.
4.1. Benötigte API-Funktionen
Die API-Funktionen, die Sie für die Ansteuerung dieser Funktionalität benötigen beginnen
einheitlich mit LlDb... bzw. LlPrintDb... Sie können Tabellen hinzufügen (LlDbAdd-
Table()), Sortierungen innerhalb der Tabellen zur Verfügung stellen (LlDbAddTableSortOrder())
und Beziehungen zwischen Tabellen definieren (LlDbAddTableRelation()).
Zur Druckzeit können Sie dann die derzeit aktive Tabelle abfragen (LlPrintDbGetCurrent-
Table()) sowie analog die gerade aktive Beziehung und Sortierung erhalten (LlPrintDb-
GetCurrentTableSortOrder(), LlPrintDbGetCurrentTableRelation()). Ausführliche Beispiele
für die Verwendung dieser Funktionen finden Sie im Laufe dieses Kapitels.
56