QTextTableCell Class

La clase QTextTableCell representa las propiedades de una celda en un QTextTable. Más...

Cabecera:	`#include <QTextTableCell>`
CMake:	`find_package(Qt6 REQUIRED COMPONENTS Gui)` `target_link_libraries(mytarget PRIVATE Qt6::Gui)`
qmake:	`QT += gui`

Lista de todos los miembros, incluidos los heredados
QTextTableCell es parte de las APIs de Procesamiento de Texto Enriquecido.

Nota: Todas las funciones de esta clase son reentrantes.

Funciones Públicas

	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

Descripción Detallada

Las celdas de una tabla son piezas de la estructura del documento que pertenecen a una tabla. La tabla ordena las celdas en filas y columnas determinadas; las celdas también pueden abarcar varias columnas y filas.

Las celdas se crean normalmente cuando se inserta una tabla en un documento con QTextCursor::insertTable(), pero también se crean y destruyen cuando se redimensiona una tabla.

Las celdas contienen información sobre su ubicación en una tabla; puede obtener los números row() y column() de una celda, y sus rowSpan() y columnSpan().

El format() de una celda describe el formato de caracteres por defecto de su contenido. Las funciones firstCursorPosition() y lastCursorPosition() se utilizan para obtener la extensión de la celda en el documento.

Véase también QTextTable y QTextTableFormat.

Documentación de las funciones miembro

QTextTableCell::QTextTableCell()

Construye una celda de tabla inválida.

Véase también isValid().

QTextTableCell::QTextTableCell(const QTextTableCell &other)

Constructor de copia. Crea un nuevo objeto QTextTableCell basado en la celda other.

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

Destruye la celda de la tabla.

QTextFrame::iterator QTextTableCell::begin() const

Devuelve un iterador de marco que apunta al principio de la celda de la tabla.

Véase también end().

int QTextTableCell::column() const

Devuelve el número de la columna de la tabla que contiene esta celda.

Véase también row().

int QTextTableCell::columnSpan() const

Devuelve el número de columnas que abarca esta celda. El valor por defecto es 1.

Véase también rowSpan().

QTextFrame::iterator QTextTableCell::end() const

Devuelve un iterador de marco que apunta al final de la celda de la tabla.

Véase también begin().

QTextCursor QTextTableCell::firstCursorPosition() const

Devuelve la primera posición válida del cursor en esta celda.

Véase también lastCursorPosition().

QTextCharFormat QTextTableCell::format() const

Devuelve el formato de caracteres de la celda.

Véase también setFormat().

bool QTextTableCell::isValid() const

Devuelve true si se trata de una celda de tabla válida; en caso contrario devuelve false.

QTextCursor QTextTableCell::lastCursorPosition() const

Devuelve la última posición válida del cursor en esta celda.

Véase también firstCursorPosition().

int QTextTableCell::row() const

Devuelve el número de la fila de la tabla que contiene esta celda.

Véase también column().

int QTextTableCell::rowSpan() const

Devuelve el número de filas que abarca esta celda. Por defecto es 1.

Véase también columnSpan().

void QTextTableCell::setFormat(const QTextCharFormat &format)

Establece el formato de caracteres de la celda en format. Esto puede utilizarse, por ejemplo, para cambiar el color de fondo de toda la celda:

QTextTableCell cell = table->cellAt(2, 3);
QTextCharFormat format = cell.format();
format.setBackground(Qt::blue);
cell.setFormat(format);

Tenga en cuenta que el espacio entre filas o columnas de la celda no puede cambiarse mediante esta función. Debe utilizar QTextTable::mergeCells y QTextTable::splitCell en su lugar.

Véase también format().

int QTextTableCell::tableCellFormatIndex() const

Devuelve el índice del formato de la tableCell en la lista interna de formatos del documento.

Véase también QTextDocument::allFormats().

bool QTextTableCell::operator!=(const QTextTableCell &other) const

Devuelve true si este objeto de celda y el objeto de celda other describen celdas diferentes; en caso contrario devuelve false.

QTextTableCell &QTextTableCell::operator=(const QTextTableCell &other)

Asigna la celda de la tabla other a esta celda de la tabla.

bool QTextTableCell::operator==(const QTextTableCell &other) const

Devuelve true si este objeto de celda y el objeto de celda other describen la misma celda; en caso contrario devuelve false.

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