Kurzbeschreibung

Das XML-Element <TableCell> beschreibt eine einzelne Zelle innerhalb einer Tabellenzeile.

In einer Tabellenzelle werden sämtliche Inhalte einer Tabelle eingefügt und dargestellt.

Einordnung

Bereich: Inhalte → Tabellen

Schwierigkeitsgrad: ⭐⭐⭐☆☆

Vorkenntnisse: Table · TableRow

Siehe auch

• Table
• TableRow
• Iterate

Zweck

Die Tabellenzelle bildet den eigentlichen Arbeitsbereich einer Tabelle.

Während <Table> lediglich die Tabelle beschreibt und <TableRow> die einzelnen Zeilen definiert, befinden sich sämtliche sichtbaren Inhalte innerhalb einer <TableCell>.

Eine Tabellenzelle kann dabei nahezu beliebige XML-Elemente aufnehmen.

Grundstruktur

Eine einfache Tabellenzelle besitzt folgenden Aufbau.

<Table>

    <TableRow>

        <TableCell>

            <Block>

                <Content>

                    <Text Content="Hallo Welt">
                    </Text>

                </Content>

            </Block>

        </TableCell>

    </TableRow>

</Table>

Die Inhalte befinden sich immer innerhalb der Tabellenzelle.

Attribute

<TableCell> besitzt selbst keine Attribute.

Eigenschaften der Tabellenzelle werden über untergeordnete XML-Elemente innerhalb der Zelle beschrieben.

Hierzu gehören beispielsweise:

• Zellbreite
• Zellrahmen
• Zellverbund
• vertikales Verbinden von Zellen
• weitere Layout-Eigenschaften

Hinweis

Welche Eigenschaften zur Verfügung stehen, hängt von der jeweiligen Version des Developers ab.

Die IntelliSense unterstützt bei der Auswahl der verfügbaren Eigenschaften.

Inhalt einer Tabellenzelle

Innerhalb einer Tabellenzelle können nahezu alle XML-Elemente verwendet werden.

Typische Inhalte sind:

• Block
• Text
• Variable
• Hyperlink
• Barcode
• Signatur
• If
• Case
• Iterate
• weitere Tabellen

Dadurch lassen sich sowohl einfache Textbereiche als auch komplexe Layouts erstellen.

Mehrere Inhalte

Eine Tabellenzelle ist nicht auf einen einzelnen Text beschränkt.

Es können beliebig viele Inhalte innerhalb einer Zelle kombiniert werden.

Beispielsweise:

• mehrere Blöcke
• Texte und Variablen
• Bilder und Texte
• Bedingungen
• Schleifen

Dadurch eignet sich eine Tabellenzelle hervorragend als eigenständiger Layoutbereich.

Eigenschaften einer Tabellenzelle

Die eigentliche Funktion einer Tabellenzelle entsteht durch ihre Eigenschaften.

Hierzu gehören unter anderem:

Zellbreite

Bestimmt die Breite der Tabellenzelle.

Dadurch können gleich breite oder unterschiedlich breite Spalten erstellt werden.

Zellrahmen

Rahmen können für einzelne Seiten der Tabellenzelle definiert werden.

Beispielsweise:

• oben
• unten
• links
• rechts

Dadurch lassen sich Tabellen optisch strukturieren.

Zellen verbinden

Mehrere Tabellenzellen können horizontal miteinander verbunden werden.

Dadurch entstehen größere Bereiche innerhalb einer Tabellenzeile.

Dies wird häufig für Überschriften oder Informationsblöcke verwendet.

Vertikal verbinden

Auch Tabellenzellen untereinander können verbunden werden.

Dadurch kann sich ein Inhalt über mehrere Tabellenzeilen erstrecken.

Leere Zellen unterdrücken

Bei Bedarf können leere Tabellenzellen automatisch ausgeblendet werden.

Dadurch entstehen insbesondere bei dynamischen Dokumenten deutlich sauberere Tabellenlayouts.

TableCell als Layoutcontainer

In intracon wird eine Tabellenzelle häufig nicht als klassische Tabellenzelle verwendet.

Stattdessen bildet sie einen eigenständigen Layoutbereich.

Eine Tabellenzelle kann beispielsweise enthalten:

• einen kompletten Briefkopf
• einen Anschriftenbereich
• einen Barcode
• eine Signatur
• einen Informationsblock
• mehrere Absätze

Dadurch lassen sich sehr flexible Dokumentlayouts erstellen.

Zusammenspiel mit Iterate

Eine häufige Kombination besteht aus <Iterate> und <TableCell>.

Iterate

        │

        ▼

TableRow

        │

        ▼

TableCell

        │

        ▼

Variable

Für jede durch <Iterate> verarbeitete Zeile werden die Inhalte der Tabellenzellen erneut ausgeführt.

Dadurch entstehen dynamische Tabellen mit beliebig vielen Datensätzen.

Typische Einsatzgebiete

Tabellenzellen werden verwendet für:

• Briefköpfe
• Anschriften
• Positionslisten
• Formularfelder
• Informationskästen
• mehrspaltige Layouts
• strukturierte Dokumentbereiche

Best Practices

• Jede Tabellenzelle sollte logisch zusammengehörige Informationen enthalten.
• Inhalte innerhalb einer Tabellenzelle sauber strukturieren.
• Mehrere XML-Elemente sinnvoll kombinieren.
• Zellverbünde nur verwenden, wenn sie das Layout tatsächlich vereinfachen.
• Leere Bereiche möglichst vermeiden.

Developer-Tipp

Betrachten Sie eine Tabellenzelle nicht nur als Feld einer Tabelle.

In intracon dient sie häufig als eigenständiger Layoutcontainer, in dem komplette Dokumentbereiche aufgebaut werden.

XML-Wissen

<TableCell> erzeugt selbst keinen sichtbaren Inhalt.

Sie definiert lediglich den Bereich, in dem andere XML-Elemente dargestellt werden.

Erst die darin enthaltenen Blöcke, Texte oder weiteren XML-Elemente erzeugen den eigentlichen Dokumentinhalt.

Typische Fehler

Inhalte direkt in einer Tabellenzeile platzieren

Texte oder andere XML-Elemente dürfen niemals direkt innerhalb einer <TableRow> stehen.

Sie müssen sich immer innerhalb einer <TableCell> befinden.

Zu viele verschachtelte Tabellen

Obwohl Tabellen innerhalb von Tabellen möglich sind, sollten sie nur verwendet werden, wenn sie das Layout tatsächlich vereinfachen.

Zu viele Verschachtelungen erschweren die Wartung einer Dokumentvorlage erheblich.

Zellen ausschließlich als Datentabelle betrachten

Eine Tabellenzelle dient nicht nur der Darstellung tabellarischer Daten.

Sie ist gleichzeitig einer der wichtigsten Layoutcontainer innerhalb einer Dokumentvorlage.

Nächste Schritte

Nachdem Aufbau und Inhalte einer Tabellenzelle bekannt sind, folgt im nächsten Artikel die Gestaltung von Tabellen.

Dort werden Eigenschaften wie Breiten, Rahmen und Layouts näher erläutert.

Empfohlener nächster Artikel: TableLayout