QModelRoleData 类
QModelRoleData 类持有一个角色及其关联的数据。更多...
头文件 | #include <QModelRoleData> |
CMake | find_package(Qt6 REQUIRED COMPONENTS Core) target_link_libraries(mytarget PRIVATE Qt6::Core) |
qmake | QT += core |
自 | Qt 6.0 |
公共函数
QModelRoleData(int role) | |
void | clearData() |
QVariant & | data() |
const QVariant & | data() const |
int | role() const |
void | setData(T &&value) |
详细描述
QModelRoleData 对象存储一个项角色(来自 Qt::ItemDataRole 列表的值,或用于自定义角色的任意整数)以及与该角色关联的数据。
通常通过视图或委托创建一个 QModelRoleData 对象,设置它们想要获取数据的角色。然后,将对象传递给模型(参见 QAbstractItemModel::multiData()),模型填充存储的角色对应的数据。最后,视图将模型获取的数据可视化。
另请参阅 模型/视图编程 和 QModelRoleDataSpan。
成员函数文档
[显式 noexcept]
QModelRoleData::QModelRoleData(int role)
为给定的 role 构造一个 QModelRoleData 对象。
另请参阅 Qt::ItemDataRole。
[noexcept]
void QModelRoleData::clearData()
清除该对象持有的数据。注意,角色保持不变;只有数据被清除。
另请参阅 data。
[constexpr noexcept]
QVariant &QModelRoleData::data()
返回此对象持有的数据,作为可修改的引用。
另请参阅 setData。
[constexpr noexcept]
const QVariant &QModelRoleData::data() const
返回此对象持有的数据。
另请参阅 setData。
[constexpr noexcept]
int QModelRoleData::role() const
返回该对象所持有的角色。
另请参阅 Qt::ItemDataRole。
[constexpr noexcept(...)]
模板 <typename T> void QModelRoleData::setData(T &&value)
将此对象持有的数据设置为value。 value必须是一种可以存储在QVariant中的数据类型。
注意:当 "noexcept(m_data.setValue(std::forward<T>(value)))" 为真时,此函数不抛出任何异常。
另请参阅 data(),clearData() 和 Q_DECLARE_METATYPE。
© 2024 The Qt Company Ltd. 本文档中的文档贡献归各自所有者版权所有。本文件内的文档是根据由自由软件基金会发布的GNU自由文档许可证1.3版的条款许可使用的。Qt 和相关标志是芬兰及/或世界其他地区的 The Qt Company Ltd. 的商标。所有其他商标归其各自所有者所有。