TableRow

Kurzbeschreibung

Das XML-Element <TableRow> beschreibt eine einzelne Zeile innerhalb einer Tabelle.

Jede Tabellenzeile besteht aus einer oder mehreren Tabellenzellen (<TableCell>), in denen sich die eigentlichen Inhalte befinden.

Einordnung

Bereich: Inhalte → Tabellen

Schwierigkeitsgrad: ⭐⭐☆☆☆

Vorkenntnisse: Table

Siehe auch

• Table
• TableCell

Zweck

Eine Tabelle besteht aus einer oder mehreren Tabellenzeilen.

Jede Tabellenzeile dient dazu, logisch zusammengehörige Informationen innerhalb einer gemeinsamen horizontalen Zeile anzuordnen.

Innerhalb einer Tabellenzeile befinden sich anschließend eine oder mehrere Tabellenzellen.

Grundstruktur

Eine Tabelle mit einer einzelnen Tabellenzeile besitzt folgenden Aufbau:

<Table>

    <TableRow>

        <TableCell>

            ...

        </TableCell>

    </TableRow>

</Table>

Eine Tabelle kann beliebig viele Tabellenzeilen enthalten.

Mehrere Tabellenzeilen

Zusätzliche Zeilen werden einfach nacheinander eingefügt.

<Table>

    <TableRow>

        ...

    </TableRow>

    <TableRow>

        ...

    </TableRow>

    <TableRow>

        ...

    </TableRow>

</Table>

Jede <TableRow> beschreibt genau eine Zeile innerhalb der Tabelle.

Inhalt einer Tabellenzeile

Innerhalb einer Tabellenzeile befinden sich ausschließlich Tabellenzellen.

Table

└── TableRow

    ├── TableCell

    ├── TableCell

    └── TableCell

Die Anzahl der Tabellenzellen bestimmt gleichzeitig die Anzahl der dargestellten Spalten dieser Zeile.

Eigenschaften einer Tabellenzeile

<TableRow> besitzt selbst keine Attribute.

Eigenschaften einer Tabellenzeile werden über untergeordnete XML-Elemente innerhalb der Zeile definiert.

Je nach gewünschtem Aufbau können beispielsweise folgende Eigenschaften verwendet werden:

• Höhe der Tabellenzeile
• Verhalten bei Seitenumbrüchen
• weitere Darstellungsoptionen

Diese Eigenschaften wirken sich immer auf die gesamte Tabellenzeile aus.

Hinweis

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

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

Zeilenhöhe

Die Höhe einer Tabellenzeile kann explizit festgelegt werden.

Dadurch lassen sich beispielsweise

• gleich hohe Zeilen,
• Formularbereiche oder
• strukturierte Informationsblöcke

einfach erstellen.

Ist keine Höhe definiert, passt sich die Tabellenzeile automatisch an ihren Inhalt an.

Seitenumbrüche

Für Tabellen mit vielen Zeilen kann gesteuert werden, wie sich eine Tabellenzeile bei einem Seitenumbruch verhält.

Dadurch kann beispielsweise verhindert werden, dass eine einzelne Zeile auf zwei Seiten verteilt wird.

Gerade bei Positionslisten oder Formularen verbessert dies die Lesbarkeit des erzeugten Dokuments.

Unterschied zwischen Zeilen und Spalten

Eine Tabellenzeile verläuft immer horizontal.

┌──────────┬──────────┬──────────┐
│          │          │          │
├──────────┼──────────┼──────────┤
│          │          │          │
└──────────┴──────────┴──────────┘

Die einzelnen Bereiche innerhalb einer Zeile werden anschließend durch <TableCell> beschrieben.

Typische Einsatzgebiete

Mehrere Tabellenzeilen werden beispielsweise verwendet für:

• Briefköpfe
• Anschriften
• Informationsbereiche
• Formulare
• Positionslisten
• Kontoauszüge
• Rechnungen

Best Practices

• Eine Tabellenzeile sollte immer logisch zusammengehörige Informationen enthalten.
• Alle Inhalte ausschließlich innerhalb von <TableCell> platzieren.
• Zeilenhöhen nur dann fest vorgeben, wenn dies für das Layout erforderlich ist.
• Automatische Zeilenhöhen bevorzugen, wenn sich der Inhalt ändern kann.

Developer-Tipp

Planen Sie zunächst die einzelnen Zeilen Ihrer Tabelle.

Erst danach sollte festgelegt werden, wie viele Tabellenzellen jede Zeile benötigt.

XML-Wissen

<TableRow> dient ausschließlich der Strukturierung einer Tabelle.

Sie enthält selbst keine sichtbaren Inhalte.

Erst die darin enthaltenen <TableCell>-Elemente erzeugen die eigentlichen Bereiche, in denen Texte, Variablen oder andere XML-Elemente platziert werden können.

Typische Fehler

Inhalte direkt innerhalb einer Tabellenzeile platzieren

Innerhalb einer <TableRow> dürfen keine Inhalte direkt eingefügt werden.

Der Inhalt befindet sich immer innerhalb einer <TableCell>.

Zu viele feste Höhen verwenden

Werden für sämtliche Tabellenzeilen feste Höhen definiert, kann dies bei unterschiedlich langen Texten zu einem unruhigen oder abgeschnittenen Layout führen.

Feste Höhen sollten daher nur verwendet werden, wenn sie für das gewünschte Dokumentlayout erforderlich sind.

Nächste Schritte

Nachdem die Tabellenzeile bekannt ist, folgt der wichtigste Bestandteil einer Tabelle:

TableCell

Hier werden sämtliche Inhalte einer Tabelle eingefügt und gestaltet.

Empfohlener nächster Artikel: TableCell