En esta página

QTextTableFormat Class

La clase QTextTableFormat proporciona información de formato para tablas en un QTextDocument. Más...

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

Nota: Todas las funciones de esta clase son reentrantes.

Funciones Públicas

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)

Descripción Detallada

Una tabla es un grupo de celdas ordenadas en filas y columnas. Cada tabla contiene al menos una fila y una columna. Cada celda contiene un bloque. Las tablas de los documentos de texto enriquecido se formatean utilizando las propiedades definidas en esta clase.

Las tablas se justifican horizontalmente dentro de su marco padre según la alineación de la tabla. Esto puede leerse con la función alignment() y establecerse con setAlignment().

Las celdas de la tabla están separadas por un espacio entre celdas. El número de píxeles entre celdas se establece con setCellSpacing() y se lee con cellSpacing(). El contenido de cada celda está rodeado por relleno de celda. El número de píxeles entre cada borde de celda y su contenido se establece con setCellPadding() y se lee con cellPadding().

Diagrama que muestra cómo se colocan el espaciado y el relleno alrededor del rectángulo de contenido de la celda.

El color de fondo de la tabla puede leerse con la función background(), y puede especificarse con setBackground(). El color de fondo de cada celda puede establecerse independientemente, y controlará el color de la celda dentro del área rellenada.

El formato de tabla también permite limitar la anchura de las columnas de la tabla. A las columnas se les puede asignar una anchura fija, una anchura variable o un porcentaje de la anchura disponible (véase QTextLength). La función columns() devuelve el número de columnas con restricciones, y la función columnWidthConstraints() devuelve las restricciones definidas para la tabla. Estas cantidades también pueden establecerse llamando a setColumnWidthConstraints() con una lista que contenga nuevas restricciones. Si no se necesitan restricciones, se puede utilizar clearColumnWidthConstraints() para eliminarlas.

Véase también QTextTable, QTextTableCell, y QTextLength.

Documentación de las funciones miembro

QTextTableFormat::QTextTableFormat()

Construye un nuevo objeto de formato de tabla.

Qt::Alignment QTextTableFormat::alignment() const

Devuelve la alineación de la tabla.

Véase también setAlignment().

bool QTextTableFormat::borderCollapse() const

Devuelve true si se deben contraer los bordes de la tabla. El valor por defecto es true.

Véase también setBorderCollapse().

qreal QTextTableFormat::cellPadding() const

Devuelve el relleno de la celda de la tabla. Describe la distancia entre el borde de una celda y su contenido.

Véase también setCellPadding().

qreal QTextTableFormat::cellSpacing() const

Devuelve el espaciado entre celdas de la tabla. Describe la distancia entre celdas adyacentes.

Véase también setCellSpacing().

void QTextTableFormat::clearColumnWidthConstraints()

Borra las restricciones de ancho de columna de la tabla.

Véase también columnWidthConstraints() y setColumnWidthConstraints().

QList<QTextLength> QTextTableFormat::columnWidthConstraints() const

Devuelve una lista de restricciones utilizadas por este formato de tabla para controlar la apariencia de las columnas en una tabla.

Véase también setColumnWidthConstraints().

int QTextTableFormat::columns() const

Devuelve el número de columnas especificado por el formato de la tabla.

int QTextTableFormat::headerRowCount() const

Devuelve el número de filas de la tabla que definen la cabecera.

Véase también setHeaderRowCount().

bool QTextTableFormat::isValid() const

Devuelve true si este formato de tabla es válido; en caso contrario devuelve false.

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

Establece la dirección alignment de la tabla.

Véase también alignment().

void QTextTableFormat::setBorderCollapse(bool borderCollapse)

Por defecto, borderCollapse() es true, lo que tiene las siguientes implicaciones:

  • Los bordes y la rejilla de la tabla se renderizarán siguiendo las reglas de la tabla CSS border-collapse: collapse
  • Si se establece la propiedad border a un valor mínimo de 1, se mostrará una cuadrícula de tabla interior sólida de un píxel utilizando la propiedad borderBrush y un borde exterior según se especifique.
  • Las distintas propiedades de estilo de borde de QTextTableCellFormat pueden utilizarse para personalizar la rejilla y tienen prioridad sobre el borde y la rejilla de la tabla.
  • Se ignorará la propiedad cellSpacing
  • Para la paginación de impresión:
    • Las columnas que continúan en una página no tendrán su borde superior de celda renderizado
    • Las filas de encabezado repetidas siempre tendrán el borde de celda inferior representado.

Con borderCollapse ajustado a false, los bordes de las celdas aún pueden ser estilizados usando QTextTableCellFormat pero el estilizado se aplicará sólo dentro del marco de la celda, lo que probablemente no sea muy útil en la práctica.

Nota: En versiones de Qt anteriores a la 6.8, el valor por defecto era false.

Véase también borderCollapse(), setBorder(), setBorderBrush(), setBorderStyle(), y QTextTableCellFormat.

void QTextTableFormat::setCellPadding(qreal padding)

Establece la celda padding para la tabla. Determina la distancia entre el borde de una celda y su contenido.

Véase también cellPadding().

void QTextTableFormat::setCellSpacing(qreal spacing)

Establece la celda spacing para la tabla. Determina la distancia entre celdas adyacentes.

Esta propiedad será ignorada si borderCollapse está habilitada.

Véase también cellSpacing().

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

Establece el ancho de columna constraints para la tabla.

Véase también columnWidthConstraints() y clearColumnWidthConstraints().

void QTextTableFormat::setHeaderRowCount(int count)

Declara las primeras count filas de la tabla como cabecera de tabla. Las filas de la cabecera de la tabla se repiten cuando una tabla se rompe a través de un límite de página.

Véase también 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.