qabstractseries.cpp
245 lines
| 5.5 KiB
| text/x-c
|
CppLexer
/ src / qabstractseries.cpp
|
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$ | ||||
** | ||||
****************************************************************************/ | ||||
|
r988 | #include "qabstractseries.h" | ||
#include "qabstractseries_p.h" | ||||
|
r1062 | #include "chartdataset_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. | ||||
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 | ||
\brief Constructs ChartSeries 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 | { | ||
|
r2097 | if (d_ptr->m_dataset) | ||
qFatal("Still binded series detected !"); | ||||
|
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 | /*! | ||
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; | ||||
} | ||||
|
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; | ||||
} | ||||
|
r1657 | //void QAbstractSeries::adjustView() | ||
//{ | ||||
// //TODO: | ||||
//} | ||||
|
r1553 | |||
|
r1638 | /*! | ||
\brief Sets the visibility of the series to true | ||||
\sa setVisible(), isVisible() | ||||
*/ | ||||
|
r1553 | void QAbstractSeries::show() | ||
{ | ||||
setVisible(true); | ||||
} | ||||
|
r1638 | /*! | ||
\brief Sets the visibility of the series to false | ||||
\sa setVisible(), isVisible() | ||||
*/ | ||||
|
r1553 | void QAbstractSeries::hide() | ||
{ | ||||
setVisible(false); | ||||
} | ||||
|
r938 | /////////////////////////////////////////////////////////////////////////////////////////////////// | ||
|
r2104 | QAbstractSeriesPrivate::QAbstractSeriesPrivate(QAbstractSeries *q) | ||
|
r2097 | : q_ptr(q), | ||
m_chart(0), | ||||
m_dataset(0), | ||||
m_visible(true), | ||||
m_opacity(1.0) | ||||
|
r938 | { | ||
} | ||||
|
r988 | QAbstractSeriesPrivate::~QAbstractSeriesPrivate() | ||
|
r938 | { | ||
} | ||||
|
r988 | #include "moc_qabstractseries.cpp" | ||
#include "moc_qabstractseries_p.cpp" | ||||
|
r938 | |||
QTCOMMERCIALCHART_END_NAMESPACE | ||||