QAbstractTableModel Class

Description détaillée

QAbstractTableModel fournit une interface standard pour les modèles qui représentent leurs données sous la forme d'un tableau bidimensionnel d'éléments. Elle n'est pas utilisée directement, mais doit être sous-classée.

Étant donné que le modèle fournit une interface plus spécialisée que QAbstractItemModel, il ne convient pas aux vues arborescentes, bien qu'il puisse être utilisé pour fournir des données à QListView. Si vous devez représenter une simple liste d'éléments et que vous n'avez besoin que d'un modèle contenant une seule colonne de données, il peut être plus approprié de sous-classer QAbstractListModel.

Les fonctions rowCount() et columnCount() renvoient les dimensions du tableau. Pour récupérer un index de modèle correspondant à un élément du modèle, utilisez index() et fournissez uniquement les numéros de ligne et de colonne.

Sous-classement

Lorsque vous sous-classez QAbstractTableModel, vous devez implémenter les fonctions rowCount(), columnCount() et data(). Les implémentations par défaut des fonctions index() et parent() sont fournies par QAbstractTableModel. Les modèles qui se comportent bien implémenteront également headerData().

Les modèles modifiables doivent implémenter setData() et flags() pour renvoyer une valeur contenant Qt::ItemIsEditable.

Les modèles qui fournissent des interfaces pour les structures de données redimensionnables peuvent fournir des implémentations de insertRows(), removeRows(), insertColumns() et removeColumns(). Lors de 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 d' insérer de nouvelles lignes dans la structure de données et doit appeler endInsertRows() immédiatement après.
• Une implémentation insertColumns() doit appeler beginInsertColumns() avant d' insérer de nouvelles colonnes dans la structure de données et doit appeler endInsertColumns() immédiatement après.
• Une implémentation removeRows() doit appeler beginRemoveRows() avant que les lignes ne soient supprimées de la structure de données, et doit appeler endRemoveRows() immédiatement après.
• Une implémentation de removeColumns() doit appeler beginRemoveColumns() avant que les colonnes ne soient supprimées de la structure de données, et doit appeler endRemoveColumns() immédiatement après.

Sécurité des threads

Étant une sous-classe de QObject, QAbstractTableModel n'est pas thread-safe. Toute API liée au modèle QAbstractTableModel ne doit être appelée qu'à partir du thread dans lequel vit l'objet du modèle. Si QAbstractTableModel est connecté à une vue, il opère sur le thread de l'interface graphique, car la vue y réside et interagit avec le modèle à partir de ce thread. Bien qu'un thread d'arrière-plan puisse être utilisé pour remplir ou modifier le contenu du modèle, il doit le faire avec précaution, car il ne peut appeler directement aucune API liée au modèle. Au lieu de cela, vous devez mettre les mises à jour en file d'attente et les appliquer dans le fil d'exécution principal. Cela peut se faire à l'aide de connexions en file d'attente.