QAbstractListModel

La classe QAbstractListModel fournit un mod�le abstrait qui peut �tre h�rit� pour cr�er des mod�les de listes unidimensionnelles. Plus d'informations...

#include <QAbstractListModel>

Voir la position dans l'arbre des classes.

H�ritage

H�rite de QAbstractItemModel.

H�rit� par QStringListModel.

Description d�taill�e

La classe QAbstractListModel fournit un mod�le abstrait qui peut �tre h�rit� pour cr�er des mod�les de listes unidimensionnelles.

QAbstractListModel fournit une interface standard pour des mod�les qui repr�sentent leurs donn�es comme une simple s�quence non hi�rarchique d'�l�ments. Elle ne doit pas �tre utilis�e telle quelle mais doit �tre h�rit�e.

Comme la classe fournit une interface plus sp�cialis�e que QAbstractItemModel, elle n'est pas adapt�e pour repr�senter un mod�le d'arbre. Il est n�cessaire d'h�riter QAbstractItemModel si vous voulez fournir un mod�le pour ce genre d'utilisation. Si vous avez besoin de plusieurs mod�les listes pour manipuler des donn�es, il peut �tre plus appropri� d'h�riter plut�t de la classe QAbstractTableModel.

Des mod�les simples peuvent �tre cr��s en h�ritant de cette classe et en impl�mentant le nombre minimum de fonctions requises. Par exemple, on peut impl�menter un mod�le en lecture seule bas� sur QStringList qui fournit une liste de cha�nes � un widget QListView. Dans un tel cas, il suffit d'impl�menter la fonction rowCount() qui retourne le nombre d'�l�ments dans la liste et la fonction data() pour r�cup�rer les �l�ments de la liste.

Comme le mod�le repr�sente une structure unidimensionnelle, la fonction rowCount() retourne le nombre total d'�l�ments dans le mod�le. La fonction columnCount() est impl�ment�e pour l?interop�rabilit� avec tous les types de vues mais par d�faut elle informe les vues que le mod�le ne contient qu'une seule colonne.

H�ritage

Quand vous h�ritez de QAbstractListModel, vous devez fournir des impl�mentations des fonctions rowCount() et data(). Les mod�les doivent de pr�f�rence fournir une impl�mentation de headerData().

Pour les mod�les de listes �ditables, vous devez aussi fournir une impl�mentation de setData() et de flags() qui doit retourner une valeur contenant Qt::ItemIsEditable.

Notez que QAbstractListModel fournit une impl�mentation par d�faut de columnCount() qui informe les vues que le mod�le ne contient qu'une seule colonne d'�l�ments.

Les mod�les qui fournissent des interfaces pour des structures de donn�es redimensionnables peuvent fournir des impl�mentations de insertRows() et removeRows(). Quand on impl�mente ces fonctions, il est important d'appeler les fonctions appropri�es pour que toutes les vues connect�es soient inform�es des changements :

• une impl�mentation de insertRows() doit appeler beginInsertRows() avant d'ins�rer des lignes dans la structure de donn�es et elle doit appeler endInsertRows() imm�diatement apr�s ;
• une impl�mentation de removeRows() doit appeler beginRemoveRows() avant de retirer des lignes de la structure de donn�es et elle doit appeler endRemoveRows() imm�diatement apr�s.

Note : des directives g�n�rales pour d�river les mod�les sont disponibles dans la R�f�rence de d�rivation des mod�les.

Voir aussi Classes mod�le, R�f�rence de d�rivation des mod�les, QAbstractItemView, QAbstractTableModel et Exemple de puzzle de vues d'�l�ments.

Fonctions membres

QAbstractListModel::QAbstractListModel ( QObject * parent = 0 )

Construit un mod�le abstrait de liste avec le parent donn�.

QAbstractListModel::~QAbstractListModel ()

D�truit le mod�le abstrait de liste.

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

R�impl�mentation de QAbstractItemModel::dropMimeData().

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

R�impl�mentation de QAbstractItemModel::index().

Retourne l'index de la donn�e � la ligne row et la colonne column avec le parent donn�.

Voir aussi parent().

Remerciements

Merci � Nicolas Cornu pour la traduction et Ilya Diallo, Dimitry Ernot ainsi que Claude Leloup pour leur relecture !