PySide6.QtGraphs.QItemModelScatterDataProxy¶

class QItemModelScatterDataProxy¶

用于在项目模型中展示数据的代理类，使用Q3DScatterWidgetItem。更多…

概要¶

属性¶

itemModelᅟ - 用作3D散点系列数据源的项模型
rotationRoleᅟ - 将项目模型角色映射到项目旋转
rotationRolePatternᅟ - 在使用映射的旋转角色值之前，是否对其执行搜索和替换操作
rotationRoleReplaceᅟ - 替换内容以与轮换角色模式结合使用
xPosRoleᅟ - 项目模型角色映射到X位置
xPosRolePatternᅟ - 在使用x位置角色映射的值作为项目位置值之前，是否对其进行搜索和替换
xPosRoleReplaceᅟ - 替换内容以与x位置角色模式结合使用
yPosRoleᅟ - 项目模型角色映射到Y位置
yPosRolePatternᅟ - 是否在将y位置角色映射的值用作项目位置值之前对其进行搜索和替换
yPosRoleReplaceᅟ - 替换内容以与y位置角色模式一起使用
zPosRoleᅟ - 项目模型角色映射到Z位置
zPosRolePatternᅟ - 在使用z位置角色映射的值作为项目位置值之前，是否对其执行搜索和替换操作
zPosRoleReplaceᅟ - 替换内容以与z位置角色模式结合使用

方法¶

def __init__()
def itemModel()
def remap()
def rotationRole()
def rotationRolePattern()
def rotationRoleReplace()
def setItemModel()
def setRotationRole()
def setRotationRolePattern()
def setRotationRoleReplace()
def setXPosRole()
def setXPosRolePattern()
def setXPosRoleReplace()
def setYPosRole()
def setYPosRolePattern()
def setYPosRoleReplace()
def setZPosRole()
def setZPosRolePattern()
def setZPosRoleReplace()
def xPosRole()
def xPosRolePattern()
def xPosRoleReplace()
def yPosRole()
def yPosRolePattern()
def yPosRoleReplace()
def zPosRole()
def zPosRolePattern()
def zPosRoleReplace()

注意

本文档可能包含从C++自动翻译到Python的代码片段。我们始终欢迎对代码片段翻译的贡献。如果您发现翻译问题，您也可以通过在我们的https:/bugreports.qt.io/projects/PYSIDE上创建工单来告知我们。

详细描述¶

警告

本节包含从C++自动翻译到Python的代码片段，可能包含错误。

QItemModelScatterDataProxy 允许你使用 QAbstractItemModel 派生模型作为 Q3DScatterWidgetItem 的数据源。它将 QAbstractItemModel 的角色映射到 Q3DScatterWidgetItem 点的 XYZ 值。

每当映射或模型发生变化时，数据都会异步解析。当数据解析完成时，会发出arrayReset()。然而，在模型初始化之后的插入、删除和单个数据项更改是同步解析的，除非同一帧中还包含导致整个模型重新解析的更改。

映射忽略QAbstractItemModel的行和列，并平等对待所有项目。它要求模型为数据项提供可以映射到散点图的X、Y和Z值的角色。

例如，假设您有一个自定义的QAbstractItemModel，用于存储对材料样本进行的各种测量，提供诸如“密度”、“硬度”和“导电性”等角色的数据。您可以使用此代理在散点图上可视化这些属性：

# Map "density" value to X-axis, "hardness" to Y-axis and "conductivity" to Z-axis.
proxy = QItemModelScatterDataProxy(customModel,()
                                                                   "density",
                                                                   "hardness",
                                                                   "conductivity")

如果模型的字段不包含您所需的确切格式的数据，您可以为每个角色指定一个搜索模式正则表达式和一个替换规则，以获取所需格式的值。有关如何使用正则表达式进行替换的更多信息，请参阅QString::replace(const QRegularExpression ℞, const QString &after)函数文档。请注意，使用正则表达式会影响性能，因此在不需要进行搜索和替换即可获得所需值的情况下，使用项模型更为高效。

例如，关于将搜索模式与角色结合使用的示例，请参见ItemModelBarDataProxy在简单条形图中的用法。

另请参阅

使用3D处理Qt图形数据

注意

当使用from __feature__ import true_property时，属性可以直接使用，否则通过访问器函数使用。

property itemModelᅟ: QAbstractItemModel¶

此属性保存用作3D散点系列数据源的项模型。

Access functions:

itemModel()
setItemModel()
信号 itemModelChanged()

property rotationRoleᅟ: str¶

此属性保存要映射到项目旋转的项目模型角色。

模型可以为旋转提供值，该值可以是直接可转换为QQuaternion的变体，也可以是以下字符串表示之一："scalar,x,y,z" 或 "@angle,x,y,z"。第一种将直接使用给定的值构造四元数，第二种将使用QQuaternion::fromAxisAndAngle()方法构造四元数。

Access functions:

rotationRole()
setRotationRole()
信号 rotationRoleChanged()

