QTextTableCell Class

Die Klasse QTextTableCell repräsentiert die Eigenschaften einer Zelle in einer QTextTable. Mehr...

Kopfzeile:	`#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 Processing APIs.

Hinweis: Alle Funktionen in 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

Detaillierte Beschreibung

Tabellenzellen sind Teile der Dokumentstruktur, die zu einer Tabelle gehören. Die Tabelle ordnet Zellen in bestimmte Zeilen und Spalten ein; Zellen können sich auch über mehrere Spalten und Zeilen erstrecken.

Zellen werden normalerweise erstellt, wenn eine Tabelle mit QTextCursor::insertTable() in ein Dokument eingefügt wird, aber sie werden auch erstellt und zerstört, 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 ihre rowSpan() und columnSpan() erhalten.

Die format() einer Zelle beschreibt das Standardzeichenformat ihres Inhalts. Die Funktionen firstCursorPosition() und lastCursorPosition() werden verwendet, um den Umfang der Zelle im Dokument zu ermitteln.

Siehe auch QTextTable und QTextTableFormat.

Dokumentation der Mitgliedsfunktionen

QTextTableCell::QTextTableCell()

Konstruiert eine ungültige Tabellenzelle.

Siehe auch isValid().

QTextTableCell::QTextTableCell(const QTextTableCell &other)

Konstruktor kopieren. Erzeugt ein neues QTextTableCell-Objekt auf Basis der Zelle other.

`[noexcept]` QTextTableCell::~QTextTableCell()

Zerstört 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. Die Vorgabe 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 dies eine gültige Tabellenzelle ist; 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. Die Vorgabe ist 1.

Siehe auch columnSpan().

void QTextTableCell::setFormat(const QTextCharFormat &format)

Setzt das Zeichenformat der Zelle auf format. Dies kann z.B. 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 der Zeilen- oder Spaltenabstand der Zelle mit dieser Funktion nicht geändert werden kann. Sie müssen stattdessen QTextTable::mergeCells und QTextTable::splitCell verwenden.

Siehe auch format().

int QTextTableCell::tableCellFormatIndex() const

Gibt den Index des Formats von 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 die Tabellenzelle other dieser Tabellenzelle 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.

© 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.