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. Il n'est pas utilisé directement, mais doit être sous-classé.

Comme ce modèle fournit une interface plus spécialisée que QAbstractItemModel, il n’est pas adapté à une utilisation avec des arborescences, bien qu’il puisse servir à fournir des données à un QListView. Si vous devez représenter une simple liste d’éléments et que vous n’avez besoin d’un modèle contenant qu’une seule colonne de données, il peut être plus approprié de créer une sous-classe de QAbstractListModel.

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

Sous-classement

Lorsque vous créez une sous-classe de `QAbstractTableModel`, vous devez implémenter les méthodes ` rowCount()`, ` columnCount()` et ` data()`. Des implémentations par défaut des méthodes ` index()` et ` parent()` sont fournies par `QAbstractTableModel`. Les modèles bien conçus implémenteront également la méthode ` headerData()`.

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

Les modèles fournissant des interfaces vers des structures de données redimensionnables peuvent proposer 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, puis appeler endInsertRows() immédiatement après.
• Une implémentation de ` insertColumns()` doit appeler ` beginInsertColumns()` avant d’insérer de nouvelles colonnes dans la structure de données, puis appeler ` endInsertColumns()` immédiatement après.
• Une implémentation de ` removeRows()` doit appeler ` beginRemoveRows()` avant que les lignes ne soient supprimées de la structure de données, puis 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, puis appeler ` endRemoveColumns()` immédiatement après.

Sécurité des threads

En tant que 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 réside l'objet modèle. Si QAbstractTableModel est connecté à une vue, il s'exécute 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. Vous devez plutôt mettre les mises à jour en file d’attente et les appliquer dans le thread principal. Cela peut être réalisé à l’aide de connexions mises en file d’attente.