// Copyright (C) 2016 The Qt Company Ltd. // SPDX-License-Identifier: LicenseRef-Qt-Commercial OR GPL-3.0-only #include #include QT_BEGIN_NAMESPACE /*! \class QHCandlestickModelMapper \since 5.8 \inmodule QtCharts \brief The QHCandlestickModelMapper class is a horizontal model mapper for a candlestick series. 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 data model and QCandlestickSeries, so that each row in the data model defines a candlestick item and each column maps to the open, high, low, close, and timestamp values of the candlestick item. Both model and candlestick series properties can be used to manipulate the data. The model mapper keeps the candlestick series and the data model in sync. The model mapper ensures that all the candlestick items in the candlestick series have equal sizes. Therefore, adding or removing a value from a candlestick item causes the same change to be made in all the candlestick items in the candlestick series. \sa QCandlestickSeries, QCandlestickSet, QVCandlestickModelMapper */ /*! \qmltype HCandlestickModelMapper \since QtCharts 2.2 \instantiates QHCandlestickModelMapper \inqmlmodule QtCharts \brief Horizontal model mapper for a candlestick series. 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 data model and CandlestickSeries, so that each row in the data model defines a candlestick item and each column maps to the open, high, low, close, and timestamp values of the candlestick item. Both model and candlestick series properties can be used to manipulate the data. The model mapper keeps the candlestick series and the data model in sync. The model mapper ensures that all the candlestick items in the candlestick series have equal sizes. Therefore, adding or removing a value from a candlestick item causes the same change to be made in all the candlestick items in the candlestick series. The following QML example creates a candlestick series with three candlestick items (assuming the model has at least four rows). Each candlestick item contains data defined by the timestamp, open, high, low, and close columns. The name of an item is defined by the vertical header of the row. \qml CandlestickSeries { HCandlestickModelMapper { model: myCustomModel // QAbstractItemModel derived implementation timestampColumn: 1 openColumn: 2 highColumn: 3 lowColumn: 4 closeColumn: 5 firstSetRow: 1 lastSetRow: 3 } } \endqml \sa CandlestickSeries, CandlestickSet, VCandlestickModelMapper */ /*! \qmlproperty QAbstractItemModel HCandlestickModelMapper::model The QAbstractItemModel-based model that is used by the mapper. The model must be implemented and exposed to QML. \note The model used must support adding and removing rows or columns and modifying the data of the cells. */ /*! \qmlproperty CandlestickSeries HCandlestickModelMapper::series The CandlestickSeries based object 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 (preserving its data). */ /*! \property QHCandlestickModelMapper::timestampColumn \brief The column of the model that contains the timestamp values of the candlestick items in the series. The default value is -1 (invalid mapping). */ /*! \qmlproperty int HCandlestickModelMapper::timestampColumn The column of the model that contains the timestamp values of the candlestick items in the series. The default value is -1 (invalid mapping). */ /*! \property QHCandlestickModelMapper::openColumn \brief The column of the model that contains the open values of the candlestick items in the series. The default value is -1 (invalid mapping). */ /*! \qmlproperty int HCandlestickModelMapper::openColumn The column of the model that contains the open values of the candlestick items in the series. The default value is -1 (invalid mapping). */ /*! \property QHCandlestickModelMapper::highColumn \brief The column of the model that contains the high values of the candlestick items in the series. The default value is -1 (invalid mapping). */ /*! \qmlproperty int HCandlestickModelMapper::highColumn The column of the model that contains the high values of the candlestick items in the series. The default value is -1 (invalid mapping). */ /*! \property QHCandlestickModelMapper::lowColumn \brief The column of the model that contains the low values of the candlestick items in the series. The default value is -1 (invalid mapping). */ /*! \qmlproperty int HCandlestickModelMapper::lowColumn The column of the model that contains the low values of the candlestick items in the series. The default value is -1 (invalid mapping). */ /*! \property QHCandlestickModelMapper::closeColumn \brief The column of the model that contains the close values of the candlestick items in the series. The default value is -1 (invalid mapping). */ /*! \qmlproperty int HCandlestickModelMapper::closeColumn The column of the model that contains the close values of the candlestick items in the series. The default value is -1 (invalid mapping). */ /*! \property QHCandlestickModelMapper::firstSetRow \brief The row of the model that is used as the data source for the first item. The default value is -1 (invalid mapping). */ /*! \qmlproperty int HCandlestickModelMapper::firstSetRow The row of the model that is used as the data source for the first item. The default value is -1 (invalid mapping). */ /*! \property QHCandlestickModelMapper::lastSetRow \brief The row of the model that is used as the data source for the last item. The default value is -1 (invalid mapping). */ /*! \qmlproperty int HCandlestickModelMapper::lastSetRow The row of the model that is used as the data source for the last item. The default value is -1 (invalid mapping). */ /*! \fn void QHCandlestickModelMapper::timestampColumnChanged() \brief Emitted when the column of the model that contains timestamp values is changed \sa timestampColumn */ /*! \fn void QHCandlestickModelMapper::openColumnChanged() \brief Emitted when the column of the model that contains open values is changed. \sa openColumn */ /*! \fn void QHCandlestickModelMapper::highColumnChanged() \brief Emitted when the column of the model that contains high values is changed. \sa highColumn */ /*! \fn void QHCandlestickModelMapper::lowColumnChanged() \brief Emitted when the column of the model that contains low values is changed. \sa lowColumn */ /*! \fn void QHCandlestickModelMapper::closeColumnChanged() \brief Emitted when the column of the model that contains close values is changed. \sa closeColumn */ /*! \fn void QHCandlestickModelMapper::firstSetRowChanged() \brief Emitted when the row of the model that contains the data of the first item is changed. \sa firstSetRow */ /*! \fn void QHCandlestickModelMapper::lastSetRowChanged() \brief Emitted when the row of the model that contains the data of the last item is changed. \sa lastSetRow */ /*! Constructs a horizontal model mapper object which is a child of \a parent. */ QHCandlestickModelMapper::QHCandlestickModelMapper(QObject *parent) : QCandlestickModelMapper(parent) { connect(d_ptr, SIGNAL(timestampChanged()), this, SIGNAL(timestampColumnChanged())); connect(d_ptr, SIGNAL(openChanged()), this, SIGNAL(openColumnChanged())); connect(d_ptr, SIGNAL(highChanged()), this, SIGNAL(highColumnChanged())); connect(d_ptr, SIGNAL(lowChanged()), this, SIGNAL(lowColumnChanged())); connect(d_ptr, SIGNAL(closeChanged()), this, SIGNAL(closeColumnChanged())); connect(d_ptr, SIGNAL(firstSetSectionChanged()), this, SIGNAL(firstSetRowChanged())); connect(d_ptr, SIGNAL(lastSetSectionChanged()), this, SIGNAL(lastSetRowChanged())); } /*! Returns Qt::Horizontal. This means that values of the item are read from rows. */ Qt::Orientation QHCandlestickModelMapper::orientation() const { return Qt::Horizontal; } void QHCandlestickModelMapper::setTimestampColumn(int timestampColumn) { QCandlestickModelMapper::setTimestamp(timestampColumn); } int QHCandlestickModelMapper::timestampColumn() const { return QCandlestickModelMapper::timestamp(); } void QHCandlestickModelMapper::setOpenColumn(int openColumn) { QCandlestickModelMapper::setOpen(openColumn); } int QHCandlestickModelMapper::openColumn() const { return QCandlestickModelMapper::open(); } void QHCandlestickModelMapper::setHighColumn(int highColumn) { QCandlestickModelMapper::setHigh(highColumn); } int QHCandlestickModelMapper::highColumn() const { return QCandlestickModelMapper::high(); } void QHCandlestickModelMapper::setLowColumn(int lowColumn) { QCandlestickModelMapper::setLow(lowColumn); } int QHCandlestickModelMapper::lowColumn() const { return QCandlestickModelMapper::low(); } void QHCandlestickModelMapper::setCloseColumn(int closeColumn) { QCandlestickModelMapper::setClose(closeColumn); } int QHCandlestickModelMapper::closeColumn() const { return QCandlestickModelMapper::close(); } void QHCandlestickModelMapper::setFirstSetRow(int firstSetRow) { QCandlestickModelMapper::setFirstSetSection(firstSetRow); } int QHCandlestickModelMapper::firstSetRow() const { return QCandlestickModelMapper::firstSetSection(); } void QHCandlestickModelMapper::setLastSetRow(int lastSetRow) { QCandlestickModelMapper::setLastSetSection(lastSetRow); } int QHCandlestickModelMapper::lastSetRow() const { return QCandlestickModelMapper::lastSetSection(); } QT_END_NAMESPACE #include "moc_qhcandlestickmodelmapper.cpp"