ItemModelBarDataProxy QML 类型

用于以 Bars3D 展示数据的代理类。更多...

导入声明	import QtGraphs
实例化	QItemModelBarDataProxy
继承	BarDataProxy
状态	技术预览

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

属性

autoColumnCategories : bool
autoRowCategories : bool
columnCategories : list
columnRole : string
columnRolePattern : regExp
columnRoleReplace : string
itemModel : model
multiMatchBehavior : enumeration
rotationRole : string
rotationRolePattern : regExp
rotationRoleReplace : string
rowCategories : list
rowRole : string
rowRolePattern : regExp
rowRoleReplace : string
useModelCategories : bool
valueRole : string
valueRolePattern : regExp
valueRoleReplace : string

详细描述

此类型允许您使用 AbstractItemModel 派生的模型作为 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: ["2020", "2021", "2022", "2023"]
    columnCategories: ["Oulu", "Rauma", "Helsinki", "Tampere"]
}

另请参阅 BarDataProxy 和 Qt 图表 3D 数据处理。

属性文档

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 : enumeration

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

例如，你可能有一个项模型，其中包含以不规则间隔记录的时间戳数据，并且你希望使用条形图可视化每天的数据项的总值。可以通过指定行和列类别来做到这一点，以便每个条形图表示一天，并将multiMatchBehavior设置为ItemModelBarDataProxy.MultiMatchBehavior.Cumulative。

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

当设置时，在用作条形图值之前将在值角色映射的值上执行搜索和替换。此属性指定用于查找要替换的映射值部分的正则表达式。

另请参阅valueRole和valueRoleReplace。

valueRoleReplace : string

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

另请参阅 valueRole 和 valueRolePattern。