QAbstractListModel Class

Description détaillée

QAbstractListModel fournit une interface standard pour les modèles qui représentent leurs données sous la forme d’une simple séquence non hiérarchique 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 celle de ` QAbstractItemModel`, il n'est pas adapté à une utilisation avec des arborescences ; vous devrez créer une sous-classe de ` QAbstractItemModel ` si vous souhaitez fournir un modèle à cette fin. Si vous devez utiliser plusieurs modèles de liste pour gérer des données, il peut être plus approprié de créer une sous-classe de ` QAbstractTableModel `.

Des modèles simples peuvent être créés en sous-classant cette classe et en implémentant le nombre minimum de fonctions requises. Par exemple, nous pourrions implémenter un modèle simple en lecture seule basé sur QStringList qui fournit une liste de chaînes de caractères à un widget QListView. Dans ce cas, il suffit d’implémenter la fonction rowCount() pour renvoyer le nombre d’éléments de la liste, et la fonction data() pour récupérer des éléments de la liste.

Comme le modèle représente une structure unidimensionnelle, la fonction rowCount() renvoie le nombre total d’éléments du modèle. La fonction columnCount() est implémentée pour assurer l’interopérabilité avec tous les types de vues, mais elle indique par défaut aux vues que le modèle ne contient qu’une seule colonne.

Sous-classement

Lorsque vous créez une sous-classe de `QAbstractListModel`, vous devez fournir des implémentations des fonctions ` rowCount()` et ` data()`. Les modèles bien conçus fournissent également une implémentation de ` headerData()`.

Si votre modèle est utilisé dans QML et nécessite des rôles autres que ceux fournis par défaut par la fonction ` roleNames()`, vous devez la redéfinir.

Pour les modèles de liste modifiables, vous devez également fournir une implémentation de setData() et implémenter la fonction flags() de manière à ce qu’elle renvoie une valeur contenant Qt::ItemIsEditable.

Notez que QAbstractListModel fournit une implémentation par défaut de columnCount() qui indique aux vues qu’il n’y a qu’une seule colonne d’éléments dans ce modèle.

Les modèles fournissant des interfaces vers des structures de données de type liste redimensionnables peuvent proposer des implémentations de insertRows() et removeRows(). 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 ` removeRows()` doit appeler ` beginRemoveRows()` avant que les lignes ne soient supprimées de la structure de données, puis ` endRemoveRows()` immédiatement après.