QTextTableFormat Class
La clase QTextTableFormat proporciona información de formato para las tablas de un documento « QTextDocument ». Más información...
| Encabezado: | #include <QTextTableFormat> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Gui) target_link_libraries(mytarget PRIVATE Qt6::Gui) |
| qmake: | QT += gui |
| Heredan: | QTextFrameFormat |
- Lista de todos los miembros, incluidos los heredados
- QTextTableFormat forma parte de las API de procesamiento de texto enriquecido y de las clases compartidas implícitamente.
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 principal según la alineación de la tabla. Esto se puede leer con la función ` alignment()` y establecer con ` setAlignment()`.
Las celdas de la tabla están separadas por el espaciado 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 el relleno de celda. El número de píxeles entre el borde de cada celda y su contenido se establece con setCellPadding() y se lee con cellPadding().

El color de fondo de la tabla se puede leer con la función background() y se puede especificar con setBackground(). El color de fondo de cada celda se puede establecer de forma independiente y determinará el color de la celda dentro del área con margen.
El formato de tabla también ofrece la posibilidad de restringir el ancho de las columnas. A las columnas se les puede asignar un ancho fijo, un ancho variable o un porcentaje del ancho 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 se pueden establecer llamando a setColumnWidthConstraints() con una lista que contenga nuevas restricciones. Si no se requieren restricciones, se puede utilizar clearColumnWidthConstraints() para eliminarlas.
Véase también QTextTable, QTextTableCell y QTextLength.
Documentación de las funciones de miembro
QTextTableFormat::QTextTableFormat()
Crea 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 ocultar los bordes de la tabla. El valor por defecto es « true ».
Véase también setBorderCollapse().
qreal QTextTableFormat::cellPadding() const
Devuelve el relleno de las celdas de la tabla. Esto 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. Esto describe la distancia entre celdas adyacentes.
Véase también setCellSpacing().
void QTextTableFormat::clearColumnWidthConstraints()
Elimina 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 que utiliza este formato de tabla para controlar el aspecto 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 el encabezado.
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 el valor de « 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 cuadrícula de la tabla se representarán siguiendo las reglas CSS de «
border-collapse:collapse» para tablas - Si se establece la propiedad
borderen su valor mínimo (1), se renderizará una cuadrícula interior sólida de un píxel utilizando la propiedad borderBrush y un borde exterior tal y como se haya especificado - Las distintas propiedades de estilo de borde de « QTextTableCellFormat » pueden utilizarse para personalizar la cuadrícula y tienen prioridad sobre el borde y la cuadrícula de la tabla
- La propiedad cellSpacing se ignorará
- Para la paginación de impresión:
- Las columnas que continúen en otra página no mostrarán el borde superior de sus celdas
- Las filas de encabezado repetidas siempre mostrarán el borde inferior de las celdas
Con « borderCollapse » establecido en « false », los bordes de las celdas se pueden seguir personalizando mediante « QTextTableCellFormat », pero el estilo solo se aplicará dentro del marco de la celda, lo que probablemente no resulte muy útil en la práctica.
Nota: En las 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 el « padding » de las celdas de la tabla. Esto determina la distancia entre el borde de una celda y su contenido.
Véase también cellPadding().
void QTextTableFormat::setCellSpacing(qreal spacing)
Establece la propiedad « spacing » de la tabla. Esto determina la distancia entre celdas adyacentes.
Esta propiedad se ignorará si está activada la opción « borderCollapse ».
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 encabezado de la tabla. Las filas del encabezado de la tabla se repiten cuando una tabla se divide entre dos páginas.
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.