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: |
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:
- Una implementación de insertRows() debe llamar a beginInsertRows() antes de insertar nuevas filas en la estructura de datos, y debe llamar a endInsertRows() inmediatamente después.
- Una implementación de ` insertColumns()` debe llamar a ` beginInsertColumns()` antes de insertar nuevas columnas en la estructura de datos, y debe llamar a ` endInsertColumns()` inmediatamente después.
- Una implementación de ` removeRows()` debe llamar a ` beginRemoveRows() ` antes de que las filas se eliminen de la estructura de datos, y debe llamar a ` endRemoveRows()` inmediatamente después.
- Una implementación de ` removeColumns()` debe llamar a ` beginRemoveColumns()` antes de que las columnas se eliminen de la estructura de datos, y debe llamar a ` endRemoveColumns()` inmediatamente después.
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.