Der Designer wird über die Methode Design() aufgerufen und wird dann in einem modalen Pop-up Fenster dargestellt, welches Ihr Anwendungsfenster überlagert. Zuvor muss immer eine Datenquelle zugewiesen werden – diese ist die Basis für die im Designer verfügbaren Daten. Daher gibt es auch keine alleinstehende Design-Anwendung; die Daten werden immer direkt aus der Applikation zur Verfügung gestellt, List & Label selbst greift niemals direkt auf Daten zu.
Der vollständige Aufruf – in diesem Beispiel mit einem DataSet als Datenquelle – wäre:
ListLabel LL =
new ListLabel();
LL.DataSource =
CreateDataSet();
LL.Design();
LL.Dispose();
Standardmäßig wird hierbei ein Dateiauswahldialog für den Anwender angezeigt, in dem er entweder einen neuen Namen für die Berichtsdatei vergeben und so einen neuen Bericht erzeugen kann oder eine bestehende Datei zur Bearbeitung auswählen kann. Natürlich kann dies auch unterdrückt werden – der Abschnitt Wichtige Eigenschaften der Komponente beschreibt dies.
Die Verwendung des Designers selbst ist in der zugehörigen Onlinehilfe bzw. im Designerhandbuch detailliert erklärt. Das Ergebnis des Designprozesses sind in der Regel vier Dateien, die durch den Designer angelegt wurden. Die Dateiendungen können über die FileExtensions-Eigenschaft der ListLabel-Komponente frei bestimmt werden. Die folgende Tabelle beschreibt die Dateien für den Standardfall.
|
Datei |
Inhalt |
|
<Berichtsname>.lst |
Die eigentliche Projektdatei. Diese enthält Informationen über die Formatierung der zu druckenden Daten, nicht aber die Daten selbst. |
|
<Berichtsname>.lsv |
Eine JPEG-Datei mit einer Miniaturdarstellung des Projektes für die Anzeige im Dateiauswahldialog. |
|
<Berichtsname>.lsp |
Datei mit benutzerspezifischen Drucker- und Exporteinstellungen. Diese Datei sollte nicht weitergegeben werden, wenn der Designrechner nicht mit dem Druckrechner identisch ist, da dann der darin angegebene Drucker meist nicht existiert. |
|
<Berichtsname>.~lst |
Wird ab dem zweiten Speichern im Designer angelegt und enthält eine Sicherung der Projektdatei. |
Die wichtigste Datei ist dabei natürlich die Projektdatei. Die anderen Dateien werden von List & Label automatisch zur Laufzeit der Anwendung erstellt.
Zur Druckzeit wird dann aus der Kombination von Projektdatei und Datenquelle der eigentliche Bericht erstellt. In der Praxis ist es häufig auch gewünscht, die Projektdateien in einer zentralen Datenbank zu halten. Wie dies gemacht wird, beschreibt der Abschnitt Projektdateien in Datenbank halten.