En esta página

QTextTable Class

La clase QTextTable representa una tabla en un documento de « QTextDocument ». Más información...

Encabezado: #include <QTextTable>
CMake: find_package(Qt6 REQUIRED COMPONENTS Gui)
target_link_libraries(mytarget PRIVATE Qt6::Gui)
qmake: QT += gui
Heredado de: QTextFrame

Nota: Todas las funciones de esta clase son reentrantes.

Funciones públicas

void appendColumns(int count)
void appendRows(int count)
QTextTableCell cellAt(int row, int column) const
QTextTableCell cellAt(const QTextCursor &cursor) const
QTextTableCell cellAt(int position) const
int columns() const
QTextTableFormat format() const
void insertColumns(int index, int columns)
void insertRows(int index, int rows)
void mergeCells(int row, int column, int numRows, int numCols)
void mergeCells(const QTextCursor &cursor)
void removeColumns(int index, int columns)
void removeRows(int index, int rows)
void resize(int rows, int columns)
QTextCursor rowEnd(const QTextCursor &cursor) const
QTextCursor rowStart(const QTextCursor &cursor) const
int rows() const
void setFormat(const QTextTableFormat &format)
void splitCell(int row, int column, int numRows, int numCols)

Descripción detallada

Una tabla es un conjunto de celdas ordenadas en filas y columnas. Cada tabla contiene al menos una fila y una columna. Cada celda contiene un bloque y está rodeada por un marco.

Las tablas suelen crearse e insertarse en un documento mediante la función ` QTextCursor::insertTable()`. Por ejemplo, podemos insertar una tabla con tres filas y dos columnas en la posición actual del cursor en un editor utilizando las siguientes líneas de código:

    QTextCursor cursor(editor->textCursor());
    cursor.movePosition(QTextCursor::Start);

    QTextTable *table = cursor.insertTable(rows, columns, tableFormat);

El formato de la tabla se define al crearla o se modifica posteriormente con setFormat().

La tabla que el cursor está editando en ese momento se localiza con QTextCursor::currentTable(). Esto permite modificar su formato o sus dimensiones después de haberla insertado en un documento.

El tamaño de una tabla se puede modificar con ` resize()`, o bien utilizando ` insertRows()`, ` insertColumns()`, ` removeRows()` o ` removeColumns()`. Utiliza ` cellAt()` para recuperar las celdas de la tabla.

Las posiciones inicial y final de las filas de la tabla se pueden determinar moviendo el cursor dentro de la tabla y utilizando las funciones rowStart() y rowEnd() para obtener los cursores al inicio y al final de cada fila.

Las filas y columnas de una QTextTable se pueden fusionar y dividir utilizando las funciones mergeCells() y splitCell(). Sin embargo, solo se pueden dividir las celdas que abarcan varias filas o columnas. (La fusión o división no aumenta ni disminuye el número de filas y columnas).

Ten en cuenta que, si has fusionado varias columnas y filas en una sola celda, no podrás dividir la celda fusionada en nuevas celdas que abarquen más de una fila o columna. Para poder dividir celdas que abarquen varias filas y columnas, debes realizar esta operación en varias iteraciones.

Tabla con celdas de encabezado independientesSupongamos que tenemos una tabla de 2x3 con nombres y direcciones. Para fusionar ambas columnas de la primera fila, invocamos mergeCells() con row = 0, column = 0, numRows = 1 y numColumns = 2.
    table->mergeCells(0, 0, 1, 2);
Tabla con celda de encabezado fusionadaEsto nos da la siguiente tabla. Para volver a dividir la primera fila de la tabla en dos celdas, llamamos a la función splitCell() con numRows y numCols = 1.
    table->splitCell(0, 0, 1, 1);
Tabla con celdas de encabezado independientesEl resultado es la tabla original.

Véase también QTextTableFormat.

Documentación de funciones de miembro

void QTextTable::appendColumns(int count)

Añade las columnas « count » a la derecha de la tabla.

Véase también insertColumns(), insertRows(), resize(), removeRows(), removeColumns() y appendRows().

void QTextTable::appendRows(int count)

Añade count filas al final de la tabla.

Véase también insertColumns(), insertRows(), resize(), removeRows(), removeColumns() y appendColumns().

QTextTableCell QTextTable::cellAt(int row, int column) const

Devuelve la celda de la tabla situada en las coordenadas row y column.

Véase también columns() y rows().

QTextTableCell QTextTable::cellAt(const QTextCursor &cursor) const

Devuelve la celda de la tabla que contiene el valor dado cursor.

Se trata de una función sobrecargada.

QTextTableCell QTextTable::cellAt(int position) const

Devuelve la celda de la tabla que contiene el carácter situado en la posición position indicada en el documento.

Se trata de una función sobrecargada.

int QTextTable::columns() const

Devuelve el número de columnas de la tabla.

Véase también rows().

QTextTableFormat QTextTable::format() const

Devuelve el formato de la tabla.

Véase también setFormat().

void QTextTable::insertColumns(int index, int columns)

Inserta un número de elementos columns antes de la columna con el index especificado.

Véanse también insertRows(), resize(), removeRows(), removeColumns(), appendRows() y appendColumns().

void QTextTable::insertRows(int index, int rows)

Inserta un número de « rows » antes de la fila con el « index » especificado.

Véase también resize(), insertColumns(), removeRows(), removeColumns(), appendRows() y appendColumns().

void QTextTable::mergeCells(int row, int column, int numRows, int numCols)

Fusiona la celda situada en la posición especificada row y column con las celdas adyacentes en una sola celda. La nueva celda abarcará numRows filas y numCols columnas. Este método no realiza ninguna acción si numRows o numCols es menor que el número actual de filas o columnas que abarca la celda.

Véase también splitCell().

void QTextTable::mergeCells(const QTextCursor &cursor)

Combina las celdas seleccionadas mediante la función « cursor » proporcionada.

Esta es una función sobrecargada.

Véase también splitCell().

void QTextTable::removeColumns(int index, int columns)

Elimina una serie de « columns » a partir de la columna indicada en « index ».

Véanse también insertRows(), insertColumns(), removeRows(), resize(), appendRows() y appendColumns().

void QTextTable::removeRows(int index, int rows)

Elimina una serie de elementos « rows » a partir de la fila indicada en index.

Véanse también insertRows(), insertColumns(), resize(), removeColumns(), appendRows() y appendColumns().

void QTextTable::resize(int rows, int columns)

Ajusta el tamaño de la tabla para que contenga el número necesario de rows y columns.

Véanse también insertRows(), insertColumns(), removeRows() y removeColumns().

QTextCursor QTextTable::rowEnd(const QTextCursor &cursor) const

Devuelve un cursor que apunta al final de la fila que contiene el ` cursor` indicado.

Véase también rowStart().

QTextCursor QTextTable::rowStart(const QTextCursor &cursor) const

Devuelve un cursor que apunta al inicio de la fila que contiene el cursor dado.

Véase también rowEnd().

int QTextTable::rows() const

Devuelve el número de filas de la tabla.

Véase también columns().

void QTextTable::setFormat(const QTextTableFormat &format)

Establece el valor de « format » de la tabla.

Véase también format().

void QTextTable::splitCell(int row, int column, int numRows, int numCols)

Divide la celda especificada en row y column en una matriz de varias celdas con las dimensiones especificadas en numRows y numCols.

Nota: Soloes posible dividir celdas que abarquen varias filas o columnas, como las filas que se han fusionado mediante mergeCells().

Véase también mergeCells().

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