QAbstractListModel Class

Ausführliche Beschreibung

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

Da das Modell eine spezialisiertere Schnittstelle als „ QAbstractItemModel “ bietet, ist es nicht für die Verwendung mit Baumansichten geeignet; Sie müssen „ QAbstractItemModel “ unterklassen, wenn Sie ein Modell für diesen Zweck bereitstellen möchten. Wenn Sie mehrere Listenmodelle zur Verwaltung von Daten verwenden müssen, ist es möglicherweise sinnvoller, stattdessen „ QAbstractTableModel “ zu unterklassen.

Einfache Modelle lassen sich erstellen, indem man diese Klasse untererbt und die Mindestanzahl der erforderlichen Funktionen implementiert. Beispielsweise könnten wir ein einfaches, schreibgeschütztes Modell auf Basis von ` QStringList` implementieren, das einem ` QListView `-Widget eine Liste von Zeichenketten bereitstellt. In einem solchen Fall müssen wir lediglich die Funktion ` rowCount()` implementieren, um die Anzahl der Elemente in der Liste zurückzugeben, sowie die Funktion ` data()`, um Elemente aus der Liste abzurufen.

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

Unterklassenbildung

Beim Erstellen einer Unterklasse von `QAbstractListModel` müssen Sie Implementierungen der Funktionen ` rowCount()` und ` data()` bereitstellen. Korrekt funktionierende Modelle stellen zudem eine Implementierung von ` headerData()` bereit.

Wenn Ihr Modell in QML verwendet wird und andere Rollen als die von der Funktion ` roleNames()` standardmäßig bereitgestellten benötigt, müssen Sie diese überschreiben.

Bei bearbeitbaren Listenmodellen müssen Sie zudem 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 Ansichten darüber informiert, dass dieses Modell nur eine einzige Spalte mit Elementen enthält.

Modelle, die Schnittstellen zu in der Größe anpassbaren, listenartigen Datenstrukturen bereitstellen, können Implementierungen von ` insertRows()` und ` removeRows()` bereitstellen. Bei der Implementierung dieser Funktionen ist es wichtig, die entsprechenden Funktionen aufzurufen, damit alle verbundenen Ansichten über etwaige Änderungen informiert werden:

• Eine Implementierung von ` insertRows()` muss vor dem Einfügen neuer Zeilen in die Datenstruktur ` beginInsertRows()` aufrufen und unmittelbar danach` endInsertRows()` aufrufen.
• Eine Implementierung von ` removeRows()` muss ` beginRemoveRows()` aufrufen, bevor die Zeilen aus der Datenstruktur entfernt werden, und unmittelbar danach` endRemoveRows()`.