Objektmodell (DOM)

Während der Designer eine sehr komfortable und mächtige Oberfläche zur Bearbeitung der Projektdateien bietet, kann es oft auch gewünscht sein, Objekt- oder Berichtseigenschaften direkt per Code zu bestimmen. So kann die Anwendung z. B. dem Anwender einen vorgeschalteten Dialog zur Datenvorauswahl anbieten und den Designer bereits mit einem so vorbereiteten Projekt öffnen. Ein Beispiel hierfür zeigt das "Simple DOM Sample".

Der Zugriff auf das Objektmodell ist erst ab der Professional Edition möglich.

Die folgende Tabelle listet die wichtigsten Klassen und Eigenschaften aus dem Namespace combit.Reporting.Dom auf.

 

Klasse

Funktion

ProjectList
ProjectLabel
ProjectCard

Die eigentlichen Projektklassen. Diese stellen das Wurzelelement des Projektes dar. Schlüsselmethoden sind Open, Save und Close.

<Projekt>.Objects

Eine Auflistung der Objekte innerhalb des Projekts. Die Objekte sind von ObjectBase abgeleitet und verfügen jeweils über eigene Eigenschaften und ggf. Auflistungen (z. B. Textabsätze).

<Projekt>.Regions

Eine Auflistung der Layout-Bereiche des Projekts. Hierüber kann z. B. eine seitenabhängige Druckersteuerung realisiert werden. Weitere Informationen finden sich im Abschnitt Layout-Bereiche.

ObjectText

Repräsentiert ein Textobjekt. Schlüsseleigenschaft ist Paragraphs, der eigentliche Inhalt des Texts.

ObjectReportContainer

Repräsentiert einen Berichtscontainer. Schlüsseleigenschaft ist SubItems, der eigentliche Inhalt des Berichtscontainers.

SubItemTable

Repräsentiert eine Tabelle innerhalb des Berichtscontainers. Diese besteht aus verschiedenen Zeilenbereichen (Lines-Eigenschaft), die wiederum verschiedene Spalten (Columns-Eigenschaft einer Zeile) haben.

 

Innerhalb der einzelnen Klassen findet sich über die IntelliSense-Unterstützung recht einfach die gesuchte Eigenschaft. Eine vollständige Referenz über alle Klassen liefert die Komponentenhilfe für .NET.