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 |
- Lista de todos los miembros, incluidos los heredados
- QTextTable forma parte de las API de procesamiento de texto enriquecido.
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.
![]() | Supongamos 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. |
![]() | Esto 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. |
![]() | El 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.

