QTextTableCell Class
Die Klasse „QTextTableCell“ repräsentiert die Eigenschaften einer Zelle in einem „ QTextTable “. Mehr...
| Header: | #include <QTextTableCell> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Gui) target_link_libraries(mytarget PRIVATE Qt6::Gui) |
| qmake: | QT += gui |
- Liste aller Mitglieder, einschließlich geerbter Mitglieder
- QTextTableCell ist Teil der Rich-Text-Verarbeitungs-APIs.
Hinweis: Alle Funktionen dieser Klasse sind reentrant.
Öffentliche Funktionen
| QTextTableCell() | |
| QTextTableCell(const QTextTableCell &other) | |
| ~QTextTableCell() | |
| QTextFrame::iterator | begin() const |
| int | column() const |
| int | columnSpan() const |
| QTextFrame::iterator | end() const |
| QTextCursor | firstCursorPosition() const |
| QTextCharFormat | format() const |
| bool | isValid() const |
| QTextCursor | lastCursorPosition() const |
| int | row() const |
| int | rowSpan() const |
| void | setFormat(const QTextCharFormat &format) |
| int | tableCellFormatIndex() const |
| bool | operator!=(const QTextTableCell &other) const |
| QTextTableCell & | operator=(const QTextTableCell &other) |
| bool | operator==(const QTextTableCell &other) const |
Ausführliche Beschreibung
Tabellenzellen sind Bestandteile der Dokumentstruktur, die zu einer Tabelle gehören. Die Tabelle ordnet die Zellen in bestimmte Zeilen und Spalten an; Zellen können sich auch über mehrere Spalten und Zeilen erstrecken.
Zellen werden in der Regel erstellt, wenn eine Tabelle mit ` QTextCursor::insertTable()` in ein Dokument eingefügt wird; sie werden jedoch auch erstellt und gelöscht, wenn die Größe einer Tabelle geändert wird.
Zellen enthalten Informationen über ihre Position in einer Tabelle; Sie können die Nummern „ row()“ und „ column()“ einer Zelle sowie deren „ rowSpan()“- und „ columnSpan()“-Werte abrufen.
Die Funktion ` format()` einer Zelle beschreibt das Standardzeichenformat ihres Inhalts. Die Funktionen ` firstCursorPosition()` und ` lastCursorPosition()` dienen dazu, die Ausdehnung der Zelle im Dokument zu ermitteln.
Siehe auch „ QTextTable “ und „ QTextTableFormat “.
Dokumentation zu den Member-Funktionen
QTextTableCell::QTextTableCell()
Erstellt eine ungültige Tabellenzelle.
Siehe auch isValid().
QTextTableCell::QTextTableCell(const QTextTableCell &other)
Kopierkonstruktor. Erstellt ein neues `QTextTableCell`-Objekt auf der Grundlage der Zelle ` other `.
[noexcept] QTextTableCell::~QTextTableCell()
Löscht die Tabellenzelle.
QTextFrame::iterator QTextTableCell::begin() const
Gibt einen Frame-Iterator zurück, der auf den Anfang der Zelle der Tabelle zeigt.
Siehe auch ` end()`.
int QTextTableCell::column() const
Gibt die Nummer der Spalte in der Tabelle zurück, die diese Zelle enthält.
Siehe auch „ row()“.
int QTextTableCell::columnSpan() const
Gibt die Anzahl der Spalten zurück, über die sich diese Zelle erstreckt. Der Standardwert ist 1.
Siehe auch „ rowSpan()“.
QTextFrame::iterator QTextTableCell::end() const
Gibt einen Frame-Iterator zurück, der auf das Ende der Zelle der Tabelle zeigt.
Siehe auch ` begin()`.
QTextCursor QTextTableCell::firstCursorPosition() const
Gibt die erste gültige Cursorposition in dieser Zelle zurück.
Siehe auch „ lastCursorPosition()“.
QTextCharFormat QTextTableCell::format() const
Gibt das Zeichenformat der Zelle zurück.
Siehe auch „ setFormat()“.
bool QTextTableCell::isValid() const
Gibt „ true “ zurück, wenn es sich um eine gültige Tabellenzelle handelt; andernfalls wird „false“ zurückgegeben.
QTextCursor QTextTableCell::lastCursorPosition() const
Gibt die letzte gültige Cursorposition in dieser Zelle zurück.
Siehe auch „ firstCursorPosition()“.
int QTextTableCell::row() const
Gibt die Nummer der Zeile in der Tabelle zurück, die diese Zelle enthält.
Siehe auch „ column()“.
int QTextTableCell::rowSpan() const
Gibt die Anzahl der Zeilen zurück, über die sich diese Zelle erstreckt. Der Standardwert ist 1.
Siehe auch „ columnSpan()“.
void QTextTableCell::setFormat(const QTextCharFormat &format)
Legt das Zeichenformat der Zelle auf „ format “ fest. Dies kann beispielsweise verwendet werden, um die Hintergrundfarbe der gesamten Zelle zu ändern:
QTextTableCell cell = table->cellAt(2, 3);
QTextCharFormat format = cell.format();
format.setBackground(Qt::blue);
cell.setFormat(format);Beachten Sie, dass die Zeilen- oder Spaltenausdehnung der Zelle mit dieser Funktion nicht geändert werden kann. Verwenden Sie stattdessen „ QTextTable::mergeCells “ und „ QTextTable::splitCell “.
Siehe auch „ format()“.
int QTextTableCell::tableCellFormatIndex() const
Gibt den Index des Formats der tableCell in der internen Formatliste des Dokuments zurück.
Siehe auch „ QTextDocument::allFormats()“.
bool QTextTableCell::operator!=(const QTextTableCell &other) const
Gibt „ true “ zurück, wenn dieses Zellenobjekt und das Zellenobjekt „ other “ unterschiedliche Zellen beschreiben; andernfalls wird „ false “ zurückgegeben.
QTextTableCell &QTextTableCell::operator=(const QTextTableCell &other)
Weist dieser Tabellenzelle die Tabellenzelle „ other “ zu.
bool QTextTableCell::operator==(const QTextTableCell &other) const
Gibt „ true “ zurück, wenn dieses Zellenobjekt und das Zellenobjekt „ other “ dieselbe Zelle beschreiben; andernfalls wird „ false “ zurückgegeben.
© 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.
