QAbstractTableModel Class

Detaillierte Beschreibung

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

Da das Modell eine spezialisiertere Schnittstelle als QAbstractItemModel bietet, ist es nicht für die Verwendung mit Baumansichten geeignet, obwohl es verwendet werden kann, um Daten für QListView bereitzustellen. Wenn Sie eine einfache Liste von Elementen darstellen müssen und ein Modell nur eine einzelne Datenspalte enthalten soll, ist die Unterklassifizierung 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 nur die Zeilen- und Spaltennummern an.

Unterklassifizierung

Wenn Sie QAbstractTableModel subclassing, müssen Sie rowCount(), columnCount(), und data() implementieren. Standardimplementierungen der Funktionen index() und parent() werden von QAbstractTableModel bereitgestellt. Gut funktionierende Modelle implementieren auch headerData().

Editierbare Modelle müssen setData() implementieren, und flags() implementieren, um einen Wert mit Qt::ItemIsEditable zurückzugeben.

Modelle, die Schnittstellen zu größenveränderlichen Datenstrukturen anbieten, können Implementierungen von insertRows(), removeRows(), insertColumns() und removeColumns() 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 insertColumns()-Implementierung muss beginInsertColumns() aufrufen , bevor sie neue Spalten in die Datenstruktur einfügt, und sie muss endInsertColumns() unmittelbar danach aufrufen.
• Eine removeRows()-Implementierung muss beginRemoveRows() aufrufen , bevor die Zeilen aus der Datenstruktur entfernt werden, und muss unmittelbar danach endRemoveRows() aufrufen.
• Eine removeColumns()-Implementierung muss beginRemoveColumns() aufrufen , bevor die Spalten aus der Datenstruktur entfernt werden, und sie muss endRemoveColumns() unmittelbar danach aufrufen.

Thread-Sicherheit

Als Unterklasse von QObject ist QAbstractTableModel nicht thread-safe. Jede modellbezogene API von QAbstractTableModel sollte nur von dem Thread aufgerufen werden, in dem sich das Modellobjekt befindet. Wenn das QAbstractTableModel mit einer Ansicht verbunden ist, bedeutet dies den GUI-Thread, da sich die Ansicht dort befindet und das Modell vom GUI-Thread aus aufgerufen wird. Die Verwendung eines Hintergrund-Threads zum Auffüllen oder Ändern des Inhalts eines Modells ist möglich, erfordert aber Vorsicht, da der Hintergrund-Thread keine modellbezogene API direkt aufrufen kann. Stattdessen sollten Sie die Aktualisierungen in eine Warteschlange stellen und sie im Hauptthread anwenden. Dies kann mit Warteschlangenverbindungen geschehen.