Back to Qt.io
Contact Us Blog Download Qt

QTextTableFormat Class

Die Klasse QTextTableFormat liefert Formatierungsinformationen für Tabellen in einem QTextDocument. Mehr...

Kopfzeile: #include <QTextTableFormat>
CMake: find_package(Qt6 REQUIRED COMPONENTS Gui)
target_link_libraries(mytarget PRIVATE Qt6::Gui)
qmake: QT += gui
Vererbungen: QTextFrameFormat

Hinweis: Alle Funktionen in dieser Klasse sind reentrant.

Öffentliche Funktionen

QTextTableFormat()
Qt::Alignment alignment() const
bool borderCollapse() const
qreal cellPadding() const
qreal cellSpacing() const
void clearColumnWidthConstraints()
QList<QTextLength> columnWidthConstraints() const
int columns() const
int headerRowCount() const
bool isValid() const
void setAlignment(Qt::Alignment alignment)
void setBorderCollapse(bool borderCollapse)
void setCellPadding(qreal padding)
void setCellSpacing(qreal spacing)
void setColumnWidthConstraints(const QList<QTextLength> &constraints)
void setHeaderRowCount(int count)

Detaillierte Beschreibung

Eine Tabelle ist eine Gruppe von Zellen, die in Zeilen und Spalten angeordnet sind. Jede Tabelle enthält mindestens eine Zeile und eine Spalte. Jede Zelle enthält einen Block. Tabellen in Rich-Text-Dokumenten werden mit Hilfe der in dieser Klasse definierten Eigenschaften formatiert.

Tabellen werden innerhalb ihres übergeordneten Rahmens entsprechend der Ausrichtung der Tabelle horizontal ausgerichtet. Diese kann mit der Funktion alignment() ausgelesen und mit setAlignment() eingestellt werden.

Die Zellen innerhalb der Tabelle werden durch Zellabstände getrennt. Die Anzahl der Pixel zwischen den Zellen wird mit setCellSpacing() eingestellt und mit cellSpacing() ausgelesen. Der Inhalt jeder Zelle ist von einem Zellpolster umgeben. Die Anzahl der Pixel zwischen jedem Zellenrand und seinem Inhalt wird mit setCellPadding() eingestellt und mit cellPadding() ausgelesen.

Die Hintergrundfarbe der Tabelle wird mit der Funktion background() ausgelesen und kann mit setBackground() festgelegt werden. Die Hintergrundfarbe jeder Zelle kann unabhängig eingestellt werden und steuert die Farbe der Zelle innerhalb des aufgefüllten Bereichs.

Das Tabellenformat bietet auch eine Möglichkeit, die Breite der Spalten in der Tabelle einzuschränken. Den Spalten kann eine feste Breite, eine variable Breite oder ein Prozentsatz der verfügbaren Breite zugewiesen werden (siehe QTextLength). Die Funktion columns() gibt die Anzahl der Spalten mit Beschränkungen zurück, und die Funktion columnWidthConstraints() gibt die für die Tabelle definierten Beschränkungen zurück. Diese Größen können auch durch den Aufruf von setColumnWidthConstraints() mit einer Liste, die neue Beschränkungen enthält, festgelegt werden. Wenn keine Beschränkungen benötigt werden, können sie mit clearColumnWidthConstraints() entfernt werden.

Siehe auch QTextTable, QTextTableCell, und QTextLength.

Dokumentation der Mitgliedsfunktionen

QTextTableFormat::QTextTableFormat()

Konstruiert ein neues Tabellenformat-Objekt.

Qt::Alignment QTextTableFormat::alignment() const

Gibt die Ausrichtung der Tabelle zurück.

Siehe auch setAlignment().

bool QTextTableFormat::borderCollapse() const

Gibt true zurück, wenn borderCollapse aktiviert ist.

Siehe auch setBorderCollapse().

qreal QTextTableFormat::cellPadding() const

Gibt den Zellenabstand der Tabelle zurück. Dieser beschreibt den Abstand zwischen dem Rand einer Zelle und ihrem Inhalt.

