combit List & Label - Programmierer-Referenz - combit GmbH

Direkter Druck und Export aus dem Designer
6. Direkter Druck und Export aus dem Designer
6.1. Einführung
Sie haben die Möglichkeit, die Vorschau im Designer mit den "echten" Daten zu versorgen,
so dass die Anwender den Report so sehen, wie er bei der Ausgabe aussehen
wird. Zudem besteht die Möglichkeit, aus dem Designer heraus zu drucken oder zu
exportieren.
Ihre Entwicklungsumgebung muss folgende Voraussetzungen erfüllen, damit dieses
Feature unterstützt werden kann:
• Sie können auf Callbacks reagieren (s. Kapitel 11. Callbacks und Notifications)
• Sie können einen Thread mit einer Druckprozedur starten und haben Synchronisationselemente
wie Mutex, Critical Section oder ähnliches zur Verfügung.
Die .NET-Komponente unterstützt im datengebundenen Modus automatisch dieses
Feature, sobald eine Datenquelle angebunden wird, die auch zurückgesetzt werden
kann (also z.B. DataTable oder DataSet, nicht aber DataReader). Wenn Sie die Komponente
so verwenden, brauchen Sie den Inhalt dieses Kapitels nicht zu berücksichtigen.
Die von Ihrem Code durchzuführende Aufgabe besteht darin, Ihren Echtdatendruck/export
auszuführen, dies aber - zumindest für die Vorschau - in einem getrennten
Thread. Hierfür gibt es über einen Callback Informationen über die Aufgabe (Start, Abbruch,
Ende, Abfrage des Zustands). Es sind nur geringe Änderungen gegenüber der
normalen Druck/Exportausgabe nötig.
6.2. Vorbereitung
Um List & Label mitzuteilen, dass Sie die Echtdatenversorgung entsprechend der obigen
Anforderungen durchführen können, müssen Sie eine oder beide der folgenden Optionen
setzen:
• LL_OPTION_DESIGNERPREVIEWPARAMETER für die Echtdatenvorschau
• LL_OPTION_DESIGNEREXPORTPARAMETER für den Export aus dem Designer
Den Wert, den Sie in diesen Optionen übergeben, können Sie selbst definieren, beispielsweise
als Zeiger auf interne Datenstrukturen oder Objekte. Sie bekommen diesen
im Callback unverändert wieder geliefert. Wichtig ist für List & Label nur, dass er nicht 0
oder -1 ist.
Über den Callback LL_NTFY_DESIGNERPRINTJOB informiert List & Label Sie über
die durchzuführende Aktion. Dieser Callback wird immer im Kontext des Designerthreads
(dies ist der Thread, von dem aus Sie LlDefineLayout aufgerufen
haben) aufgerufen.
76