QAbstractListModel Class

Descripción detallada

QAbstractListModel proporciona una interfaz estándar para los modelos que representan sus datos como una simple secuencia 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; tendrá que subclasificar QAbstractItemModel si desea proporcionar un modelo para ese fin. Si necesita utilizar varios modelos de lista para gestionar datos, puede que sea más apropiado subclasificar QAbstractTableModel.

Se pueden crear modelos sencillos subclasificando esta clase e implementando el número mínimo de funciones necesarias. Por ejemplo, podríamos implementar un modelo simple de sólo lectura basado en QStringList que proporcione una lista de cadenas a un widget QListView. En tal caso, sólo 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() está implementada para interoperar con todo tipo de vistas, pero por defecto informa a las vistas de que el modelo sólo contiene una columna.

Subclases

Al subclasificar QAbstractListModel, debes proporcionar implementaciones de las funciones rowCount() y data(). Los modelos con buen comportamiento también proporcionan una implementación de headerData().

Si su modelo se utiliza dentro de QML y requiere funciones distintas de las predeterminadas proporcionadas por la función roleNames(), debe anularla.

Para los modelos de listas editables, también debe proporcionar una implementación de setData(), e implementar la función flags() para 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 sólo hay una única columna de elementos en este modelo.

Los modelos que proporcionan interfaces a estructuras de datos tipo lista redimensionables pueden proporcionar implementaciones de insertRows() y removeRows(). Al implementar estas funciones, es importante llamar a las funciones apropiadas 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 eliminar filas de la estructura de datos, y debe llamar a endRemoveRows() inmediatamente después.