QModelRoleData Class

Die Klasse QModelRoleData enthält eine Rolle und die mit dieser Rolle verbundenen Daten. Mehr...

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

Öffentliche Funktionen

QModelRoleData(int role)
void clearData()
QVariant &data()
const QVariant &data() const
int role() const
void setData(T &&value)

Detaillierte Beschreibung

QModelRoleData-Objekte speichern eine Elementrolle (ein Wert aus der Aufzählung Qt::ItemDataRole oder eine beliebige Ganzzahl für eine benutzerdefinierte Rolle) sowie die mit dieser Rolle verbundenen Daten.

Ein QModelRoleData-Objekt wird in der Regel von Views oder Delegates erstellt, die festlegen, für welche Rolle sie die Daten abrufen wollen. Das Objekt wird dann an Models weitergegeben (siehe QAbstractItemModel::multiData()), die die Daten entsprechend der gespeicherten Rolle auffüllen. Schließlich visualisiert die Ansicht die vom Modell abgerufenen Daten.

Siehe auch Model/View-Programmierung und QModelRoleDataSpan.

Dokumentation der Mitgliedsfunktionen

[explicit noexcept] QModelRoleData::QModelRoleData(int role)

Konstruiert ein QModelRoleData-Objekt für die angegebene role.

Siehe auch Qt::ItemDataRole.

[noexcept] void QModelRoleData::clearData()

Löscht die Daten dieses Objekts. Beachten Sie, dass die Rolle unverändert bleibt; nur die Daten werden gelöscht.

Siehe auch data().

[constexpr noexcept] QVariant &QModelRoleData::data()

Gibt die in diesem Objekt enthaltenen Daten als veränderbare Referenz zurück.

Siehe auch setData().

[constexpr noexcept] const QVariant &QModelRoleData::data() const

Gibt die in diesem Objekt enthaltenen Daten zurück.

Siehe auch setData().

[constexpr noexcept] int QModelRoleData::role() const

Gibt die Rolle zurück, die dieses Objekt innehat.

Siehe auch Qt::ItemDataRole.

[constexpr noexcept(...)] template <typename T> void QModelRoleData::setData(T &&value)

Setzt die von diesem Objekt gehaltenen Daten auf value. value muss von einem Datentyp sein, der in einem QVariant gespeichert werden kann.

Hinweis: Diese Funktion ist noexcept, wenn noexcept(m_data.setValue(std::forward<T>(value))) true ist.

Siehe auch data(), clearData(), und Q_DECLARE_METATYPE.

© 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.