combit List & Label - Programmierer-Referenz - combit GmbH

Weiterführende Programmierung
3.4. Ansteuerung von Chart- und Kreuztabellen-Objekten
Am einfachsten können Chart- und Kreuztabellenobjekte angesteuert werden, indem Sie
– zusammen mit Tabellen – im Objektfenster "Berichtsstruktur" eingefügt werden. Die
Ansteuerung solcher Berichte wird im Kapitel "4. Ansteuerung des Berichtscontainer-
Objekts" detailliert erläutert.
Für Etiketten- oder Karteikartenprojekte kann aber auch eine getrennte Ansteuerung von
solchen Objekten interessant sein.
Im Folgenden ist nur von "Charts" die Rede, die Ansteuerung funktioniert für Kreuztabellen
analog.
Für die Datenversorgung von Chart-Objekten gibt es neben der oben genannten zwei
weitere Methoden. Welche von beiden Sie verwenden möchten, stellen Sie über die
Option LL_OPTION_USECHARTFIELDS ein. Grundsätzlich funktioniert der Druck mit
Charts dann analog zu dem Tabellendruck, d.h. Sie definieren zunächst eine Datenreihe,
die Sie an die Chartobjekte übergeben möchten und übergeben diese dann mit einem
Aufruf an die Chart-Objekte.
3.4.1. Der Standardmodus (Voreinstellung)
Dieser Modus steht Ihnen nur für Listenprojekte zur Verfügung und benötigt keine Änderungen
an Ihren bestehenden Projekten. Die Chart-Objekte werden hierbei mit den gleichen
Daten wie die Tabellenobjekte versorgt, ein LlPrintFields() übergibt die Daten sowohl
an Tabellen- als auch an Chartobjekte, wobei diese die Werte zunächst nur aufnehmen
und – im Gegensatz zu Tabellen – nicht gleich drucken. Dieser Modus ist aus
Kompatibilitätsgründen zu älteren Versionen noch enthalten und ermöglicht eine einfache
Verwendung von Chartobjekten z.B. hinter Tabellen verkettet.
3.4.2. Der erweiterte Modus
Diesen Modus aktivieren Sie durch Setzen der Option LL_OPTION_USECHARTFIELDS auf
TRUE. In diesem Falle stehen Ihnen neben den Variablen und Feldern noch spezielle
Chart-Felder zur Verfügung. Diese können Sie analog zu Feldern über API-Aufrufe deklarieren.
Ihre Benutzer können damit
� Chart-Objekte an beliebigen Stellen im Ausdruck verwenden
� Chart-Objekte auf Etiketten/Karteikarten verwenden
Ein LlPrintFields() hat in diesem Modus keinen Einfluss auf die Chart-Objekte, der analoge
Befehl hierfür ist im erweiterten Modus LlPrintDeclareChartRow(). Durch diesen API-
Aufruf werden die gegenwärtig definierten Daten an die Chart-Objekte übergeben. Welche
Chart-Objekte dabei angesprochen werden sollen, kann durch den Parameter von
LlPrintDeclareChartRow() bestimmt werden:
Wert Bedeutung
LL_DECLARECHARTROW_-
FOR_OBJECTS
54
Die Daten werden an alle Chart-Objekte übergeben,
die nicht in Tabellenspalten enthalten sind.