QAbstractTableModel

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

 #include <QAbstractTableModel>

H�ritage

H�rite de QAbstractItemModel.

H�rit� par QSqlQueryModel.

Description d�taill�e

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

QAbstractTableModel fournit une interface standard pour les mod�les qui repr�sentent leurs donn�es sous forme d'un tableau bidimensionnel d'�l�ments. Il ne peut �tre utilis� directement mais doit �tre h�rit�.

Comme le mod�le fournit une interface plus sp�cialis�e que QAbstractItemModel, il n'est pas adapt� � une utilisation avec des vues de type arbre, mais il peut �tre utilis� pour fournir des donn�es � un QListView. Si vous avez besoin de repr�senter une simple liste d'�l�ments et avez besoin d'un mod�le contenant une seule colonne de donn�es, h�riter de QAbstractListModel peut �tre plus indiqu�.

Les fonctions rowCount() et columnCount() retournent les dimensions de la table. Pour r�cup�rer un index correspondant � un �l�ment dans le mod�le, utiliser index() en fournissant les num�ros de ligne et de colonne.

H�ritage

Quand vous h�ritez de QAbstractTableModel, vous devez impl�menter rowCount(), columnCount() et data(). Les impl�mentations par d�faut des fonctions index() et parent() sont fournies par QAbstractTableModel. Les mod�les qui voudront �tre complets impl�menteront aussi headerData().

Les mod�les �ditables auront besoin d'impl�menter setData() et l'impl�mentation de flags() devra retourner une valeur contenant Qt::ItemIsEditable.

Les mod�les qui fournissent des interfaces � des structures de donn�es redimensionnables peuvent fournir des impl�mentations de insertRows(), removeRows(), insertColumns() et removeColumns(). Dans l'impl�mentation de ces fonctions, il est important d'appeler les fonctions appropri�es afin que toutes les vues connect�es soient inform�es de tout changement :

• une impl�mentation de insertRows() doit appeler beginInsertRows() avant l'insertion de nouvelles lignes dans la structure de donn�es et elle doit appeler endInsertRows() imm�diatement apr�s ;
• une impl�mentation de insertColumns() doit appeler beginInsertColumns() avant l'insertion de nouvelles colonnes dans la structure de donn�es et elle doit appeler endInsertColumns() imm�diatement apr�s ;
• une impl�mentation de removeRows() doit appeler beginRemoveRows() avant que les lignes soient supprim�es de la structure de donn�es et elle doit appeler endRemoveRows() imm�diatement apr�s ;
• une impl�mentation de removeColumns() doit appeler beginRemoveColumns() avant que les colonnes soient supprim�es de la structure de donn�es et elle doit appeler endRemoveColumns() imm�diatement apr�s.

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

Note : voir aussi Classes de mod�le, QAbstractItemModel, QAbstractListModel et Pixelator Example.

Fonctions membres

QAbstractTableModel::QAbstractTableModel ( QObject * parent = 0 )

Construit un mod�le abstrait de tableau pour le parent donn�.

QAbstractTableModel::~QAbstractTableModel ()

D�truit le mod�le abstrait de tableau.

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

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

QModelIndex QAbstractTableModel::index ( int row, int column, 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 ayant pour parent parent.

Voir aussi parent().

Remerciements

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