ItemModelBarDataProxy QML Type

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

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

属性

• autoColumnCategories : bool
• autoRowCategories : bool
• columnCategories : list<String>
• columnRole : string
• columnRolePattern : regExp
• columnRoleReplace : string
• itemModel : model
• multiMatchBehavior : enumeration
• rotationRole : string
• rotationRolePattern : regExp
• rotationRoleReplace : string
• rowCategories : list<String>
• rowRole : string
• rowRolePattern : regExp
• rowRoleReplace : string
• type : AbstractDataProxy.DataType
• useModelCategories : bool
• valueRole : string
• valueRolePattern : regExp
• valueRoleReplace : string

信号

• autoColumnCategoriesChanged(bool enable)
• autoRowCategoriesChanged(bool enable)
• columnCategoriesChanged()
• columnRoleChanged(string role)
• columnRolePatternChanged(regExp pattern)
• columnRoleReplaceChanged(string replace)
• itemModelChanged(model itemModel)
• multiMatchBehaviorChanged(enumeration behavior)
• rotationRoleChanged(string role)
• rotationRolePatternChanged(regExp pattern)
• rotationRoleReplaceChanged(string replace)
• rowCategoriesChanged()
• rowRoleChanged(string role)
• rowRolePatternChanged(regExp pattern)
• rowRoleReplaceChanged(string replace)
• useModelCategoriesChanged(bool enable)
• valueRoleChanged(string role)
• valueRolePatternChanged(regExp pattern)
• valueRoleReplaceChanged(string replace)

详细描述

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

属性文档

autoColumnCategories : bool

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

autoRowCategories : bool

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

columnCategories : list<String>

映射的列类别。在解析数据时，只有列角色值在此列表中的项目才会包含在内。列的顺序与此列表中的顺序相同。

columnRole : string

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

columnRolePattern : regExp

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

另请参阅 columnRole 和columnRoleReplace 。

columnRoleReplace : string

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

另请参阅 rotationRole 和rotationRolePattern 。

rowCategories : list<String>

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

rowRole : string

要映射到行类别中的项目模型角色。

rowRolePattern : regExp

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

另请参阅 rowRole 和rowRoleReplace 。

rowRoleReplace : string

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

另请参阅 rowRole 和rowRolePattern 。

type : AbstractDataProxy.DataType [read-only]

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

useModelCategories : bool

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

valueRole : string

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

valueRolePattern : regExp

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

另请参阅 valueRole 和valueRoleReplace 。

valueRoleReplace : string

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

另请参阅 valueRole 和valueRolePattern 。

信号文档

autoColumnCategoriesChanged(bool enable)

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

autoRowCategoriesChanged(bool enable)

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

columnCategoriesChanged()

columnCategories 发生变化时会发出该信号。

columnRoleChanged(string role)

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

columnRolePatternChanged(regExp pattern)

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

columnRoleReplaceChanged(string replace)

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

itemModelChanged(model itemModel)

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

multiMatchBehaviorChanged(enumeration behavior)

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

rotationRoleChanged(string role)

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

rotationRolePatternChanged(regExp pattern)

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

rotationRoleReplaceChanged(string replace)

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

rowCategoriesChanged()

rowCategories 发生变化时会发出该信号。

rowRoleChanged(string role)

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

rowRolePatternChanged(regExp pattern)

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

rowRoleReplaceChanged(string replace)

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

useModelCategoriesChanged(bool enable)

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

valueRoleChanged(string role)

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

valueRolePatternChanged(regExp pattern)

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

valueRoleReplaceChanged(string replace)

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