qscatterseries.cpp
178 lines
| 4.4 KiB
| text/x-c
|
CppLexer
|
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$ | ||||
** | ||||
****************************************************************************/ | ||||
|
r42 | #include "qscatterseries.h" | ||
|
r938 | #include "qscatterseries_p.h" | ||
|
r943 | #include "scatterchartitem_p.h" | ||
#include "chartdataset_p.h" | ||||
#include "charttheme_p.h" | ||||
#include "chartanimator_p.h" | ||||
|
r42 | |||
|
r300 | /*! | ||
\class QScatterSeries | ||||
|
r481 | \brief The QScatterSeries class is used for making scatter charts. | ||
|
r42 | |||
|
r300 | \mainclass | ||
|
r481 | The scatter data is displayed as a collection of points on the chart. Each point determines the position on the horizontal axis | ||
and the vertical axis. | ||||
|
r300 | |||
|
r995 | \image examples_scatterchart.png | ||
|
r300 | |||
|
r481 | Creating basic scatter chart is simple: | ||
\code | ||||
QScatterSeries* series = new QScatterSeries(); | ||||
|
r796 | series->append(0, 6); | ||
series->append(2, 4); | ||||
|
r481 | ... | ||
|
r995 | chart->addSeries(series); | ||
|
r481 | \endcode | ||
|
r300 | */ | ||
|
r42 | |||
|
r261 | /*! | ||
\enum QScatterSeries::MarkerShape | ||||
This enum describes the shape used when rendering marker items. | ||||
\value MarkerShapeCircle | ||||
|
r541 | \value MarkerShapeRectangle | ||
|
r261 | */ | ||
|
r1341 | /*! | ||
\property QScatterSeries::markerShape | ||||
Defines the shape of the marker used to draw the points in the series. | ||||
*/ | ||||
|
r1349 | /*! | ||
\fn void QScatterSeries::markerShapeChanged() | ||||
Emitted when marker shape is changed | ||||
*/ | ||||
/*! | ||||
\fn void QScatterSeries::markerSizeChanged() | ||||
Emitted when marker size is changed | ||||
*/ | ||||
|
r1341 | /*! | ||
\property QScatterSeries::markerSize | ||||
Defines the size of the marker used to draw the points in the series. | ||||
*/ | ||||
|
r260 | /*! | ||
|
r300 | \fn QChartSeriesType QScatterSeries::type() const | ||
\brief Returns QChartSeries::SeriesTypeScatter. | ||||
|
r1107 | \sa QAbstractSeries, SeriesType | ||
|
r300 | */ | ||
|
r260 | |||
|
r300 | QTCOMMERCIALCHART_BEGIN_NAMESPACE | ||
|
r261 | /*! | ||
Constructs a series object which is a child of \a parent. | ||||
*/ | ||||
|
r938 | QScatterSeries::QScatterSeries(QObject *parent) : QXYSeries(*new QScatterSeriesPrivate(this),parent) | ||
|
r42 | { | ||
} | ||||
|
r260 | /*! | ||
|
r261 | Destroys the object. Note that adding series to QChart transfers the ownership to the chart. | ||
|
r260 | */ | ||
|
r158 | QScatterSeries::~QScatterSeries() | ||
|
r42 | { | ||
|
r1270 | Q_D(QScatterSeries); | ||
if(d->m_dataset) { | ||||
d->m_dataset->removeSeries(this); | ||||
} | ||||
|
r48 | } | ||
|
r1107 | QAbstractSeries::SeriesType QScatterSeries::type() const | ||
|
r938 | { | ||
|
r988 | return QAbstractSeries::SeriesTypeScatter; | ||
|
r938 | } | ||
|
r261 | /*! | ||
|
r459 | Returns the shape used for drawing markers. | ||
|
r261 | */ | ||
|
r1276 | QScatterSeries::MarkerShape QScatterSeries::markerShape() const | ||
|
r195 | { | ||
|
r938 | Q_D(const QScatterSeries); | ||
return d->m_shape; | ||||
|
r195 | } | ||
|
r261 | /*! | ||
|
r300 | Overrides the default shape of the marker items with a user defined \a shape. The default shape | ||
is defined by chart theme setting. | ||||
|
r261 | */ | ||
|
r1276 | void QScatterSeries::setMarkerShape(MarkerShape shape) | ||
|
r195 | { | ||
|
r938 | Q_D(QScatterSeries); | ||
if (d->m_shape != shape) { | ||||
d->m_shape = shape; | ||||
|
r1349 | emit markerShapeChanged(); | ||
|
r573 | } | ||
|
r195 | } | ||
|
r397 | /*! | ||
Returns the size of the marker items. | ||||
*/ | ||||
|
r1276 | qreal QScatterSeries::markerSize() const | ||
|
r397 | { | ||
|
r938 | Q_D(const QScatterSeries); | ||
return d->m_size; | ||||
|
r397 | } | ||
/*! | ||||
|
r814 | Set the \a size of the marker items. The default size is 15. | ||
|
r397 | */ | ||
|
r1276 | void QScatterSeries::setMarkerSize(qreal size) | ||
|
r397 | { | ||
|
r938 | Q_D(QScatterSeries); | ||
if (!qFuzzyIsNull(d->m_size - size)) { | ||||
d->m_size = size; | ||||
|
r1349 | emit markerSizeChanged(); | ||
|
r573 | } | ||
|
r397 | } | ||
|
r938 | //////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////// | ||
QScatterSeriesPrivate::QScatterSeriesPrivate(QScatterSeries* q):QXYSeriesPrivate(q), | ||||
m_shape(QScatterSeries::MarkerShapeCircle), | ||||
m_size(15.0) | ||||
{ | ||||
}; | ||||
|
r943 | Chart* QScatterSeriesPrivate::createGraphics(ChartPresenter* presenter) | ||
{ | ||||
Q_Q(QScatterSeries); | ||||
ScatterChartItem *scatter = new ScatterChartItem(q,presenter); | ||||
if(presenter->animationOptions().testFlag(QChart::SeriesAnimations)) { | ||||
|
r1217 | scatter->setAnimator(presenter->animator()); | ||
scatter->setAnimation(new XYAnimation(scatter)); | ||||
|
r943 | } | ||
presenter->chartTheme()->decorate(q, presenter->dataSet()->seriesIndex(q)); | ||||
return scatter; | ||||
} | ||||
|
r1276 | #include "moc_qscatterseries.cpp" | ||
|
r938 | |||
|
r42 | QTCOMMERCIALCHART_END_NAMESPACE | ||