qabstractseries.cpp
309 lines
| 7.5 KiB
| text/x-c
|
CppLexer
/ src / qabstractseries.cpp
|
r794 | /**************************************************************************** | ||
** | ||||
|
r2432 | ** Copyright (C) 2013 Digia Plc | ||
|
r794 | ** 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$ | ||||
** | ||||
****************************************************************************/ | ||||
|
r988 | #include "qabstractseries.h" | ||
#include "qabstractseries_p.h" | ||||
|
r1062 | #include "chartdataset_p.h" | ||
|
r2273 | #include "qchart.h" | ||
#include "qchart_p.h" | ||||
#include "chartitem_p.h" | ||||
|
r2275 | #include "xydomain_p.h" | ||
#include "xlogydomain_p.h" | ||||
#include "logxydomain_p.h" | ||||
#include "logxlogydomain_p.h" | ||||
|
r938 | |||
QTCOMMERCIALCHART_BEGIN_NAMESPACE | ||||
|
r62 | |||
|
r309 | /*! | ||
|
r988 | \class QAbstractSeries | ||
|
r309 | \brief Base class for all QtCommercial Chart series. | ||
\mainclass | ||||
|
r310 | |||
Usually you use the series type specific inherited classes instead of the base class. | ||||
|
r1586 | \sa QXYSeries, QLineSeries, QSplineSeries, QScatterSeries, QAreaSeries, QAbstractBarSeries, QStackedBarSeries, | ||
|
r973 | QPercentBarSeries, QPieSeries | ||
|
r309 | */ | ||
|
r1521 | /*! | ||
\qmlclass AbstractSeries | ||||
AbstractSeries is the base class for all series. | ||||
The class cannot be instantiated by the user. | ||||
*/ | ||||
|
r309 | |||
/*! | ||||
|
r1107 | \enum QAbstractSeries::SeriesType | ||
|
r309 | |||
The type of the series object. | ||||
\value SeriesTypeLine | ||||
\value SeriesTypeArea | ||||
\value SeriesTypeBar | ||||
\value SeriesTypeStackedBar | ||||
\value SeriesTypePercentBar | ||||
\value SeriesTypePie | ||||
\value SeriesTypeScatter | ||||
\value SeriesTypeSpline | ||||
|
r1709 | \value SeriesTypeHorizontalBar | ||
\value SeriesTypeHorizontalStackedBar | ||||
\value SeriesTypeHorizontalPercentBar | ||||
|
r309 | */ | ||
/*! | ||||
|
r1462 | \property QAbstractSeries::type | ||
The type of the series. | ||||
|
r309 | */ | ||
|
r1521 | /*! | ||
\qmlproperty ChartView.SeriesType AbstractSeries::type | ||||
The type of the series. | ||||
*/ | ||||
|
r309 | |||
|
r908 | /*! | ||
|
r988 | \property QAbstractSeries::name | ||
|
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. | ||||
|
r908 | */ | ||
|
r1337 | /*! | ||
\fn void QAbstractSeries::nameChanged() | ||||
This signal is emitted when the series name changes. | ||||
|
r1521 | */ | ||
/*! | ||||
|
r1658 | \qmlsignal AbstractSeries::onNameChanged() | ||
|
r1521 | This signal is emitted when the series name changes. | ||
|
r1337 | */ | ||
|
r414 | /*! | ||
|
r1343 | \property QAbstractSeries::visible | ||
\brief whether the series is visible or not; true by default. | ||||
*/ | ||||
|
r1658 | /*! | ||
|
r2068 | \qmlproperty bool AbstractSeries::visible | ||
|
r1658 | Visibility of the series. True by default. | ||
*/ | ||||
|
r414 | |||
|
r1343 | /*! | ||
\fn void QAbstractSeries::visibleChanged() | ||||
Emitted when the series visibility changes. | ||||
|
r414 | */ | ||
|
r1658 | /*! | ||
\qmlsignal AbstractSeries::onVisibleChanged() | ||||
Emitted when the series visibility changes. | ||||
*/ | ||||
|
r2068 | |||
/*! | ||||
\property QAbstractSeries::opacity | ||||
\brief The opacity of the series. | ||||
|
r2520 | |||
|
r2068 | 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. | ||||
*/ | ||||
|
r414 | /*! | ||
|
r973 | \internal | ||
|
r2494 | \brief Constructs QAbstractSeries object with \a parent. | ||
|
r414 | */ | ||
|
r988 | QAbstractSeries::QAbstractSeries(QAbstractSeriesPrivate &d, QObject *parent) : | ||
|
r973 | QObject(parent), | ||
d_ptr(&d) | ||||
|
r938 | { | ||
} | ||||
|
r973 | /*! | ||
\brief Virtual destructor for the chart series. | ||||
*/ | ||||
|
r988 | QAbstractSeries::~QAbstractSeries() | ||
|
r938 | { | ||
|
r2273 | if (d_ptr->m_chart) | ||
|
r2494 | qFatal("Series still bound to a chart when destroyed!"); | ||
|
r938 | } | ||
|
r2104 | void QAbstractSeries::setName(const QString &name) | ||
|
r938 | { | ||
|
r1328 | if (name != d_ptr->m_name) { | ||
d_ptr->m_name = name; | ||||
|
r1342 | emit nameChanged(); | ||
|
r1328 | } | ||
|
r938 | } | ||
|
r988 | QString QAbstractSeries::name() const | ||
|
r938 | { | ||
return d_ptr->m_name; | ||||
} | ||||
|
r1342 | void QAbstractSeries::setVisible(bool visible) | ||
{ | ||||
if (visible != d_ptr->m_visible) { | ||||
d_ptr->m_visible = visible; | ||||
emit visibleChanged(); | ||||
} | ||||
} | ||||
bool QAbstractSeries::isVisible() const | ||||
{ | ||||
return d_ptr->m_visible; | ||||
} | ||||
|
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(); | ||||
} | ||||
} | ||||
|
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. | ||||
*/ | ||||
|
r2104 | QChart *QAbstractSeries::chart() const | ||
|
r1314 | { | ||
return d_ptr->m_chart; | ||||
} | ||||
|
r1638 | /*! | ||
|
r2520 | \brief Sets the visibility of the series to true. | ||
|
r1638 | |||
\sa setVisible(), isVisible() | ||||
*/ | ||||
|
r1553 | void QAbstractSeries::show() | ||
{ | ||||
setVisible(true); | ||||
} | ||||
|
r1638 | /*! | ||
|
r2520 | \brief Sets the visibility of the series to false. | ||
|
r1638 | |||
\sa setVisible(), isVisible() | ||||
*/ | ||||
|
r1553 | void QAbstractSeries::hide() | ||
{ | ||||
setVisible(false); | ||||
} | ||||
|
r2363 | /*! | ||
Attach \a axis to the series. | ||||
\return true if the axis was attached successfully, false otherwise. | ||||
\sa QChart::addAxis(), QChart::createDefaultAxes() | ||||
*/ | ||||
|
r2273 | bool QAbstractSeries::attachAxis(QAbstractAxis* axis) | ||
{ | ||||
if(d_ptr->m_chart) { | ||||
|
r2363 | return d_ptr->m_chart->d_ptr->m_dataset->attachAxis(this, axis); | ||
|
r2273 | } else { | ||
qWarning()<<"Series not in the chart. Please addSeries to chart first."; | ||||
return false; | ||||
} | ||||
} | ||||
|
r2363 | /*! | ||
Detach \a axis from the series. | ||||
\return true if the axis was detached successfully, false otherwise. | ||||
\sa QChart::removeAxis() | ||||
*/ | ||||
|
r2273 | bool QAbstractSeries::detachAxis(QAbstractAxis* axis) | ||
{ | ||||
if(d_ptr->m_chart) { | ||||
|
r2363 | return d_ptr->m_chart->d_ptr->m_dataset->detachAxis(this, axis); | ||
|
r2273 | } | ||
else { | ||||
qWarning()<<"Series not in the chart. Please addSeries to chart first."; | ||||
return false; | ||||
} | ||||
} | ||||
|
r2363 | /*! | ||
Returns the list of axes attached to the series. Usually there is an x-axis and a y-axis attached to a series, except | ||||
in case of a QPieSeries, which does not have any axes attached. | ||||
\sa attachAxis(), detachAxis() | ||||
*/ | ||||
|
r2273 | QList<QAbstractAxis*> QAbstractSeries::attachedAxes() | ||
{ | ||||
return d_ptr->m_axes; | ||||
} | ||||
|
r938 | /////////////////////////////////////////////////////////////////////////////////////////////////// | ||
|
r2104 | QAbstractSeriesPrivate::QAbstractSeriesPrivate(QAbstractSeries *q) | ||
|
r2097 | : q_ptr(q), | ||
m_chart(0), | ||||
|
r2273 | m_item(0), | ||
|
r2275 | m_domain(new XYDomain()), | ||
|
r2097 | m_visible(true), | ||
m_opacity(1.0) | ||||
|
r938 | { | ||
} | ||||
|
r988 | QAbstractSeriesPrivate::~QAbstractSeriesPrivate() | ||
|
r938 | { | ||
} | ||||
|
r2285 | void QAbstractSeriesPrivate::setDomain(AbstractDomain* domain) | ||
|
r2273 | { | ||
|
r2285 | Q_ASSERT(domain); | ||
if(m_domain.data()!=domain) { | ||||
|
r2273 | if(!m_item.isNull()) QObject::disconnect(m_domain.data(), SIGNAL(updated()), m_item.data(), SLOT(handleDomainUpdated())); | ||
|
r2285 | m_domain.reset(domain); | ||
|
r2273 | if(!m_item.isNull()) { | ||
QObject::connect(m_domain.data(), SIGNAL(updated()),m_item.data(), SLOT(handleDomainUpdated())); | ||||
m_item->handleDomainUpdated(); | ||||
} | ||||
} | ||||
} | ||||
void QAbstractSeriesPrivate::initializeGraphics(QGraphicsItem* parent) | ||||
{ | ||||
Q_ASSERT(!m_item.isNull()); | ||||
Q_UNUSED(parent); | ||||
QObject::connect(m_domain.data(), SIGNAL(updated()),m_item.data(), SLOT(handleDomainUpdated())); | ||||
} | ||||
void QAbstractSeriesPrivate::initializeAnimations(QChart::AnimationOptions options) | ||||
{ | ||||
Q_UNUSED(options); | ||||
} | ||||
|
r988 | #include "moc_qabstractseries.cpp" | ||
#include "moc_qabstractseries_p.cpp" | ||||
|
r938 | |||
QTCOMMERCIALCHART_END_NAMESPACE | ||||