VBarModelMapper QML Type

Vertical model mapper for bar series. More...

Import Statement: import QtCharts 2.15
Instantiates: QVBarModelMapper

Properties

Detailed Description

The VBarModelMapper type enables using a data model derived from the QAbstractItemModel class as a data source for a chart. A vertical model mapper is used to create a connection between a data model and QAbstractBarSeries, so that each column in the data model defines a bar set and each row maps to a category in a bar series. You need to implement the data model and expose it to QML.

Both model and bar series properties can be used to manipulate the data. The model mapper keeps the bar series and the data model in sync.

The model mapper ensures that all the bar sets in the bar series have equal sizes. Therefore, adding or removing a value from a bar set causes the same change to be made in all the bar sets in the bar series.

The following QML code snippet creates a bar series with three bar sets (assuming the model has at least four columns). Each bar set contains data starting from row 1. The name of a bar set is defined by the column header.

BarSeries {
    VBarModelMapper {
        model: myCustomModel // QAbstractItemModel derived implementation
        firstBarSetColumn: 1
        lastBarSetColumn: 3
        firstRow: 1
    }
}

See also HBarModelMapper.

Property Documentation

firstBarSetColumn : int

The column of the model that is used as the data source for the first bar set. The default value is -1 (invalid mapping).


firstRow : int

The row of the model that contains the first values of the bar sets in the bar series. The default value is 0.


lastBarSetColumn : int

The column of the model that is used as the data source for the last bar set. The default value is -1 (invalid mapping).


model : SomeModel

The data model that is used by the mapper. You need to implement the model and expose it to QML.

Note: The model has to support adding and removing rows or columns and modifying the data in the cells.


rowCount : int

The number of rows of the model that are mapped as the data for the bar series. The default value is -1 (number limited to the number of rows in the model).


The bar series that is used by the mapper. All the data in the series is discarded when it is set to the mapper. When the new series is specified, the old series is disconnected (but it preserves its data).


© 2023 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.