En esta página

QAbstractListModel Class

La clase QAbstractListModel proporciona un modelo abstracto del que se pueden crear subclases para generar modelos de lista unidimensionales. Más información...

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

QPdfLinkModel, QPdfSearchModel, QStringListModel, QVirtualKeyboardSelectionListModel y QWebEngineHistoryModel

Funciones públicas

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

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 = 0, const QModelIndex &parent = QModelIndex()) const override
virtual QModelIndex sibling(int row, int column, const QModelIndex &idx) const override

Descripción detallada

QAbstractListModel proporciona una interfaz estándar para modelos que representan sus datos como una secuencia simple y no jerárquica 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; si deseas proporcionar un modelo para ese fin, deberás crear una subclase de QAbstractItemModel. Si necesitas utilizar varios modelos de lista para gestionar datos, puede que sea más adecuado crear una subclase de QAbstractTableModel.

Se pueden crear modelos sencillos creando una subclase de esta clase e implementando el número mínimo de funciones requeridas. Por ejemplo, podríamos implementar un modelo sencillo de solo lectura basado en ` QStringList` que proporcione una lista de cadenas a un widget ` QListView `. En tal caso, solo necesitamos implementar la función ` rowCount()` para devolver el número de elementos de la lista, y la función ` data()` para recuperar elementos de la lista.

Dado que el modelo representa una estructura unidimensional, la función rowCount() devuelve el número total de elementos del modelo. La función columnCount() se implementa para garantizar la interoperabilidad con todo tipo de vistas, pero, por defecto, indica a las vistas que el modelo solo contiene una columna.

Subclasificación

Al crear una subclase de `QAbstractListModel`, debes proporcionar implementaciones de las funciones ` rowCount()` y ` data()`. Los modelos bien diseñados también proporcionan una implementación de ` headerData()`.

Si su modelo se utiliza en QML y requiere roles distintos de los predeterminados proporcionados por la función roleNames(), debe sobrescribirla.

En el caso de los modelos de lista editables, también debes proporcionar una implementación de setData() e implementar la función flags() de modo que devuelva un valor que contenga Qt::ItemIsEditable.

Ten en cuenta que `QAbstractListModel` proporciona una implementación por defecto de ` columnCount()` que informa a las vistas de que solo hay una columna de elementos en este modelo.

Los modelos que proporcionan interfaces para estructuras de datos tipo lista redimensionables pueden ofrecer implementaciones de ` insertRows()` y ` removeRows()`. Al implementar estas funciones, es importante llamar a las funciones adecuadas para que todas las vistas conectadas sean conscientes de 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 ` 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.

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

Véase también «Clases de modelos», «Referencia sobre la subclasificación de modelos», « QAbstractItemView », « QAbstractTableModel » y « QRangeModel ».

Documentación de funciones miembro

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

Crea un modelo de lista abstracta con el parent proporcionado.

[virtual noexcept] QAbstractListModel::~QAbstractListModel()

Destruye el modelo de lista abstracta.

[override virtual] bool QAbstractListModel::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 QAbstractListModel::flags(const QModelIndex &index) const

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

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

Reimplementa: QAbstractItemModel::index(int row, int column, const QModelIndex &parent) const.

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

Véase también parent().

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

Reimplementa: ` QAbstractItemModel::sibling` (int row, int column, const QModelIndex &index) 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.