ItemModelSurfaceDataProxy QML类型

用于在项模型中使用Surface3D展示数据的代理类。更多...

导入语句	import QtDataVisualization 1.7
自	QtDataVisualization 1.0
实例化	QItemModelSurfaceDataProxy
继承	SurfaceDataProxy

所有成员列表，包括继承成员

属性

autoColumnCategories : bool
autoRowCategories : bool
columnCategories : list
columnRole : string
columnRolePattern : regExp
columnRoleReplace : string
itemModel : model
multiMatchBehavior : ItemModelSurfaceDataProxy.MultiMatchBehavior
rowCategories : list
rowRole : string
rowRolePattern : regExp
rowRoleReplace : string
useModelCategories : bool
xPosRole : string
xPosRolePattern : regExp
xPosRoleReplace : string
yPosRole : string
yPosRolePattern : regExp
yPosRoleReplace : string
zPosRole : string
zPosRolePattern : regExp
zPosRoleReplace : string

详细描述

此类型允许您使用从Surface3D派生的模型作为数据源。

数据在映射或模型更改时异步解析。

有关ItemModelSurfaceDataProxy枚举，请参阅QItemModelSurfaceDataProxy::MultiMatchBehavior。

有关更多详细信息，请参阅QItemModelSurfaceDataProxy文档。

使用示例

ItemModelSurfaceDataProxy {
    itemModel: model // E.g. a list model defined elsewhere containing population data.
    // Mapping model roles to surface series rows, columns, and values.
    rowRole: "longitude"
    columnRole: "latitude"
    valueRole: "pop_density"
}

另请参阅 SurfaceDataProxy 和 Qt 数据可视化数据处理。

属性文档

autoColumnCategories : bool

当设置为 true 时，映射将忽略任何显式设置的列类别，并在解析模型数据时用自动生成的类别覆盖它们。当设置为 true 时，也自动从数据中生成代理的最小和最大列值。默认为 true。

autoRowCategories : bool

当设置为 true 时，映射将忽略任何显式设置的行类别，并在解析模型数据时用自动生成的类别覆盖它们。当设置为 true 时，也自动从数据中生成代理的最小和最大行值。默认为 true。

columnCategories : list<String>

映射的列类别。在解析数据时，仅包含在此列表中找到的列角色项。列的顺序与列表中的顺序相同。

columnRole : string

将映射到列类别的项模型角色。除了定义数据属于哪个列外，由列角色指示的值还设置为 QSurfaceDataItem 的 X 坐标值，除非还定义了一个单独的 X 位置角色。

columnRolePattern : regExp

当设置时，在用作列类别之前，会对通过列角色映射的值进行搜索和替换。此属性指定用于查找要替换的映射值的正则表达式，而 columnRoleReplace 属性包含替换字符串。

另请参阅 columnRole 和 columnRoleReplace。

columnRoleReplace : string

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

另请参阅 columnRole 和 columnRolePattern。

itemModel : model

用作 Surface3D 数据源的项模型。

multiMatchBehavior : ItemModelSurfaceDataProxy.MultiMatchBehavior

定义如何处理每行/每列组合的多个匹配。默认为 ItemModelSurfaceDataProxy.MMBLast。

例如，您可能有一个具有不定期间隔的时间戳数据的项模型，并希望使用表面图表可视化每小时数据项的平均位置。这可以通过指定行和列类别来实现，以便每个表面点代表一小时，并将 multiMatchBehavior 设置为 ItemModelSurfaceDataProxy.MMBAverage。

rowCategories : list<String>

映射的行类别。只有在此列表中找到的具有行角色的项才包含在数据处理中。行的顺序与列表中的顺序相同。

rowRole : string

将映射到行类别的项模型角色。除了定义数据属于哪一行外，当模型数据解析时，行角色指示的值也设置为QSurfaceDataItem的Z坐标值，除非还定义了单独的Z位置角色。

rowRolePattern : regExp

设置后，在用作行类别之前对行角色映射的值执行搜索和替换。此属性指定要查找用于替换的映射值的部分的正则表达式，而rowRoleReplace属性包含替换字符串。

另请参阅rowRole和rowRoleReplace。

rowRoleReplace : string

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

另请参阅rowRole和rowRolePattern。

useModelCategories : bool

当设置为true时，映射忽略行和列角色和类别，并使用来自模型的行和列。默认为false。

xPosRole : string

将映射到X位置的项模型角色。如果此角色未定义，则使用columnRole来确定解析的QSurfaceDataItem项的X坐标值。

xPosRolePattern : regExp

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

另请参阅xPosRole和xPosRoleReplace。

xPosRoleReplace : string

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

另请参阅xPosRole和xPosRolePattern。

yPosRole : string

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

yPosRolePattern : 正则表达式

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

另请参阅 yPosRole 和 yPosRoleReplace。

yPosRoleReplace : 字符串

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

另请参阅 yPosRole 和 yPosRolePattern。

zPosRole : 字符串

将映射到 Z 位置的项模型角色。如果此角色未定义，则使用 rowRole 来确定解析的 QSurfaceDataItem 项的 Z 坐标值。

zPosRolePattern : 正则表达式

当设置时，在用作项目位置值之前，对映射到 Z 位置角色的值进行搜索和替换。此属性指定用于替换映射值部分的正则表达式，而 zPosRoleReplace 属性包含替换字符串。

另请参阅 zPosRole 和 zPosRoleReplace。

zPosRoleReplace : 字符串

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

另请参阅 zPosRole 和 zPosRolePattern。