Siehe auch setCellPadding().

qreal QTextTableFormat::cellSpacing() const

Gibt den Zellenabstand der Tabelle zurück. Dieser beschreibt den Abstand zwischen benachbarten Zellen.

Siehe auch setCellSpacing().

void QTextTableFormat::clearColumnWidthConstraints()

Löscht die Spaltenbreitenbeschränkungen für die Tabelle.

Siehe auch columnWidthConstraints() und setColumnWidthConstraints().

QList<QTextLength> QTextTableFormat::columnWidthConstraints() const

Gibt eine Liste von Einschränkungen zurück, die von diesem Tabellenformat verwendet werden, um das Aussehen von Spalten in einer Tabelle zu steuern.

Siehe auch setColumnWidthConstraints().

int QTextTableFormat::columns() const

Gibt die Anzahl der durch das Tabellenformat angegebenen Spalten zurück.

int QTextTableFormat::headerRowCount() const

Gibt die Anzahl der Zeilen in der Tabelle zurück, die die Überschrift definieren.

Siehe auch setHeaderRowCount().

bool QTextTableFormat::isValid() const

Gibt true zurück, wenn dieses Tabellenformat gültig ist; andernfalls wird false zurückgegeben.

void QTextTableFormat::setAlignment(Qt::Alignment alignment)

Setzt die Tabelle alignment.

Siehe auch alignment().

void QTextTableFormat::setBorderCollapse(bool borderCollapse)

Die Aktivierung von borderCollapse hat die folgenden Auswirkungen:

  • Die Ränder und das Raster der Tabelle werden nach den Regeln der CSS-Tabelle border-collapse: collapse gerendert.
  • Wenn Sie die Eigenschaft border auf einen Mindestwert von 1 setzen, wird ein einpixeliges inneres Tabellengitter unter Verwendung der Eigenschaft borderBrush und ein äußerer Rahmen wie angegeben gerendert.
  • Die verschiedenen Randstileigenschaften von QTextTableCellFormat können zur Anpassung des Rasters verwendet werden und haben Vorrang vor dem Rahmen und dem Raster der Tabelle.
  • Die Eigenschaft cellSpacing wird ignoriert.
  • Für den Seitenumbruch im Druck:
    • Bei Spalten, die auf einer Seite fortgesetzt werden, wird der obere Zellrand nicht gerendert.
    • Bei wiederholten Kopfzeilen wird der untere Zellenrand immer dargestellt.

Wenn borderCollapse deaktiviert ist, können die Zellränder immer noch mit QTextTableCellFormat gestaltet werden, aber die Gestaltung wird nur innerhalb des Zellrahmens angewendet, was in der Praxis wahrscheinlich nicht sehr nützlich ist.

Siehe auch borderCollapse(), setBorder(), setBorderBrush(), setBorderStyle(), und QTextTableCellFormat.

void QTextTableFormat::setCellPadding(qreal padding)

Legt die Zelle padding für die Tabelle fest. Damit wird der Abstand zwischen dem Rand einer Zelle und ihrem Inhalt festgelegt.

Siehe auch cellPadding().

void QTextTableFormat::setCellSpacing(qreal spacing)

Legt die Zelle spacing für die Tabelle fest. Damit wird der Abstand zwischen benachbarten Zellen festgelegt.

Diese Eigenschaft wird ignoriert, wenn borderCollapse aktiviert ist.

Siehe auch cellSpacing().

void QTextTableFormat::setColumnWidthConstraints(const QList<QTextLength> &constraints)

Legt die Spaltenbreite constraints für die Tabelle fest.

Siehe auch columnWidthConstraints() und clearColumnWidthConstraints().

void QTextTableFormat::setHeaderRowCount(int count)

Deklariert die ersten count Zeilen der Tabelle als Tabellenkopf. Die Tabellenkopfzeilen werden wiederholt, wenn eine Tabelle über eine Seitengrenze umbrochen wird.

Siehe auch headerRowCount().

© 2025 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.