Revision control
++ // Copyright (C) 2016 The Qt Company Ltd.
++ // SPDX-License-Identifier: LicenseRef-Qt-Commercial OR GPL-3.0-only
++
++ #include <QtCharts/QHCandlestickModelMapper>
++ #include <private/qcandlestickmodelmapper_p.h>
++
++ 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
++ \nativetype 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"