- Qt 6.8
- Qt Charts
- QML Types
- HXYModelMapper
- Qt Charts | Commercial or GPLv3

# HXYModelMapper QML Type

A horizontal model mapper for XYSeries. More...

Import Statement: | `import QtCharts 2.8`
In C++: | QHXYModelMapper

- List of all members, including inherited members

## Properties

- columnCount : int
- firstColumn : int
- model : SomeModel
- series : XYSeries
- xRow : int
- yRow : int

## Detailed Description

Model mappers enable using a data model derived from the QAbstractItemModel class as a data source for a chart. A horizontal model mapper is used to create a connection between a line, spline, or scatter series and the data model that has X and Y rows for the coordinates and holds the data points for the XYSeries as columns. A TableModel is a natural choice for the model.

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

See also VXYModelMapper, XYSeries, and Charts with Widgets Gallery.

## Property Documentation

columnCount : int

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

firstColumn : int

The column of the model that contains the data for the first point of the series. The default value is 0.

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.

series : XYSeries

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

xRow : int

The row of the model that contains the x-coordinates of the data points. The default value is -1 (invalid mapping).

yRow : int

The row of the model that contains the y-coordinates of the data points.

The default value is -1 (invalid mapping).