En esta página

QAbstractTableModel Class

La clase `QAbstractTableModel` proporciona un modelo abstracto del que se pueden crear subclases para desarrollar modelos de tabla. Más información...

Encabezado: #include <QAbstractTableModel>
CMake: find_package(Qt6 REQUIRED COMPONENTS Core)
target_link_libraries(mytarget PRIVATE Qt6::Core)
qmake: QT += core
Heredado de: QAbstractItemModel
Heredado por:

QSqlQueryModel

Funciones públicas

QAbstractTableModel(QObject *parent = nullptr)
virtual ~QAbstractTableModel()

Funciones públicas reimplementadas

virtual bool dropMimeData(const QMimeData *data, Qt::DropAction action, int row, int column, const QModelIndex &parent) override
virtual Qt::ItemFlags flags(const QModelIndex &index) const override
virtual QModelIndex index(int row, int column, const QModelIndex &parent = QModelIndex()) const override
virtual QModelIndex sibling(int row, int column, const QModelIndex &idx) const override

Descripción detallada

QAbstractTableModel proporciona una interfaz estándar para modelos que representan sus datos como una matriz bidimensional de elementos. No se utiliza directamente, sino que debe subclasificarse.

Dado que el modelo proporciona una interfaz más especializada que ` QAbstractItemModel`, no es adecuado para su uso con vistas de árbol, aunque sí puede utilizarse para proporcionar datos a un ` QListView`. Si necesitas representar una lista sencilla de elementos y solo necesitas un modelo que contenga una única columna de datos, puede ser más adecuado crear una subclase de ` QAbstractListModel `.

Las funciones « rowCount()» y « columnCount()» devuelven las dimensiones de la tabla. Para recuperar un índice del modelo correspondiente a un elemento del mismo, utilice « index()» y especifique únicamente los números de fila y columna.

Subclasificación

Al crear una subclase de `QAbstractTableModel`, debes implementar ` rowCount()`, ` columnCount()` y ` data()`. `QAbstractTableModel` proporciona implementaciones predeterminadas de las funciones ` index()` y ` parent()`. Los modelos que funcionen correctamente también implementarán ` headerData()`.

Los modelos editables deben implementar setData() e implementar flags() para devolver un valor que contenga Qt::ItemIsEditable.

Los modelos que proporcionan interfaces a estructuras de datos redimensionables pueden ofrecer implementaciones de insertRows(), removeRows(), insertColumns() y removeColumns(). Al implementar estas funciones, es importante llamar a las funciones adecuadas para que todas las vistas conectadas detecten cualquier cambio:

Nota: En la Referencia sobre subclasificación de modelos se pueden consultaralgunas directrices generales para la subclasificación de modelos.

Seguridad entre subprocesos

Al ser una subclase de `QObject`, `QAbstractTableModel` no es ` thread-safe`. Cualquier API relacionada con el modelo `QAbstractTableModel` solo debe llamarse desde el hilo en el que reside el objeto modelo. Si `QAbstractTableModel` está conectado a una vista, opera en el hilo de la interfaz gráfica de usuario, ya que la vista reside allí e interactúa con el modelo desde ese hilo. Aunque se puede utilizar un hilo en segundo plano para rellenar o modificar el contenido del modelo, hay que hacerlo con cuidado, ya que no puede llamar directamente a ninguna API relacionada con el modelo. En su lugar, debes poner en cola las actualizaciones y aplicarlas en el hilo principal. Esto se puede hacer mediante conexiones en cola.

Véase también Clases de modelo, QAbstractItemModel, QAbstractListModel y QRangeModel.

Documentación de las funciones miembro

[explicit] QAbstractTableModel::QAbstractTableModel(QObject *parent = nullptr)

Crea un modelo de tabla abstracto para la tabla parent.

[virtual noexcept] QAbstractTableModel::~QAbstractTableModel()

Elimina el modelo de tabla abstracto.

[override virtual] bool QAbstractTableModel::dropMimeData(const QMimeData *data, Qt::DropAction action, int row, int column, const QModelIndex &parent)

Reimplementa: QAbstractItemModel::dropMimeData(const QMimeData *data, Qt::DropAction action, int row, int column, const QModelIndex &parent).

[override virtual] Qt::ItemFlags QAbstractTableModel::flags(const QModelIndex &index) const

Reimplementa: ` QAbstractItemModel::flags(const QModelIndex &index) const`.

[override virtual] QModelIndex QAbstractTableModel::index(int row, int column, const QModelIndex &parent = QModelIndex()) const

Reimplementa: QAbstractItemModel::index(int fila, int columna, const QModelIndex &padre) const.

Devuelve el índice de los datos en row y column con parent.

Véase también parent().

[override virtual] QModelIndex QAbstractTableModel::sibling(int row, int column, const QModelIndex &idx) const

Reimplementa: QAbstractItemModel::sibling(int fila, int columna, const QModelIndex &índice) const.

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