Auf dieser Seite

QModelRoleData Class

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

Header: #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)

Ausführliche Beschreibung

QModelRoleData-Objekte speichern eine Elementrolle (entweder einen 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 Ansichten oder Delegaten erstellt, wobei festgelegt wird, für welche Rolle die Daten abgerufen werden sollen. Das Objekt wird dann an Modelle übergeben (siehe QAbstractItemModel::multiData()), die die der gespeicherten Rolle entsprechenden Daten bereitstellen. Schließlich visualisiert die Ansicht die vom Modell abgerufenen Daten.

Siehe auch Modell-/Ansichtsprogrammierung und QModelRoleDataSpan.

Dokumentation der Mitgliedsfunktionen

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

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

Siehe auch ` Qt::ItemDataRole`.

[noexcept] void QModelRoleData::clearData()

Löscht die von diesem Objekt gespeicherten Daten. Beachten Sie, dass die Rolle unverändert bleibt; es werden lediglich die Daten gelöscht.

Siehe auch ` data()`.

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

Gibt die von diesem Objekt gespeicherten Daten als bearbeitbare Referenz zurück.

Siehe auch ` setData()`.

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

Gibt die in diesem Objekt gespeicherten 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 gespeicherten Daten auf „ value “. „ value “ muss einen Datentyp haben, der in einem „ QVariant “ gespeichert werden kann.

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

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

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