5.2 Neue Projekte erstellen

Transkript

1 5.2 Neue Projekte erstellen Das Bearbeiten von bestehenden Projekten und Objekten ist ja nicht schlecht wie aber können Sie neue Objekte hinzufügen oder gar völlig neue Projekte erstellen? Die Antwort liefert Listing 5.3. Listing 5.3: Objekte hinzufügen private void dombutton3_click(object sender, EventArgs e) { // Projektklasse erzeugen und //bestehendes Projekt öffnen ListLabelDomProjectList project = new ListLabelDomProjectList(new ListLabel()); project.open(@"c:\users\public\artikel.lst", LlDomFileMode.Open, LlDomAccessMode.ReadWrite, true); // Textobjekt hinzufügen ListLabelDomObjectText text = new ListLabelDomObjectText(project.Objects); text.name = "DOM-Objekt"; text.position.set(5000, 5000, 7000, 50000); text.direction = "1"; // Neuen Absatz erzeugen ListLabelDomParagraph paragraph = new ListLabelDomParagraph(text.Paragraphs); paragraph.contents = "'Ich wurde per DOM erzeugt'"; // Projekt speichern project.save(); 85

2 5 Projekte per DOM bearbeiten Listing 5.3: Objekte hinzufügen (Forts.) // Projekt schliessen project.close(); } Zwei wichtige Erkenntnisse erschließen sich aus diesem Code: Da Objekte nicht unabhängig von den zugehörigen Auflistungen existieren können, müssen Sie jedem Objektkonstruktor die Auflistung übergeben, in die das neue Objekt hinzugefügt werden soll. Dies gilt im Beispiel für das Textobjekt ebenso wie für den neuen Textabsatz Ersteres wird der Objektliste des Projekts zugewiesen, Letzterer der Liste der Absätze des neuen Textobjekts. Die im DOM verwendeten Koordinaten sind die sogenannten SCM-Einheiten. Eine Einheit entspricht dabei einem 1/1000 mm. Unser Objekt befindet sich also 5 mm vom oberen und linken Rand entfernt, ist 7 mm breit und 5 cm hoch. Ein Blick in den Designer liefert den Beweis wir haben ein neues Objekt erzeugt (Abbildung 5.4). Im letzten Beispiel widmen wir uns der Königsdisziplin wir erstellen ein Projekt von Grund auf neu und fügen einen Berichtscontainer mit Tabelle hinzu. Dazu bedienen wir uns der Einfachheit halber wieder der Datenbasis aus dem ersten Kapitel Sie erinnern sich bestimmt noch an unsere Adressliste. Der Beginn der Prozedur ist ähnlich wie bei den bisherigen Beispielen (Listing 5.4). Im Unterschied zu unseren bisherigen Beispielen wird hier nun eine leere, neue Projektdatei erzeugt. Dementsprechend verwenden wir den Dateimodus LlDomFileMode.Create. 86

3 Abb. 5.4: Unser erstes Objekt Listing 5.4: Erzeugung eines neuen Projekts // Projektklasse und Projekt erzeugen ListLabel LL = new ListLabel(); LL.DataSource = CreateDataSet(); ListLabelDomProjectList project = new ListLabelDomProjectList(LL); project.open(@"c:\users\public\dom.lst", LlDomFileMode.Create, LlDomAccessMode.ReadWrite, false); Zudem haben wir diesmal auf das Ignorieren von Syntaxfehlern verzichtet (letzter Parameter der Open-Methode) und der Eltern- Komponente unseres Projekts die korrekte Datenquelle zugewiesen. Dies bietet Ihnen zum einen die Sicherheit, dass Sie eventuelle Fehler noch vor Ihren Anwendern entdecken, da so schon beim Erzeugen der Datei eine Ausnahme geworfen wird, falls 87

4 5 Projekte per DOM bearbeiten nicht alles wie gedacht funktioniert. Zudem stellen Sie sicher, dass List & Label die Datei im korrekten Modus öffnet. Wie wir bereits gesehen haben, ist der Berichtscontainer nur dann verfügbar, wenn Sie eine Datenquelle mit Relationen-Unterstützung verwenden. Das so erzeugte Projekt enthält noch keinerlei Objekte gehen wir also an die Arbeit und fügen zunächst einen Berichtscontainer mit einer Tabelle ein (Listing 5.5). Listing 5.5: Hinzufügen von Berichtscontainer und Tabelle // Berichtscontainer einfügen ListLabelDomObjectReportContainer container = new ListLabelDomObjectReportContainer (project.objects); container.position.set(15000, 15000, , ); // Personentabelle einfügen ListLabelDomSubItemTable table = new ListLabelDomSubItemTable (container.subitems); table.tableid = "Personen"; Auch hier sehen Sie wieder die typische Erzeugungsart von DOM-Objekten: kein Objekt darf ohne die zugehörige Auflistung existieren und so findet der Berichtscontainer Platz in der Objektliste, die Tabelle dagegen gehört zur Liste der Unterelemente im Berichtscontainer. Um nun die einzelnen Spalten in die Tabelle einzufügen, gehen Sie analog vor eine Datenzeile gehört zur Liste der verfügbaren Tabellenzeilen, eine Spalte ist Teil der Spaltenliste. Der Code in Listing 5.6 ist die logische Konsequenz daraus. 88

5 Listing 5.6: Die Tabelle nimmt Gestalt an. // Datenzeile hinzufügen ListLabelDomTableLineData dataline = new ListLabelDomTableLineData(table.Lines.Data); // Spalten hinzufügen ListLabelDomTableFieldText column1 = new ListLabelDomTableFieldText(dataLine.Fields); ListLabelDomTableFieldText column2 = new ListLabelDomTableFieldText(dataLine.Fields); // Spalteneigenschaften setzen column1.contents = "Personen.Vorname"; column2.contents = "Personen.Name"; column1.width = "90000"; column2.width = "90000"; Starten Sie auch hier den Designer, um sich vom Gelingen der Übung zu überzeugen. Mit diesen Grundlagen sollten Sie nun in der Lage sein, an eigene Experimente zu gehen. Fügen Sie eine Logo-Datei ein oder eine Untertabelle oder erstellen Sie einen eigenen Projektassistenten, der spezialisiert auf Ihre Anwendung und Daten nur die Optionen anbietet, die für Ihre Anwender relevant sind. Sie finden in der List & Label-Installation auch diverse Beispiele für die Anwendung der hier gezeigten Klassen, die Sie als Startpunkt für Erweiterungen verwenden können. 89