QAbstractListModel Class

Detaillierte Beschreibung

QAbstractListModel bietet eine Standardschnittstelle für Modelle, die ihre Daten als einfache nicht-hierarchische Folge von Elementen darstellen. Sie wird nicht direkt verwendet, sondern muss subclassed werden.

Da das Modell eine speziellere Schnittstelle als QAbstractItemModel bietet, ist es nicht für die Verwendung mit Baumansichten geeignet; Sie müssen QAbstractItemModel unterklassifizieren, wenn Sie ein Modell für diesen Zweck bereitstellen wollen. Wenn Sie eine Reihe von Listenmodellen zur Verwaltung von Daten verwenden müssen, kann es sinnvoller sein, stattdessen die Unterklasse QAbstractTableModel zu verwenden.

Einfache Modelle können durch Unterklassifizierung dieser Klasse und Implementierung der Mindestanzahl der erforderlichen Funktionen erstellt werden. Wir könnten zum Beispiel ein einfaches schreibgeschütztes QStringList-basiertes Modell implementieren, das eine Liste von Strings an ein QListView -Widget liefert. In einem solchen Fall müssen wir nur die Funktion rowCount() implementieren, um die Anzahl der Elemente in der Liste zurückzugeben, und die Funktion data(), um Elemente aus der Liste abzurufen.

Da das Modell eine eindimensionale Struktur darstellt, gibt die Funktion rowCount() die Gesamtzahl der Elemente im Modell zurück. Die Funktion columnCount() ist für die Interoperabilität mit allen Arten von Ansichten implementiert, teilt den Ansichten jedoch standardmäßig mit, dass das Modell nur eine Spalte enthält.

Unterklassifizierung

Wenn Sie QAbstractListModel subclassing, müssen Sie Implementierungen der Funktionen rowCount() und data() bereitstellen. Gut funktionierende Modelle bieten auch eine headerData()-Implementierung.

Wenn Ihr Modell innerhalb von QML verwendet wird und andere Rollen als die Standardrollen benötigt, die von der Funktion roleNames() bereitgestellt werden, müssen Sie diese überschreiben.

Für editierbare Listenmodelle müssen Sie auch eine Implementierung von setData() bereitstellen, und die Funktion flags() so implementieren, dass sie einen Wert zurückgibt, der Qt::ItemIsEditable enthält.

Beachten Sie, dass QAbstractListModel eine Standardimplementierung von columnCount() bereitstellt, die die Ansichten darüber informiert, dass es nur eine einzige Spalte mit Elementen in diesem Modell gibt.

Modelle, die Schnittstellen zu größenveränderlichen listenähnlichen Datenstrukturen anbieten, können Implementierungen von insertRows() und removeRows() bereitstellen. Bei der Implementierung dieser Funktionen ist es wichtig, die entsprechenden Funktionen aufzurufen, damit alle angeschlossenen Sichten über Änderungen informiert sind:

• Eine insertRows()-Implementierung muss beginInsertRows() aufrufen , bevor neue Zeilen in die Datenstruktur eingefügt werden, und sie muss endInsertRows() unmittelbar danach aufrufen.
• Eine removeRows()-Implementierung muss beginRemoveRows() aufrufen , bevor die Zeilen aus der Datenstruktur entfernt werden, und sie muss endRemoveRows() unmittelbar danach aufrufen.