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 |
- Lista de todos los miembros, incluyendo los heredados
- QTextTableFormat es parte de APIs de Procesamiento de Texto Enriquecido y Clases Implícitamente Compartidas.
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().

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
bordera un valor mínimo de1, 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.