QPersistentModelIndex Class

Die Klasse QPersistentModelIndex wird verwendet, um Daten in einem Datenmodell zu finden. Mehr...

Kopfzeile: #include <QPersistentModelIndex>
CMake: find_package(Qt6 REQUIRED COMPONENTS Core)
target_link_libraries(mytarget PRIVATE Qt6::Core)
qmake: QT += core

Diese Klasse ist stark vergleichbar.

Diese Klasse ist stark vergleichbar mit QModelIndex.

Öffentliche Funktionen

QPersistentModelIndex(const QModelIndex &index)
QPersistentModelIndex(const QPersistentModelIndex &other)
QPersistentModelIndex(QPersistentModelIndex &&other)
int column() const
QVariant data(int role = Qt::DisplayRole) const
Qt::ItemFlags flags() const
bool isValid() const
const QAbstractItemModel *model() const
(since 6.0) void multiData(QModelRoleDataSpan roleDataSpan) const
QModelIndex parent() const
int row() const
QModelIndex sibling(int row, int column) const
void swap(QPersistentModelIndex &other)
QModelIndex operator QModelIndex() const
QPersistentModelIndex &operator=(QPersistentModelIndex &&other)
QPersistentModelIndex &operator=(const QModelIndex &other)
QPersistentModelIndex &operator=(const QPersistentModelIndex &other)
size_t qHash(const QPersistentModelIndex &key, size_t seed = 0)
bool operator!=(const QPersistentModelIndex &lhs, const QModelIndex &rhs)
bool operator!=(const QPersistentModelIndex &lhs, const QPersistentModelIndex &rhs)
bool operator<(const QPersistentModelIndex &lhs, const QPersistentModelIndex &rhs)
bool operator==(const QPersistentModelIndex &lhs, const QModelIndex &rhs)
bool operator==(const QPersistentModelIndex &lhs, const QPersistentModelIndex &rhs)

Detaillierte Beschreibung

Ein QPersistentModelIndex ist ein Modellindex, der von einer Anwendung gespeichert und später für den Zugriff auf Informationen in einem Modell verwendet werden kann. Im Gegensatz zur Klasse QModelIndex ist es sicher, einen QPersistentModelIndex zu speichern, da das Modell sicherstellt, dass Verweise auf Elemente so lange gültig sind, wie auf sie vom Modell zugegriffen werden kann.

Es ist eine gute Praxis zu prüfen, ob persistente Modellindizes gültig sind, bevor sie verwendet werden.

Hinweis: Sie können den QPersistentModelIndex eines QStandardItemModel nicht in einem der Elemente des Modells speichern.

Siehe auch Model/View Programmierung, QModelIndex und QAbstractItemModel.

Dokumentation der Mitgliedsfunktionen

QPersistentModelIndex::QPersistentModelIndex(const QModelIndex &index)

Erzeugt einen neuen QPersistentModelIndex, der eine Kopie des Modells index ist.

QPersistentModelIndex::QPersistentModelIndex(const QPersistentModelIndex &other)

Erzeugt einen neuen QPersistentModelIndex, der eine Kopie des other persistent model index ist.

[noexcept] QPersistentModelIndex::QPersistentModelIndex(QPersistentModelIndex &&other)

Move-konstruiert eine QPersistentModelIndex-Instanz, die auf das gleiche Objekt zeigt, auf das other gezeigt hat.

int QPersistentModelIndex::column() const

Gibt die Spalte zurück, auf die sich dieser persistente Modellindex bezieht.

QVariant QPersistentModelIndex::data(int role = Qt::DisplayRole) const

Gibt die Daten für das angegebene role für das Element zurück, auf das der Index verweist, oder ein standardmäßig konstruiertes QVariant, wenn dieser persistente Modellindex invalid ist.

Siehe auch Qt::ItemDataRole und QAbstractItemModel::setData().

Qt::ItemFlags QPersistentModelIndex::flags() const

Gibt die Flaggen für das Element zurück, auf das der Index verweist.

bool QPersistentModelIndex::isValid() const

Gibt true zurück, wenn dieser Index des persistenten Modells gültig ist; andernfalls wird false zurückgegeben.

Ein gültiger Index gehört zu einem Modell und hat nicht-negative Zeilen- und Spaltennummern.

