Back to Doc.qt.io
Contact Us Blog Download Qt

XYModelMapper QML Type

A model mapper for XYSeries. More...

Import Statement: import QtGraphs
In C++: QXYModelMapper

Properties

Signals

Detailed Description

Model mappers enable using a data model derived from the QAbstractItemModel class as a data source for a graph. A model mapper is used to create a connection between a line, spline, or scatter series. 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 XYSeries.

Property Documentation

count : qsizetype

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

See also orientation.


first : qsizetype

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

See also orientation.


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.


orientation : orientation

Tells the modelmapper how to map data from a model. If Qt.Vertical is used, the model has X and Y columns, and the model's rows define the data points. When the orientation is set to Qt.Horizontal, the model has X and Y rows, and the model's columns define the data points.


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).


xSection : qsizetype

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

See also orientation.


ySection : qsizetype

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

See also orientation.


Signal Documentation

countChanged()

This signal is emitted when the number of rows changes.

Note: The corresponding handler is onCountChanged.


firstChanged()

This signal is emitted when the first row changes.

Note: The corresponding handler is onFirstChanged.


modelChanged()

This signal is emitted when the model that the mapper is connected to changes.

Note: The corresponding handler is onModelChanged.


xSectionChanged()

This signal is emitted when the section that contains the x-coordinates of data points changes.

Note: The corresponding handler is onXSectionChanged.


ySectionChanged()

This signal is emitted when the section that contains the y-coordinates of data points changes.

Note: The corresponding handler is onYSectionChanged.


© 2024 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.