property rotationRolePatternᅟ: QRegularExpression¶

此属性保存是否在将旋转角色映射的值用作项目旋转之前对其进行搜索和替换。

此属性指定用于查找要替换的映射值部分的正则表达式，而rotationRoleReplace属性包含替换字符串。

另请参阅

rotationRole rotationRoleReplace

Access functions:

rotationRolePattern()
setRotationRolePattern()
信号 rotationRolePatternChanged()

property rotationRoleReplaceᅟ: str¶

此属性保存与旋转角色模式一起使用的替换内容。

默认为空字符串。有关如何使用正则表达式进行搜索和替换的更多信息，请参阅 QString::replace(const QRegularExpression ℞, const QString &after) 函数文档。

另请参阅

rotationRole rotationRolePattern

Access functions:

rotationRoleReplace()
setRotationRoleReplace()
信号 rotationRoleReplaceChanged()

property xPosRoleᅟ: str¶

此属性保存要映射到X位置的项模型角色。

Access functions:

xPosRole()
setXPosRole()
信号 xPosRoleChanged()

property xPosRolePatternᅟ: QRegularExpression¶

此属性保存是否在将x位置角色映射的值用作项目位置值之前进行搜索和替换。

此属性指定用于查找要替换的映射值部分的正则表达式，而xPosRoleReplace属性包含替换字符串。

另请参阅

xPosRole xPosRoleReplace

Access functions:

xPosRolePattern()
setXPosRolePattern()
信号 xPosRolePatternChanged()

property xPosRoleReplaceᅟ: str¶

此属性保存与x位置角色模式一起使用的替换内容。

默认为空字符串。有关如何使用正则表达式进行搜索和替换的更多信息，请参阅 QString::replace(const QRegularExpression ℞, const QString &after) 函数文档。

另请参阅

xPosRole xPosRolePattern

Access functions:

xPosRoleReplace()
setXPosRoleReplace()
信号 xPosRoleReplaceChanged()

property yPosRoleᅟ: str¶

此属性保存要映射到Y位置的项模型角色。

Access functions:

yPosRole()
setYPosRole()
信号 yPosRoleChanged()

property yPosRolePatternᅟ: QRegularExpression¶

此属性保存是否在将y位置角色映射的值用作项目位置值之前对其进行搜索和替换。

此属性指定用于查找要替换的映射值部分的正则表达式，而yPosRoleReplace属性包含替换字符串。

另请参阅

yPosRole yPosRoleReplace

Access functions:

yPosRolePattern()
setYPosRolePattern()
信号 yPosRolePatternChanged()

property yPosRoleReplaceᅟ: str¶

此属性保存与y位置角色模式一起使用的替换内容。

默认为空字符串。有关如何使用正则表达式进行搜索和替换的更多信息，请参阅 QString::replace(const QRegularExpression ℞, const QString &after) 函数文档。

另请参阅

yPosRole yPosRolePattern

Access functions:

yPosRoleReplace()
setYPosRoleReplace()
信号 yPosRoleReplaceChanged()

property zPosRoleᅟ: str¶

此属性保存要映射到Z位置的项模型角色。

Access functions:

zPosRole()
setZPosRole()
信号 zPosRoleChanged()

property zPosRolePatternᅟ: QRegularExpression¶

此属性保存是否在将z位置角色映射的值用作项目位置值之前对其进行搜索和替换。

此属性指定用于查找要替换的映射值部分的正则表达式，而zPosRoleReplace属性包含替换字符串。

另请参阅

zPosRole zPosRoleReplace

Access functions:

zPosRolePattern()
setZPosRolePattern()
信号 zPosRolePatternChanged()

property zPosRoleReplaceᅟ: str¶

此属性保存与z位置角色模式一起使用的替换内容。

默认为空字符串。有关如何使用正则表达式进行搜索和替换的更多信息，请参阅 QString::replace(const QRegularExpression ℞, const QString &after) 函数文档。

另请参阅

zPosRole zPosRolePattern

Access functions:

zPosRoleReplace()
setZPosRoleReplace()
信号 zPosRoleReplaceChanged()

__init__([parent=None])¶

Parameters:: 父对象 – QObject

使用可选的parent构造QItemModelScatterDataProxy。

__init__(itemModel[, parent=None])

Parameters:

itemModel – QAbstractItemModel
parent – QObject

使用itemModel和一个可选的parent构造QItemModelScatterDataProxy。代理不会获取itemModel的所有权，因为通常项目模型由其他控件拥有。

__init__(itemModel, xPosRole, yPosRole, zPosRole[, parent=None])

Parameters:

itemModel – QAbstractItemModel
xPosRole – str
yPosRole – str
zPosRole – str
parent – QObject

使用itemModel和一个可选的parent构造QItemModelScatterDataProxy。代理不会获取itemModel的所有权，因为项目模型通常由其他控件拥有。xPosRole属性设置为xPosRole，yPosRole属性设置为yPosRole，zPosRole属性设置为zPosRole。