ItemModelScatterDataProxy QML 类型

代理类，用于在具有 Scatter3D 的项模型中呈现数据。更多...

导入语句	import QtGraphs
实例化	QItemModelScatterDataProxy
继承	ScatterDataProxy
状态	技术预览

所有成员列表，包括继承的成员
ItemModelScatterDataProxy 属于 Qt 图形 QML 3D 类型。

属性

itemModel : model
rotationRole : string
rotationRolePattern : regExp
rotationRoleReplace : string
xPosRole : string
xPosRolePattern : regExp
xPosRoleReplace : string
yPosRole : string
yPosRolePattern : regExp
yPosRoleReplace : string
zPosRole : string
zPosRolePattern : regExp
zPosRoleReplace : string

详细描述

此类型允许您将派生自 AbstractItemModel 的模型用作 Scatter3D 数据源。

数据在映射或模型更改时异步解析。数据解析完成后，会发出 QScatterDataProxy::arrayReset{" "

有关更多信息，请参阅 QItemModelScatterDataProxy 文档。

使用示例

ItemModelScatterDataProxy {
    itemModel: model // E.g. a list model defined elsewhere containing point coordinates.
    // Mapping model roles to scatter series item coordinates.
    xPosRole: "xPos"
    yPosRole: "yPos"
    zPosRole: "zPos"
}

另请参阅ScatterDataProxy 和使用 3D 的 Qt 图形数据处理.

属性文档

itemModel : model

用作 Scatter3D 数据源的项目模型。

rotationRole : string

项目模型角色用于映射到项目旋转。模型可以通过直接可转换为四元数的变体，或者作为以下字符串表示之一提供旋转值："标量,x,y,z" 或 "@角度,x,y,z"。第一种格式将直接使用给定的值构造四元数，第二种将使用 QQuaternion::fromAxisAndAngle() 方法构造四元数。

rotationRolePattern : 正则表达式

设置时，在将映射的旋转值用作项目旋转之前，将在旋转角色映射的值上进行搜索和替换。此属性指定用于查找要替换的映射值部分的正则表达式，而 rotationRoleReplace 属性包含替换字符串。

参见 rotationRole 和 rotationRoleReplace。

rotationRoleReplace : 字符串

此属性定义与 rotationRolePattern 结合使用的替换内容。默认为空字符串。有关使用正则表达式进行搜索和替换的更多信息，请参阅 QString::replace(const QRegularExpression &rx, const QString &after) 函数文档。

参见 rotationRole 和 rotationRolePattern。

xPosRole : 字符串

将映射到 X 位置的项目模型角色。

xPosRolePattern : 正则表达式

设置时，在将 X 位置角色映射的值用作项目位置值之前，将对其执行搜索和替换。此属性指定用于查找要替换的映射值部分的正则表达式，而 xPosRoleReplace 属性包含替换字符串。

参见 xPosRole 和 xPosRoleReplace。

xPosRoleReplace : 字符串

此属性定义与 xPosRolePattern 结合使用的替换内容。默认为空字符串。有关使用正则表达式进行搜索和替换的更多信息，请参阅 QString::replace(const QRegularExpression &rx, const QString &after) 函数文档。

参见 xPosRole 和 xPosRolePattern。

yPosRole : 字符串

将映射到 Y 位置的项目模型角色。

yPosRolePattern : 正则表达式

设置时，在将 Y 位置角色映射的值用作项目位置值之前，将对其执行搜索和替换。此属性指定用于查找要替换的映射值部分的正则表达式，而 yPosRoleReplace 属性包含替换字符串。

参见 yPosRole 和 yPosRoleReplace。

yPosRoleReplace : 字符串

此属性定义了与yPosRolePattern一起使用的替换内容。默认为空字符串。有关使用正则表达式进行搜索和替换的更多信息，请参阅QString::replace(const QRegularExpression &rx, const QString &after)函数文档。

另请参阅yPosRole和yPosRolePattern。

zPosRole : 字符串

映射到Z位置的项模型角色。

zPosRolePattern : 正则表达式

当设置时，在将z位置角色的值用作项位置值之前，将对映射的值执行搜索和替换。此属性指定要替换的映射值的正则表达式，而zPosRoleReplace属性包含替换字符串。

另请参阅zPosRole和zPosRoleReplace。

zPosRoleReplace : 字符串

此属性定义了与zPosRolePattern一起使用的替换内容。默认为空字符串。有关使用正则表达式进行搜索和替换的更多信息，请参阅QString::replace(const QRegularExpression &rx, const QString &after)函数文档。

另请参阅zPosRole和zPosRolePattern。