ItemModelScatterDataProxy QML Type

代理类，用于在Scatter3D 项目模型中显示数据。更多

• 所有成员（包括继承成员）的列表
• ItemModelScatterDataProxy 是Qt Graphs QML Types for 3D 的一部分。

属性

• itemModel : model
• rotationRole : string
• rotationRolePattern : regExp
• rotationRoleReplace : string
• scaleRole : string
• scaleRolePattern : regExp
• scaleRoleReplace : string
• type : AbstractDataProxy.DataType
• xPosRole : string
• xPosRolePattern : regExp
• xPosRoleReplace : string
• yPosRole : string
• yPosRolePattern : regExp
• yPosRoleReplace : string
• zPosRole : string
• zPosRolePattern : regExp
• zPosRoleReplace : string

信号

• itemModelChanged(model itemModel)
• rotationRoleChanged(string role)
• rotationRolePatternChanged(regExp pattern)
• rotationRoleReplaceChanged(string replace)
• scaleRoleChanged(string role)
• scaleRolePatternChanged(regExp pattern)
• scaleRoleReplaceChanged(string replace)
• xPosRoleChanged(string role)
• xPosRolePatternChanged(regExp pattern)
• xPosRoleReplaceChanged(string replace)
• yPosRoleChanged(string role)
• yPosRolePatternChanged(regExp pattern)
• yPosRoleReplaceChanged(string replace)
• zPosRoleChanged(string role)
• zPosRolePatternChanged(regExp pattern)
• zPosRoleReplaceChanged(string replace)

详细描述

该类型允许您使用 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 和Qt Graphs 3D 数据处理。

属性文档

itemModel : model

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

rotationRole : string

映射到项目旋转的项目模型角色。模型提供的旋转值可以是直接转换为quaternion 的变量，也可以是字符串表示形式之一："scalar,x,y,z" 或"@angle,x,y,z" 。第一种格式将用给定的值直接构造quaternion ，第二种格式将使用QQuaternion::fromAxisAndAngle() 方法构造quaternion 。

rotationRolePattern : regExp

设置后，将对旋转角色映射的值进行搜索和替换，然后再将其用作项目旋转。该属性指定正则表达式，用于查找要替换的映射值部分，而rotationRoleReplace 属性则包含替换字符串。

另请参阅 rotationRole 和rotationRoleReplace 。

rotationRoleReplace : string

该属性定义了与rotationRolePattern 一起使用的替换内容。默认为空字符串。有关使用正则表达式进行搜索和替换的工作原理，请参阅QString::replace(constQRegularExpression &rx, constQString &after) 函数文档。

另请参阅 rotationRole 和rotationRolePattern 。

scaleRole : string

模型可以以"x,y,z" 的变体形式提供比例值。第一个变量将直接用给定的值构建 vector3d。

scaleRolePattern : regExp

设置后，将对标尺角色映射的值进行搜索和替换，然后再将其用作项目标尺。该属性指定正则表达式，用于查找要替换的映射值部分，而scaleRoleReplace 属性则包含替换字符串。

另请参阅 scaleRole 和scaleRoleReplace 。

scaleRoleReplace : string

该属性定义了与scaleRolePattern 一起使用的替换内容。默认为空字符串。有关使用正则表达式进行搜索和替换的工作原理，请参阅QString::replace(constQRegularExpression &rx, constQString &after) 函数文档。

另请参阅 scaleRole 和scaleRolePattern 。

type : AbstractDataProxy.DataType [read-only]

代理类型。QAbstractDataProxy::DataType 值之一。

xPosRole : string

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

xPosRolePattern : regExp

设置后，将对 x-position 角色映射的值进行搜索和替换，然后再将其用作项目位置值。该属性指定正则表达式，用于查找要替换的映射值部分，而xPosRoleReplace 属性则包含替换字符串。

另请参阅 xPosRole 和xPosRoleReplace 。

xPosRoleReplace : string

该属性定义了与xPosRolePattern 一起使用的替换内容。默认为空字符串。有关使用正则表达式进行搜索和替换的工作原理，请参阅QString::replace(constQRegularExpression &rx, constQString &after) 函数文档。

另请参阅 xPosRole 和xPosRolePattern 。

yPosRole : string

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

yPosRolePattern : regExp

设置该属性后，将对 y-position 角色映射的值进行搜索和替换，然后再将其用作项目位置值。该属性指定正则表达式，用于查找要替换的映射值部分，而yPosRoleReplace 属性则包含替换字符串。

另请参阅 yPosRole 和yPosRoleReplace 。

yPosRoleReplace : string

该属性定义了与yPosRolePattern 一起使用的替换内容。默认为空字符串。有关使用正则表达式进行搜索和替换的工作原理，请参阅QString::replace(constQRegularExpression &rx, constQString &after) 函数文档。

另请参阅 yPosRole 和yPosRolePattern 。

zPosRole : string

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

zPosRolePattern : regExp

设置该属性后，将对 z-position 角色映射的值进行搜索和替换，然后再将其用作项目位置值。该属性指定正则表达式，用于查找要替换的映射值部分，而zPosRoleReplace 属性则包含替换字符串。

另请参阅 zPosRole 和zPosRoleReplace 。

zPosRoleReplace : string

该属性定义了与zPosRolePattern 一起使用的替换内容。默认为空字符串。有关使用正则表达式进行搜索和替换的工作原理，请参阅QString::replace(constQRegularExpression &rx, constQString &after) 函数文档。

另请参阅 zPosRole 和zPosRolePattern 。

信号文档

itemModelChanged(model itemModel)

当itemModel 更改为itemModel 时会发出该信号。

rotationRoleChanged(string role)

当rotationRole 更改为role 时会发出该信号。

rotationRolePatternChanged(regExp pattern)

当rotationRolePattern 更改为pattern 时会发出该信号。

rotationRoleReplaceChanged(string replace)

当rotationRoleReplace 更改为replace 时会发出该信号。

scaleRoleChanged(string role)

当scaleRole 更改为role 时会发出该信号。

scaleRolePatternChanged(regExp pattern)

当scaleRolePattern 更改为pattern 时会发出该信号。

scaleRoleReplaceChanged(string replace)

当scaleRoleReplace 更改为replace 时会发出该信号。

xPosRoleChanged(string role)

当xPosRole 更改为role 时会发出该信号。

xPosRolePatternChanged(regExp pattern)

当xPosRolePattern 更改为pattern 时会发出该信号。

xPosRoleReplaceChanged(string replace)

当xPosRoleReplace 更改为replace 时会发出该信号。

yPosRoleChanged(string role)

当yPosRole 更改为role 时会发出该信号。

yPosRolePatternChanged(regExp pattern)

当yPosRolePattern 更改为pattern 时会发出该信号。

yPosRoleReplaceChanged(string replace)

当yPosRoleReplace 更改为replace 时会发出该信号。

zPosRoleChanged(string role)

当zPosRole 更改为role 时会发出该信号。

zPosRolePatternChanged(regExp pattern)

当zPosRolePattern 更改为pattern 时会发出该信号。

zPosRoleReplaceChanged(string replace)

当zPosRoleReplace 更改为replace 时会发出该信号。