qabstractseries.cpp
245 lines
| 5.5 KiB
| text/x-c
|
CppLexer
/ src / qabstractseries.cpp
Jani Honkonen
|
r794 | /**************************************************************************** | ||
| ** | ||||
| ** Copyright (C) 2012 Digia Plc | ||||
| ** All rights reserved. | ||||
| ** For any questions to Digia, please use contact form at http://qt.digia.com | ||||
| ** | ||||
| ** This file is part of the Qt Commercial Charts Add-on. | ||||
| ** | ||||
| ** $QT_BEGIN_LICENSE$ | ||||
| ** Licensees holding valid Qt Commercial licenses may use this file in | ||||
| ** accordance with the Qt Commercial License Agreement provided with the | ||||
| ** Software or, alternatively, in accordance with the terms contained in | ||||
| ** a written agreement between you and Digia. | ||||
| ** | ||||
| ** If you have questions regarding the use of this file, please use | ||||
| ** contact form at http://qt.digia.com | ||||
| ** $QT_END_LICENSE$ | ||||
| ** | ||||
| ****************************************************************************/ | ||||
Tero Ahola
|
r988 | #include "qabstractseries.h" | ||
| #include "qabstractseries_p.h" | ||||
Michal Klocek
|
r1062 | #include "chartdataset_p.h" | ||
|
Michal Klocek
|
r938 | |||
| QTCOMMERCIALCHART_BEGIN_NAMESPACE | ||||
sauimone
|
r62 | |||
|
Tero Ahola
|
r309 | /*! | ||
|
Tero Ahola
|
r988 | \class QAbstractSeries | ||
|
Tero Ahola
|
r309 | \brief Base class for all QtCommercial Chart series. | ||
| \mainclass | ||||
|
Tero Ahola
|
r310 | |||
| Usually you use the series type specific inherited classes instead of the base class. | ||||
|
sauimone
|
r1586 | \sa QXYSeries, QLineSeries, QSplineSeries, QScatterSeries, QAreaSeries, QAbstractBarSeries, QStackedBarSeries, | ||
|
Tero Ahola
|
r973 | QPercentBarSeries, QPieSeries | ||
|
Tero Ahola
|
r309 | */ | ||
|
Tero Ahola
|
r1521 | /*! | ||
| \qmlclass AbstractSeries | ||||
| AbstractSeries is the base class for all series. | ||||
| The class cannot be instantiated by the user. | ||||
| */ | ||||
|
Tero Ahola
|
r309 | |||
| /*! | ||||
|
Michal Klocek
|
r1107 | \enum QAbstractSeries::SeriesType | ||
|
Tero Ahola
|
r309 | |||
| The type of the series object. | ||||
| \value SeriesTypeLine | ||||
| \value SeriesTypeArea | ||||
| \value SeriesTypeBar | ||||
| \value SeriesTypeStackedBar | ||||
| \value SeriesTypePercentBar | ||||
| \value SeriesTypePie | ||||
| \value SeriesTypeScatter | ||||
| \value SeriesTypeSpline | ||||
|
sauimone
|
r1709 | \value SeriesTypeHorizontalBar | ||
| \value SeriesTypeHorizontalStackedBar | ||||
| \value SeriesTypeHorizontalPercentBar | ||||
|
Tero Ahola
|
r309 | */ | ||
| /*! | ||||
|
Tero Ahola
|
r1462 | \property QAbstractSeries::type | ||
| The type of the series. | ||||
|
Tero Ahola
|
r309 | */ | ||
|
Tero Ahola
|
r1521 | /*! | ||
| \qmlproperty ChartView.SeriesType AbstractSeries::type | ||||
| The type of the series. | ||||
| */ | ||||
|
Tero Ahola
|
r309 | |||
Marek Rosa
|
r908 | /*! | ||
|
Tero Ahola
|
r988 | \property QAbstractSeries::name | ||
|
Tero Ahola
|
r1521 | \brief name of the series property. The name is shown in legend for QXYSeries. | ||
| */ | ||||
| /*! | ||||
| \qmlproperty string AbstractSeries::name | ||||
| Name of the series. The name is shown in legend for QXYSeries. | ||||
|
Marek Rosa
|
r908 | */ | ||
|
Jani Honkonen
|
r1337 | /*! | ||
| \fn void QAbstractSeries::nameChanged() | ||||
| This signal is emitted when the series name changes. | ||||
|
Tero Ahola
|
r1521 | */ | ||
| /*! | ||||
|
sauimone
|
r1658 | \qmlsignal AbstractSeries::onNameChanged() | ||
|
Tero Ahola
|
r1521 | This signal is emitted when the series name changes. | ||
|
Jani Honkonen
|
r1337 | */ | ||
|
Jani Honkonen
|
r414 | /*! | ||
|
Tero Ahola
|
r1343 | \property QAbstractSeries::visible | ||
| \brief whether the series is visible or not; true by default. | ||||
| */ | ||||
|
sauimone
|
r1658 | /*! | ||
|
Tero Ahola
|
r2068 | \qmlproperty bool AbstractSeries::visible | ||
|
sauimone
|
r1658 | Visibility of the series. True by default. | ||
| */ | ||||
|
Jani Honkonen
|
r414 | |||
|
Tero Ahola
|
r1343 | /*! | ||
| \fn void QAbstractSeries::visibleChanged() | ||||
| Emitted when the series visibility changes. | ||||
|
Jani Honkonen
|
r414 | */ | ||
|
sauimone
|
r1658 | /*! | ||
| \qmlsignal AbstractSeries::onVisibleChanged() | ||||
| Emitted when the series visibility changes. | ||||
| */ | ||||
|
Tero Ahola
|
r2068 | |||
| /*! | ||||
| \property QAbstractSeries::opacity | ||||
| \brief The opacity of the series. | ||||
| By default the opacity is 1.0. The valid values range from 0.0 (transparent) to 1.0 (opaque). | ||||
| */ | ||||
| /*! | ||||
| \qmlproperty real AbstractSeries::opacity | ||||
| The opacity of the series. By default the opacity is 1.0. | ||||
| The valid values range from 0.0 (transparent) to 1.0 (opaque). | ||||
| */ | ||||
| /*! | ||||
| \fn void QAbstractSeries::opacityChanged() | ||||
| Emitted when the opacity of the series changes. | ||||
| */ | ||||
| /*! | ||||
| \qmlsignal AbstractSeries::onOpacityChanged() | ||||
| Emitted when the opacity of the series changes. | ||||
| */ | ||||
|
Jani Honkonen
|
r414 | /*! | ||
|
Tero Ahola
|
r973 | \internal | ||
| \brief Constructs ChartSeries object with \a parent. | ||||
|
Jani Honkonen
|
r414 | */ | ||
|
Tero Ahola
|
r988 | QAbstractSeries::QAbstractSeries(QAbstractSeriesPrivate &d, QObject *parent) : | ||
|
Tero Ahola
|
r973 | QObject(parent), | ||
| d_ptr(&d) | ||||
|
Michal Klocek
|
r938 | { | ||
| } | ||||
|
Tero Ahola
|
r973 | /*! | ||
| \brief Virtual destructor for the chart series. | ||||
| */ | ||||
|
Tero Ahola
|
r988 | QAbstractSeries::~QAbstractSeries() | ||
|
Michal Klocek
|
r938 | { | ||
|
Jani Honkonen
|
r2097 | if (d_ptr->m_dataset) | ||
| qFatal("Still binded series detected !"); | ||||
|
Michal Klocek
|
r938 | } | ||
|
Jani Honkonen
|
r2104 | void QAbstractSeries::setName(const QString &name) | ||
|
Michal Klocek
|
r938 | { | ||
|
Tero Ahola
|
r1328 | if (name != d_ptr->m_name) { | ||
| d_ptr->m_name = name; | ||||
|
Tero Ahola
|
r1342 | emit nameChanged(); | ||
|
Tero Ahola
|
r1328 | } | ||
|
Michal Klocek
|
r938 | } | ||
|
Tero Ahola
|
r988 | QString QAbstractSeries::name() const | ||
|
Michal Klocek
|
r938 | { | ||
| return d_ptr->m_name; | ||||
| } | ||||
|
Tero Ahola
|
r1342 | /*! | ||
| Sets the visibility of series to \a visible | ||||
| */ | ||||
| void QAbstractSeries::setVisible(bool visible) | ||||
| { | ||||
| if (visible != d_ptr->m_visible) { | ||||
| d_ptr->m_visible = visible; | ||||
| emit visibleChanged(); | ||||
| } | ||||
| } | ||||
| /*! | ||||
| Returns the visibility of series | ||||
| */ | ||||
| bool QAbstractSeries::isVisible() const | ||||
| { | ||||
| return d_ptr->m_visible; | ||||
| } | ||||
|
Tero Ahola
|
r2067 | qreal QAbstractSeries::opacity() const | ||
| { | ||||
| return d_ptr->m_opacity; | ||||
| } | ||||
| void QAbstractSeries::setOpacity(qreal opacity) | ||||
| { | ||||
| if (opacity != d_ptr->m_opacity) { | ||||
| d_ptr->m_opacity = opacity; | ||||
| emit opacityChanged(); | ||||
| } | ||||
| } | ||||
|
Jani Honkonen
|
r1314 | /*! | ||
| \brief Returns the chart where series belongs to. | ||||
| Set automatically when the series is added to the chart | ||||
| and unset when the series is removed from the chart. | ||||
| */ | ||||
|
Jani Honkonen
|
r2104 | QChart *QAbstractSeries::chart() const | ||
|
Jani Honkonen
|
r1314 | { | ||
| return d_ptr->m_chart; | ||||
| } | ||||
|
Marek Rosa
|
r1657 | //void QAbstractSeries::adjustView() | ||
| //{ | ||||
| // //TODO: | ||||
| //} | ||||
|
Michal Klocek
|
r1553 | |||
|
Marek Rosa
|
r1638 | /*! | ||
| \brief Sets the visibility of the series to true | ||||
| \sa setVisible(), isVisible() | ||||
| */ | ||||
|
Michal Klocek
|
r1553 | void QAbstractSeries::show() | ||
| { | ||||
| setVisible(true); | ||||
| } | ||||
|
Marek Rosa
|
r1638 | /*! | ||
| \brief Sets the visibility of the series to false | ||||
| \sa setVisible(), isVisible() | ||||
| */ | ||||
|
Michal Klocek
|
r1553 | void QAbstractSeries::hide() | ||
| { | ||||
| setVisible(false); | ||||
| } | ||||
|
Michal Klocek
|
r938 | /////////////////////////////////////////////////////////////////////////////////////////////////// | ||
|
Jani Honkonen
|
r2104 | QAbstractSeriesPrivate::QAbstractSeriesPrivate(QAbstractSeries *q) | ||
|
Jani Honkonen
|
r2097 | : q_ptr(q), | ||
| m_chart(0), | ||||
| m_dataset(0), | ||||
| m_visible(true), | ||||
| m_opacity(1.0) | ||||
|
Michal Klocek
|
r938 | { | ||
| } | ||||
|
Tero Ahola
|
r988 | QAbstractSeriesPrivate::~QAbstractSeriesPrivate() | ||
|
Michal Klocek
|
r938 | { | ||
| } | ||||
|
Tero Ahola
|
r988 | #include "moc_qabstractseries.cpp" | ||
| #include "moc_qabstractseries_p.cpp" | ||||
|
Michal Klocek
|
r938 | |||
| QTCOMMERCIALCHART_END_NAMESPACE | ||||