QAbstractTableModel Class

Ausführliche Beschreibung

QAbstractTableModel bietet eine Standardschnittstelle für Modelle, die ihre Daten als zweidimensionales Array von Elementen darstellen. Es wird nicht direkt verwendet, sondern muss unterklassifiziert werden.

Da das Modell eine spezialisiertere Schnittstelle als „ QAbstractItemModel “ bietet, eignet es sich nicht für die Verwendung mit Baumansichten, kann jedoch zur Bereitstellung von Daten für ein „ QListView “ verwendet werden. Wenn Sie eine einfache Liste von Elementen darstellen möchten und ein Modell benötigen, das nur eine einzige Datenspalte enthält, ist die Erstellung einer Unterklasse von „ QAbstractListModel “ möglicherweise besser geeignet.

Die Funktionen „ rowCount()“ und „ columnCount()“ geben die Dimensionen der Tabelle zurück. Um einen Modellindex abzurufen, der einem Element im Modell entspricht, verwenden Sie „ index()“ und geben Sie dabei nur die Zeilen- und Spaltennummern an.

Unterklassenbildung

Wenn Sie eine Unterklasse von `QAbstractTableModel` erstellen, müssen Sie die Methoden ` rowCount()`, ` columnCount()` und ` data()` implementieren. Standardimplementierungen der Methoden ` index()` und ` parent()` werden von `QAbstractTableModel` bereitgestellt. Gut funktionierende Modelle sollten außerdem die Methode ` headerData()` implementieren.

Bearbeitbare Modelle müssen ` setData()` implementieren und ` flags()` implementieren, um einen Wert zurückzugeben, der ` Qt::ItemIsEditable` enthält.

Modelle, die Schnittstellen zu in der Größe anpassbaren Datenstrukturen bereitstellen, können Implementierungen von ` insertRows()`, ` removeRows()`, ` insertColumns()` und ` removeColumns()` 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 ` insertColumns()` muss vor dem Einfügen neuer Spalten in die Datenstruktur ` beginInsertColumns()` aufrufen und unmittelbar danach` endInsertColumns()` aufrufen.
• Eine Implementierung von ` removeRows()` muss ` beginRemoveRows()` aufrufen, bevor die Zeilen aus der Datenstruktur entfernt werden, und unmittelbar danach` endRemoveRows()` aufrufen.
• Eine Implementierung von ` removeColumns()` muss ` beginRemoveColumns()` aufrufen, bevor die Spalten aus der Datenstruktur entfernt werden, und unmittelbar danach` endRemoveColumns()` aufrufen.

Thread-Sicherheit

Da QAbstractTableModel eine Unterklasse von QObject ist, ist es nicht „ thread-safe “. Jede modellbezogene API von QAbstractTableModel sollte nur aus dem Thread aufgerufen werden, in dem sich das Modellobjekt befindet. Wenn QAbstractTableModel mit einer Ansicht verbunden ist, arbeitet es im GUI-Thread, da sich die Ansicht dort befindet und von diesem Thread aus mit dem Modell interagiert. Zwar kann ein Hintergrund-Thread zum Befüllen oder Ändern des Modellinhalts verwendet werden, dies muss jedoch mit Bedacht geschehen, da er keine modellbezogenen API-Funktionen direkt aufrufen darf. Stattdessen sollten Sie die Aktualisierungen in eine Warteschlange stellen und im Haupt-Thread anwenden. Dies kann mithilfe von Verbindungen mit Warteschlange erfolgen.