// Copyright (C) 2016 The Qt Company Ltd. // SPDX-License-Identifier: LicenseRef-Qt-Commercial OR GPL-3.0-only #include #include QT_BEGIN_NAMESPACE /*! \class QVCandlestickModelMapper \since 5.8 \inmodule QtCharts \brief The QVCandlestickModelMapper class is a vertical 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 vertical model mapper is used to create a connection between a data model and QCandlestickSeries, so that each column in the data model defines a candlestick item and each row 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, QHCandlestickModelMapper */ /*! \qmltype VCandlestickModelMapper \since QtCharts 2.2 \instantiates QVCandlestickModelMapper \inqmlmodule QtCharts \brief Vertical 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 vertical model mapper is used to create a connection between a data model and CandlestickSeries, so that each column in the data model defines a candlestick item and each row 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 columns). Each candlestick item contains data defined by the timestamp, open, high, low, and close rows. The name of an item is defined by the horizontal header of the column. \qml CandlestickSeries { VCandlestickModelMapper { model: myCustomModel // QAbstractItemModel derived implementation timestampRow: 1 openRow: 2 highRow: 3 lowRow: 4 closeRow: 5 firstSetColumn: 1 lastSetColumn: 3 } } \endqml \sa CandlestickSeries, CandlestickSet, HCandlestickModelMapper */ /*! \qmlproperty QAbstractItemModel VCandlestickModelMapper::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 VCandlestickModelMapper::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 (but it preserves its data). */ /*! \property QVCandlestickModelMapper::timestampRow \brief The row of the model that contains the timestamp values of the candlestick items in the series. The default value is -1 (invalid mapping). */ /*! \qmlproperty int VCandlestickModelMapper::timestampRow The row of the model that contains the timestamp values of the candlestick items in the series. The default value is -1 (invalid mapping). */ /*! \property QVCandlestickModelMapper::openRow \brief The row of the model that contains the open values of the candlestick items in the series. The default value is -1 (invalid mapping). */ /*! \qmlproperty int VCandlestickModelMapper::openRow The row of the model that contains the open values of the candlestick items in the series. The default value is -1 (invalid mapping). */ /*! \property QVCandlestickModelMapper::highRow \brief The row of the model that contains the high values of the candlestick items in the series. The default value is -1 (invalid mapping). */ /*! \qmlproperty int VCandlestickModelMapper::highRow The row of the model that contains the high values of the candlestick items in the series. The default value is -1 (invalid mapping). */ /*! \property QVCandlestickModelMapper::lowRow \brief The row of the model that contains the low values of the candlestick items in the series. The default value is -1 (invalid mapping). */ /*! \qmlproperty int VCandlestickModelMapper::lowRow The row of the model that contains the low values of the candlestick items in the series. The default value is -1 (invalid mapping). */ /*! \property QVCandlestickModelMapper::closeRow \brief The row of the model that contains the close values of the candlestick items in the series. The default value is -1 (invalid mapping). */ /*! \qmlproperty int VCandlestickModelMapper::closeRow The row of the model that contains the close values of the candlestick items in the series. The default value is -1 (invalid mapping). */ /*! \property QVCandlestickModelMapper::firstSetColumn \brief The column of the model that is used as the data source for the first item. The default value is -1 (invalid mapping). */ /*! \qmlproperty int VCandlestickModelMapper::firstSetColumn The column of the model that is used as the data source for the first item. The default value is -1 (invalid mapping). */ /*! \property QVCandlestickModelMapper::lastSetColumn \brief The column of the model that is used as the data source for the last item. The default value is -1 (invalid mapping). */ /*! \qmlproperty int VCandlestickModelMapper::lastSetColumn The column of the model that is used as the data source for the last item. The default value is -1 (invalid mapping). */ /*! \fn void QVCandlestickModelMapper::timestampRowChanged() \brief Emitted when the row of the model that contains timestamp values is changed. \sa timestampRow */ /*! \fn void QVCandlestickModelMapper::openRowChanged() \brief Emitted when the row of the model that contains open values is changed. \sa openRow */ /*! \fn void QVCandlestickModelMapper::highRowChanged() \brief Emitted when the row of the model that contains high values is changed. \sa highRow */ /*! \fn void QVCandlestickModelMapper::lowRowChanged() \brief Emitted when the row of the model that contains low values is changed. \sa lowRow */ /*! \fn void QVCandlestickModelMapper::closeRowChanged() \brief Emitted when the row of the model that contains close values is changed. \sa closeRow */ /*! \fn void QVCandlestickModelMapper::firstSetColumnChanged() \brief Emitted when the column of the model that contains the data of the first item is changed. \sa firstSetColumn */ /*! \fn void QVCandlestickModelMapper::lastSetColumnChanged() \brief Emitted when the column of the model that contains the data of the last item is changed. \sa lastSetColumn */ /*! Constructs a vertical model mapper object which is a child of \a parent. */ QVCandlestickModelMapper::QVCandlestickModelMapper(QObject *parent) : QCandlestickModelMapper(parent) { connect(d_ptr, SIGNAL(timestampChanged()), this, SIGNAL(timestampRowChanged())); connect(d_ptr, SIGNAL(openChanged()), this, SIGNAL(openRowChanged())); connect(d_ptr, SIGNAL(highChanged()), this, SIGNAL(highRowChanged())); connect(d_ptr, SIGNAL(lowChanged()), this, SIGNAL(lowRowChanged())); connect(d_ptr, SIGNAL(closeChanged()), this, SIGNAL(closeRowChanged())); connect(d_ptr, SIGNAL(firstSetSectionChanged()), this, SIGNAL(firstSetColumnChanged())); connect(d_ptr, SIGNAL(lastSetSectionChanged()), this, SIGNAL(lastSetColumnChanged())); } /*! Returns Qt::Vertical. This means that values of the item are read from columns. */ Qt::Orientation QVCandlestickModelMapper::orientation() const { return Qt::Vertical; } void QVCandlestickModelMapper::setTimestampRow(int timestampRow) { QCandlestickModelMapper::setTimestamp(timestampRow); } int QVCandlestickModelMapper::timestampRow() const { return QCandlestickModelMapper::timestamp(); } void QVCandlestickModelMapper::setOpenRow(int openRow) { QCandlestickModelMapper::setOpen(openRow); } int QVCandlestickModelMapper::openRow() const { return QCandlestickModelMapper::open(); } void QVCandlestickModelMapper::setHighRow(int highRow) { QCandlestickModelMapper::setHigh(highRow); } int QVCandlestickModelMapper::highRow() const { return QCandlestickModelMapper::high(); } void QVCandlestickModelMapper::setLowRow(int lowRow) { QCandlestickModelMapper::setLow(lowRow); } int QVCandlestickModelMapper::lowRow() const { return QCandlestickModelMapper::low(); } void QVCandlestickModelMapper::setCloseRow(int closeRow) { QCandlestickModelMapper::setClose(closeRow); } int QVCandlestickModelMapper::closeRow() const { return QCandlestickModelMapper::close(); } void QVCandlestickModelMapper::setFirstSetColumn(int firstSetColumn) { QCandlestickModelMapper::setFirstSetSection(firstSetColumn); } int QVCandlestickModelMapper::firstSetColumn() const { return QCandlestickModelMapper::firstSetSection(); } void QVCandlestickModelMapper::setLastSetColumn(int lastSetColumn) { QCandlestickModelMapper::setLastSetSection(lastSetColumn); } int QVCandlestickModelMapper::lastSetColumn() const { return QCandlestickModelMapper::lastSetSection(); } QT_END_NAMESPACE #include "moc_qvcandlestickmodelmapper.cpp"