QModelRoleData 类

QModelRoleData 类持有一个角色及其关联的数据。更多...

头文件 #include <QModelRoleData>
CMakefind_package(Qt6 REQUIRED COMPONENTS Core)
target_link_libraries(mytarget PRIVATE Qt6::Core)
qmakeQT += core
Qt 6.0

公共函数

QModelRoleData(int role)
voidclearData()
QVariant &data()
const QVariant &data() const
introle() const
voidsetData(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)

将此对象持有的数据设置为valuevalue必须是一种可以存储在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. 的商标。所有其他商标归其各自所有者所有。