HBarModelMapper QML Type

用于柱形系列的水平模型映射器。更多...

此类型已弃用。我们强烈建议不要在新代码中使用它。

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

属性

• columnCount : int
• firstBarSetRow : int
• firstColumn : int
• lastBarSetRow : int
• model : SomeModel
• series : AbstractBarSeries

详细说明

HBarModelMapper 类型允许将从QAbstractItemModel 类派生的数据模型用作图表的数据源。水平模型映射器用于在数据模型与AbstractBarSeries 之间建立连接，使得数据模型中的每一行定义一组柱形，每一列则映射到柱形序列中的一个类别。 您需要实现该数据模型，并将其暴露给 QML。

既可以使用模型属性，也可以使用条形系列属性来操作数据。模型映射器会保持条形系列与数据模型之间的同步。

模型映射器确保条形系列中的所有条形集大小相等。因此，向某个条形集添加或移除一个值，会导致条形系列中的所有条形集发生相同的变更。

以下 QML 代码片段创建了一个包含三个条形集的条形图系列（假设模型至少有四行）。每个条形集包含从第 1 列开始的数据。条形集的名称由行标题定义。

BarSeries {
    HBarModelMapper {
        model: myCustomModel // QAbstractItemModel derived implementation
        firstBarSetRow: 1
        lastBarSetRow: 3
        firstColumn: 1
    }
}

另请参阅 VBarModelMapper 。

属性文档

columnCount : int

模型中作为柱形图数据映射的列数。默认值为 -1（数量上限为模型中的列数）。

firstBarSetRow : int

指定模型中的哪一行用作第一个条形图集的数据源。默认值为 -1（无效映射）。

firstColumn : int

模型中包含柱形图系列中各柱形组的首个值的列。默认值为 0。

lastBarSetRow : int

用作最后一个柱状图集数据源的模型行。默认值为 -1（映射无效）。

model : SomeModel

映射器所使用的数据模型。您需要实现该模型，并将其暴露给 QML。

series : AbstractBarSeries

映射器使用的条形图系列。当该系列被设置为映射器时，其中的所有数据都会被丢弃。指定新系列后，旧系列将被断开连接（但其数据仍会被保留）。