Siehe auch model(), row(), und column().

const QAbstractItemModel *QPersistentModelIndex::model() const

Gibt das Modell zurück, zu dem der Index gehört.

[since 6.0] void QPersistentModelIndex::multiData(QModelRoleDataSpan roleDataSpan) const

Füllt die angegebene roleDataSpan für das Element, auf das der Index verweist.

Diese Funktion wurde in Qt 6.0 eingeführt.

Siehe auch Qt::ItemDataRole und QAbstractItemModel::setData().

QModelIndex QPersistentModelIndex::parent() const

Gibt den übergeordneten Index QModelIndex für diesen persistenten Index zurück, oder einen ungültigen QModelIndex, wenn er keinen übergeordneten Index hat.

Siehe auch sibling() und model().

int QPersistentModelIndex::row() const

Gibt die Zeile zurück, auf die sich dieser persistente Modellindex bezieht.

QModelIndex QPersistentModelIndex::sibling(int row, int column) const

Gibt die Geschwister an row und column oder ein ungültiges QModelIndex zurück, wenn es an dieser Position keine Geschwister gibt.

Siehe auch parent().

[noexcept] void QPersistentModelIndex::swap(QPersistentModelIndex &other)

Tauscht diesen persistenten Modellindex mit other aus. Dieser Vorgang ist sehr schnell und schlägt nie fehl.

QModelIndex QPersistentModelIndex::operator QModelIndex() const

Cast-Operator, der ein QModelIndex zurückgibt.

[noexcept] QPersistentModelIndex &QPersistentModelIndex::operator=(QPersistentModelIndex &&other)

Verschieben - weist other dieser QPersistentModelIndex Instanz zu.

QPersistentModelIndex &QPersistentModelIndex::operator=(const QModelIndex &other)

Legt fest, dass der dauerhafte Modellindex auf dasselbe Element in einem Modell verweist wie der Modellindex other.

QPersistentModelIndex &QPersistentModelIndex::operator=(const QPersistentModelIndex &other)

Legt den Index des persistenten Modells so fest, dass er auf das gleiche Element in einem Modell verweist wie der Index des persistenten Modells other.

Verwandte Nicht-Mitglieder

[noexcept] size_t qHash(const QPersistentModelIndex &key, size_t seed = 0)

Gibt den Hash-Wert für key zurück, wobei seed als Startwert für die Berechnung verwendet wird.

[noexcept] bool operator!=(const QPersistentModelIndex &lhs, const QModelIndex &rhs)

Gibt true zurück, wenn lhs persistent model index nicht auf denselben Ort wie rhs model index verweist; andernfalls gibt false zurück.

[noexcept] bool operator!=(const QPersistentModelIndex &lhs, const QPersistentModelIndex &rhs)

Gibt true zurück, wenn der Index des persistenten Modells lhs nicht gleich dem Index des persistenten Modells rhs ist; andernfalls wird false zurückgegeben.

[noexcept] bool operator<(const QPersistentModelIndex &lhs, const QPersistentModelIndex &rhs)

Gibt true zurück, wenn der Index des persistenten Modells lhs kleiner ist als der Index des persistenten Modells rhs; andernfalls wird false zurückgegeben.

Die internen Datenzeiger, Zeilen-, Spalten- und Modellwerte im persistenten Modellindex werden beim Vergleich mit einem anderen persistenten Modellindex verwendet.

[noexcept] bool operator==(const QPersistentModelIndex &lhs, const QModelIndex &rhs)

Gibt true zurück, wenn lhs persistent model index auf denselben Ort wie rhs model index verweist; andernfalls wird false zurückgegeben.

Die internen Datenzeiger, Zeilen-, Spalten- und Modellwerte im persistenten Modellindex werden beim Vergleich mit einem anderen Modellindex verwendet.

[noexcept] bool operator==(const QPersistentModelIndex &lhs, const QPersistentModelIndex &rhs)

Gibt true zurück, wenn der Index des persistenten Modells lhs gleich dem Index des persistenten Modells rhs ist; andernfalls wird false zurückgegeben.

Die internen Datenzeiger, Zeilen-, Spalten- und Modellwerte im persistenten Modellindex werden beim Vergleich mit einem anderen persistenten Modellindex verwendet.

© 2025 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.