ItemModelBarDataProxy QML 类型

用于在 item 模型中使用 Bars3D 展示数据的代理类。更多信息...

导入语句	import QtDataVisualization 1.7
自	QtDataVisualization 1.0
实例化	QItemModelBarDataProxy
继承自	BarDataProxy

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

属性

autoColumnCategories : bool
autoRowCategories : bool
columnCategories : 列表
columnRole : 字符串
columnRolePattern : 正则表达式
columnRoleReplace : 字符串
itemModel : 模型
multiMatchBehavior : ItemModelBarDataProxy.MultiMatchBehavior
rotationRole : 字符串
rotationRolePattern : 正则表达式
rotationRoleReplace : 字符串
rowCategories : 列表
rowRole : 字符串
rowRolePattern : 正则表达式
rowRoleReplace : 字符串
useModelCategories : bool
valueRole : 字符串
valueRolePattern : 正则表达式
valueRoleReplace : 字符串

详细描述

此类型允许您将抽象 ItemModel 派生模型作为 Bars3D 的数据源。

数据会在映射或模型变化时异步解析。当数据解析完成时，将发出 QBarDataProxy::arrayReset()。

有关 ItemModelBarDataProxy 枚举，请参阅 QItemModelBarDataProxy::MultiMatchBehavior。

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

使用示例

ItemModelBarDataProxy {
    itemModel: model // E.g. a list model defined elsewhere containing yearly expenses data.
    // Mapping model roles to bar series rows, columns, and values.
    rowRole: "year"
    columnRole: "city"
    valueRole: "expenses"
    rowCategories: ["2010", "2011", "2012", "2013"]
    columnCategories: ["Oulu", "Rauma", "Helsinki", "Tampere"]
}

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

属性说明

autoColumnCategories : bool

当设置为 true 时，映射忽略任何显式设置的列类别，并在从模型解析数据时自动覆盖它们。默认为 true。

autoRowCategories : bool

当设置为 true 时，映射忽略任何显式设置的行类别，并在从模型解析数据时自动覆盖它们。默认为 true。

columnCategories : list<String>

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

columnRole : string

映射到列类别的项模型角色。

columnRolePattern : regExp

当设置时，在用作列类别之前对通过列角色映射的值执行搜索和替换操作。此属性指定用于查找要替换的映射值部分的正则表达式，而 columnRoleReplace 属性包含替换字符串。这在从项模型中的单个时间戳字段解析行和列类别时很有用。

请参阅columnRole 和 columnRoleReplace。

columnRoleReplace : string

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

请参阅columnRole 和 columnRolePattern。

itemModel : model

项模型。

multiMatchBehavior : ItemModelBarDataProxy.MultiMatchBehavior

定义如何处理每个行/列组合的多个匹配。默认为 ItemModelBarDataProxy.MMBLast。所选行为会影响条形值和旋转。

例如，您可能有一个具有非规则间隔时间戳数据的项目模型，并想使用条形图可视化每天数据项的总值。这可以通过指定行和列类别来完成，使得每个条形代表一天，并将 multiMatchBehavior 设置为 ItemModelBarDataProxy.MMBCumulative。

rotationRole : string

映射到条形旋转角度的项模型角色。

rotationRolePattern : regExp

当设置时，在将其用作条形图旋转角度之前，会先对旋转角色映射的值进行搜索和替换。此属性指定正则表达式以查找要替换的映射值部分，而rotationRoleReplace属性包含替换字符串。

另请参阅rotationRole以及rotationRoleReplace。

rotationRoleReplace : string

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

另请参阅rotationRole和rotationRolePattern。

rowCategories : list<String>

映射的行类别。在解析数据时，只有在此列表中找到的具有行角色值的项被包括。行按照与列表中相同的顺序排列。

rowRole : string

要将行类别映射的项模型角色。

rowRolePattern : regExp

当设置时，在将其用作行类别之前，会对行角色映射的值进行搜索和替换。此属性指定正则表达式以查找要替换的映射值部分，而rowRoleReplace属性包含替换字符串。这在例如从项模型中的单个时间戳字段解析行和列类别时很有用。

另请参阅rowRole和rowRoleReplace。

rowRoleReplace : string

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

另请参阅rowRole和rowRolePattern。

useModelCategories : bool

当设置为true时，映射忽略行和列角色以及类别，而是使用模型中的行和列。使用行和列标题作为行和列标签。默认为false。

valueRole : string

要将值映射到条形图值的项模型角色。

valueRolePattern : regExp

当设置时，在将其用作条形图值之前，会对值角色映射的值进行搜索和替换。此属性指定正则表达式以查找要替换的映射值部分，而valueRoleReplace属性包含替换字符串。

也请参阅 valueRole 和 valueRoleReplace。

valueRoleReplace : string

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

也请参阅 valueRole 和 valueRolePattern。