QTextTableFormat Class
Die Klasse „QTextTableFormat“ stellt Formatierungsinformationen für Tabellen in einer „ QTextDocument “ bereit. Mehr...
| Kopfzeile: | #include <QTextTableFormat> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Gui) target_link_libraries(mytarget PRIVATE Qt6::Gui) |
| qmake: | QT += gui |
| Erbt von: | QTextFrameFormat |
- Liste aller Mitglieder, einschließlich geerbter Mitglieder
- QTextTableFormat ist Teil der Rich-Text-Verarbeitungs-APIs und der implizit gemeinsam genutzten Klassen.
Hinweis: Alle Funktionen 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) |
Ausführliche 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 mithilfe der in dieser Klasse definierten Eigenschaften formatiert.
Tabellen werden innerhalb ihres übergeordneten Rahmens entsprechend der Ausrichtung der Tabelle horizontal ausgerichtet. Dies kann mit der Funktion „ alignment()“ ausgelesen und mit „ setAlignment()“ festgelegt werden.
Zellen innerhalb der Tabelle sind durch einen Zellenabstand voneinander getrennt. Die Anzahl der Pixel zwischen den Zellen wird mit ` setCellSpacing()` festgelegt und mit ` cellSpacing()` ausgelesen. Der Inhalt jeder Zelle ist von einem Zellenabstand umgeben. Die Anzahl der Pixel zwischen dem Rand jeder Zelle und ihrem Inhalt wird mit ` setCellPadding()` festgelegt und mit ` cellPadding()` ausgelesen.

Die Hintergrundfarbe der Tabelle kann mit der Funktion „ background “() ausgelesen und mit „ setBackground “() festgelegt werden. Die Hintergrundfarbe jeder Zelle kann unabhängig festgelegt werden und bestimmt die Farbe der Zelle innerhalb des mit Abstand gefüllten Bereichs.
Das Tabellenformat bietet zudem die Möglichkeit, die Breite der Spalten in der Tabelle festzulegen. Spalten können eine feste Breite, eine variable Breite oder einen Prozentsatz der verfügbaren Breite zugewiesen werden (siehe QTextLength). Die Funktion „ columns “ () gibt die Anzahl der Spalten mit Einschränkungen zurück, und die Funktion „ columnWidthConstraints “ () gibt die für die Tabelle definierten Einschränkungen zurück. Diese Werte können auch durch den Aufruf von „ setColumnWidthConstraints “ () mit einer Liste neuer Einschränkungen festgelegt werden. Sind keine Einschränkungen erforderlich, können diese mit „ clearColumnWidthConstraints “ () entfernt werden.
Siehe auch QTextTable, QTextTableCell und QTextLength.
Dokumentation zu den Member-Funktionen
QTextTableFormat::QTextTableFormat()
Erstellt ein neues Tabellenformatobjekt.
Qt::Alignment QTextTableFormat::alignment() const
Gibt die Ausrichtung der Tabelle zurück.
Siehe auch „ setAlignment()“.
bool QTextTableFormat::borderCollapse() const
Gibt „ true “ zurück, wenn Tabellenränder ausgeblendet werden sollen. Der Standardwert ist „ true “.
Siehe auch setBorderCollapse().
qreal QTextTableFormat::cellPadding() const
Gibt den Zellabstand 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 der Einschränkungen zurück, die von diesem Tabellenformat verwendet werden, um die Darstellung der Spalten in einer Tabelle zu steuern.
Siehe auch „ setColumnWidthConstraints()“.
int QTextTableFormat::columns() const
Gibt die Anzahl der Spalten zurück, die durch das Tabellenformat festgelegt sind.
int QTextTableFormat::headerRowCount() const
Gibt die Anzahl der Zeilen in der Tabelle zurück, die die Kopfzeile bilden.
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)
Legt die „ alignment “ der Tabelle fest.
Siehe auch ` alignment()`.
void QTextTableFormat::setBorderCollapse(bool borderCollapse)
Standardmäßig lautet ` borderCollapse()` ` true`, was folgende Auswirkungen hat:
- Die Rahmen und das Raster der Tabelle werden gemäß den CSS-Regeln für „
border-collapse“ („collapse“) dargestellt - Wird die Eigenschaft `
border` auf den Mindestwert `1` gesetzt, wird ein durchgehendes inneres Tabellenraster mit einer Breite von einem Pixel unter Verwendung der Eigenschaft ` borderBrush ` sowie ein äußerer Rahmen wie angegeben dargestellt - Die verschiedenen Eigenschaften für den Rahmenstil 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 die Seitenaufteilung beim Drucken:
- Bei Spalten, die auf einer Seite fortgesetzt werden, wird der obere Zellrand nicht dargestellt
- Bei wiederholten Kopfzeilen wird der untere Zellrand immer dargestellt
Wenn „ borderCollapse “ auf „ false “ gesetzt ist, können Zellrahmen weiterhin mit „ QTextTableCellFormat “ gestaltet werden, die Formatierung wird jedoch nur innerhalb des Zellrahmens angewendet, was in der Praxis wahrscheinlich nicht sehr nützlich ist.
Hinweis: In Qt-Versionen vor 6.8 war der Standardwert „ false “.
Siehe auch borderCollapse(), setBorder(), setBorderBrush(), setBorderStyle() und QTextTableCellFormat.
void QTextTableFormat::setCellPadding(qreal padding)
Legt den Zellen padding en für die Tabelle fest. Dieser bestimmt den Abstand zwischen dem Rand einer Zelle und ihrem Inhalt.
Siehe auch ` cellPadding()`.
void QTextTableFormat::setCellSpacing(qreal spacing)
Legt die Zellen spacing e für die Tabelle fest. Diese bestimmt den Abstand zwischen benachbarten Zellen.
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)
Legt die ersten count Zeilen der Tabelle als Tabellenkopf fest. Die Tabellenkopfzeilen werden wiederholt, wenn eine Tabelle über eine Seitengrenze hinweg aufgeteilt wird.
Siehe auch headerRowCount().
© 2026 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.