qxyseries.cpp
450 lines
| 10.6 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$ | ||||
** | ||||
****************************************************************************/ | ||||
|
r466 | #include "qxyseries.h" | ||
|
r938 | #include "qxyseries_p.h" | ||
|
r943 | #include "domain_p.h" | ||
|
r950 | #include "legendmarker_p.h" | ||
|
r1556 | #include "qvaluesaxis.h" | ||
|
r466 | |||
QTCOMMERCIALCHART_BEGIN_NAMESPACE | ||||
/*! | ||||
\class QXYSeries | ||||
|
r470 | \brief The QXYSeries class is a base class for line, spline and scatter series. | ||
|
r466 | */ | ||
|
r1491 | /*! | ||
\qmlclass XYSeries | ||||
|
r1521 | \inherits AbstractSeries | ||
The XYSeries class is a base class for line, spline and scatter series. | ||||
|
r1491 | |||
The class cannot be instantiated directly. | ||||
*/ | ||||
|
r466 | |||
|
r1336 | /*! | ||
\property QXYSeries::pointsVisible | ||||
|
r1491 | Controls if the data points are visible and should be drawn. | ||
*/ | ||||
/*! | ||||
\qmlproperty bool XYSeries::pointsVisible | ||||
|
r1336 | Controls if the data points are visible and should be drawn. | ||
*/ | ||||
|
r466 | /*! | ||
\fn QPen QXYSeries::pen() const | ||||
|
r480 | \brief Returns pen used to draw points for series. | ||
|
r466 | \sa setPen() | ||
*/ | ||||
|
r480 | /*! | ||
\fn QBrush QXYSeries::brush() const | ||||
\brief Returns brush used to draw points for series. | ||||
\sa setBrush() | ||||
*/ | ||||
|
r1481 | /*! | ||
\property QXYSeries::color | ||||
|
r1491 | The color of the series. This is line (pen) color in case of QLineSeries or QSplineSeries and | ||
fill (brush) color in case of QScatterSeries or QAreaSeries. | ||||
\sa QXYSeries::pen(), QXYSeries::brush() | ||||
*/ | ||||
/*! | ||||
\qmlproperty color XYSeries::color | ||||
The color of the series. This is line (pen) color in case of LineSeries or SplineSeries and | ||||
fill (brush) color in case of ScatterSeries or AreaSeries. | ||||
|
r1481 | */ | ||
|
r574 | /*! | ||
\fn void QXYSeries::clicked(const QPointF& point) | ||||
\brief Signal is emitted when user clicks the \a point on chart. | ||||
*/ | ||||
|
r1491 | /*! | ||
\qmlsignal XYSeries::onClicked(QPointF point) | ||||
Signal is emitted when user clicks the \a point on chart. For example: | ||||
\code | ||||
LineSeries { | ||||
|
r1532 | XYPoint { x: 0; y: 0 } | ||
XYPoint { x: 1.1; y: 2.1 } | ||||
|
r1491 | onClicked: console.log("onClicked: " + point.x + ", " + point.y); | ||
} | ||||
\endcode | ||||
*/ | ||||
|
r574 | |||
|
r466 | /*! | ||
|
r1336 | \fn void QXYSeries::pointReplaced(int index) | ||
|
r1491 | Signal is emitted when a point has been replaced at \a index. | ||
|
r1336 | \sa replace() | ||
|
r466 | */ | ||
|
r1491 | /*! | ||
|
r1531 | \qmlsignal XYSeries::onPointReplaced(int index) | ||
|
r1491 | Signal is emitted when a point has been replaced at \a index. | ||
*/ | ||||
|
r466 | |||
/*! | ||||
|
r1336 | \fn void QXYSeries::pointAdded(int index) | ||
|
r1491 | Signal is emitted when a point has been added at \a index. | ||
|
r1336 | \sa append(), insert() | ||
|
r466 | */ | ||
|
r1491 | /*! | ||
|
r1531 | \qmlsignal XYSeries::onPointAdded(int index) | ||
|
r1491 | Signal is emitted when a point has been added at \a index. | ||
*/ | ||||
|
r466 | |||
/*! | ||||
|
r1336 | \fn void QXYSeries::pointRemoved(int index) | ||
|
r1491 | Signal is emitted when a point has been removed from \a index. | ||
|
r1336 | \sa remove() | ||
|
r466 | */ | ||
|
r1491 | /*! | ||
|
r1531 | \qmlsignal XYSeries::onPointRemoved(int index) | ||
|
r1491 | Signal is emitted when a point has been removed from \a index. | ||
*/ | ||||
|
r466 | |||
|
r1465 | /*! | ||
|
r1481 | \fn void QXYSeries::colorChanged(QColor color) | ||
\brief Signal is emitted when the line (pen) color has changed to \a color. | ||||
|
r1465 | */ | ||
|
r1491 | /*! | ||
|
r1531 | \qmlsignal XYSeries::onColorChanged(color color) | ||
|
r1491 | Signal is emitted when the line (pen) color has changed to \a color. | ||
*/ | ||||
|
r1465 | |||
|
r466 | /*! | ||
|
r940 | \fn void QXYSeriesPrivate::updated() | ||
|
r466 | \brief \internal | ||
*/ | ||||
|
r1491 | /*! | ||
|
r1521 | \qmlmethod XYSeries::append(real x, real y) | ||
Append point (\a x, \a y) to the series | ||||
*/ | ||||
/*! | ||||
\qmlmethod XYSeries::replace(real oldX, real oldY, real newX, real newY) | ||||
Replaces point (\a oldX, \a oldY) with point (\a newX, \a newY). Does nothing, if point (oldX, oldY) does not | ||||
exist. | ||||
*/ | ||||
/*! | ||||
\qmlmethod XYSeries::remove(real x, real y) | ||||
Removes point (\a x, \a y) from the series. Does nothing, if point (x, y) does not exist. | ||||
*/ | ||||
/*! | ||||
\qmlmethod XYSeries::insert(int index, real x, real y) | ||||
Inserts point (\a x, \a y) to the \a index. If index is 0 or smaller than 0 the point is prepended to the list of | ||||
points. If index is the same as or bigger than count, the point is appended to the list of points. | ||||
*/ | ||||
/*! | ||||
\qmlmethod QPointF XYSeries::at(int index) | ||||
Returns point at \a index. Returns (0, 0) if the index is not valid. | ||||
|
r1491 | */ | ||
|
r466 | /*! | ||
|
r973 | \internal | ||
|
r466 | Constructs empty series object which is a child of \a parent. | ||
|
r974 | When series object is added to QChartView or QChart instance ownerships is transferred. | ||
|
r466 | */ | ||
|
r988 | QXYSeries::QXYSeries(QXYSeriesPrivate &d,QObject *parent) : QAbstractSeries(d, parent) | ||
|
r938 | { | ||
|
r466 | } | ||
|
r1342 | |||
|
r466 | /*! | ||
Destroys the object. Series added to QChartView or QChart instances are owned by those, | ||||
and are deleted when mentioned object are destroyed. | ||||
*/ | ||||
QXYSeries::~QXYSeries() | ||||
{ | ||||
} | ||||
/*! | ||||
Adds data point \a x \a y to the series. Points are connected with lines on the chart. | ||||
*/ | ||||
|
r796 | void QXYSeries::append(qreal x,qreal y) | ||
|
r466 | { | ||
|
r1057 | append(QPointF(x,y)); | ||
|
r466 | } | ||
/*! | ||||
This is an overloaded function. | ||||
Adds data \a point to the series. Points are connected with lines on the chart. | ||||
*/ | ||||
|
r796 | void QXYSeries::append(const QPointF &point) | ||
|
r466 | { | ||
|
r1057 | Q_D(QXYSeries); | ||
d->m_points<<point; | ||||
|
r1262 | // emit d->pointAdded(d->m_points.count()-1); | ||
emit pointAdded(d->m_points.count()-1); | ||||
|
r466 | } | ||
|
r481 | /*! | ||
This is an overloaded function. | ||||
Adds list of data \a points to the series. Points are connected with lines on the chart. | ||||
*/ | ||||
|
r1057 | void QXYSeries::append(const QList<QPointF> &points) | ||
|
r481 | { | ||
foreach(const QPointF& point , points) { | ||||
|
r1057 | append(point); | ||
|
r481 | } | ||
} | ||||
|
r1336 | /*! | ||
Replaces data point \a oldX \a oldY with data point \a newX \a newY. | ||||
*/ | ||||
|
r1057 | void QXYSeries::replace(qreal oldX,qreal oldY,qreal newX,qreal newY) | ||
|
r466 | { | ||
|
r1057 | replace(QPointF(oldX,oldY),QPointF(newX,newY)); | ||
|
r466 | } | ||
|
r1336 | /*! | ||
Replaces \a oldPoint with \a newPoint. | ||||
*/ | ||||
|
r1057 | void QXYSeries::replace(const QPointF &oldPoint,const QPointF &newPoint) | ||
|
r622 | { | ||
|
r938 | Q_D(QXYSeries); | ||
|
r1057 | int index = d->m_points.indexOf(oldPoint); | ||
|
r1064 | if(index==-1) return; | ||
|
r1057 | d->m_points[index] = newPoint; | ||
|
r1262 | // emit d->pointReplaced(index); | ||
emit pointReplaced(index); | ||||
|
r622 | } | ||
|
r466 | /*! | ||
|
r541 | Removes current \a x and \a y value. | ||
|
r466 | */ | ||
|
r541 | void QXYSeries::remove(qreal x,qreal y) | ||
|
r466 | { | ||
|
r1057 | remove(QPointF(x,y)); | ||
|
r466 | } | ||
/*! | ||||
|
r1336 | Removes current \a point x value. | ||
Note: point y value is ignored. | ||||
|
r466 | */ | ||
|
r743 | void QXYSeries::remove(const QPointF &point) | ||
|
r466 | { | ||
|
r1057 | Q_D(QXYSeries); | ||
int index = d->m_points.indexOf(point); | ||||
|
r1064 | if(index==-1) return; | ||
|
r1057 | d->m_points.remove(index); | ||
|
r1262 | // emit d->pointRemoved(index); | ||
emit pointRemoved(index); | ||||
|
r466 | } | ||
|
r1336 | /*! | ||
Inserts a \a point in the series at \a index position. | ||||
*/ | ||||
|
r1256 | void QXYSeries::insert(int index, const QPointF &point) | ||
{ | ||||
Q_D(QXYSeries); | ||||
d->m_points.insert(index, point); | ||||
|
r1262 | // emit d->pointAdded(index); | ||
emit pointAdded(index); | ||||
|
r1256 | } | ||
|
r1336 | /*! | ||
Removes all points from the series. | ||||
*/ | ||||
|
r1256 | void QXYSeries::clear() | ||
{ | ||||
Q_D(QXYSeries); | ||||
for (int i = d->m_points.size() - 1; i >= 0; i--) | ||||
remove(d->m_points.at(i)); | ||||
} | ||||
|
r466 | /*! | ||
\internal \a pos | ||||
*/ | ||||
|
r1057 | QList<QPointF> QXYSeries::points() const | ||
|
r466 | { | ||
|
r938 | Q_D(const QXYSeries); | ||
|
r1230 | return d->m_points.toList(); | ||
|
r466 | } | ||
/*! | ||||
Returns number of data points within series. | ||||
*/ | ||||
int QXYSeries::count() const | ||||
{ | ||||
|
r938 | Q_D(const QXYSeries); | ||
|
r1057 | return d->m_points.count(); | ||
|
r491 | } | ||
|
r467 | /*! | ||
|
r481 | Sets \a pen used for drawing points on the chart. If the pen is not defined, the | ||
pen from chart theme is used. | ||||
|
r909 | \sa QChart::setTheme() | ||
|
r467 | */ | ||
|
r743 | void QXYSeries::setPen(const QPen &pen) | ||
|
r467 | { | ||
|
r938 | Q_D(QXYSeries); | ||
|
r1537 | if (d->m_pen != pen) { | ||
bool emitColorChanged = d->m_pen.color() != pen.color(); | ||||
|
r938 | d->m_pen = pen; | ||
emit d->updated(); | ||||
|
r1537 | if (emitColorChanged) | ||
emit colorChanged(pen.color()); | ||||
|
r467 | } | ||
} | ||||
|
r938 | QPen QXYSeries::pen() const | ||
{ | ||||
Q_D(const QXYSeries); | ||||
return d->m_pen; | ||||
} | ||||
|
r467 | /*! | ||
|
r481 | Sets \a brush used for drawing points on the chart. If the brush is not defined, brush | ||
from chart theme setting is used. | ||||
|
r909 | \sa QChart::setTheme() | ||
|
r467 | */ | ||
|
r743 | void QXYSeries::setBrush(const QBrush &brush) | ||
|
r467 | { | ||
|
r938 | Q_D(QXYSeries); | ||
if (d->m_brush!=brush) { | ||||
d->m_brush = brush; | ||||
emit d->updated(); | ||||
|
r467 | } | ||
} | ||||
|
r938 | QBrush QXYSeries::brush() const | ||
{ | ||||
Q_D(const QXYSeries); | ||||
return d->m_brush; | ||||
} | ||||
|
r1481 | void QXYSeries::setColor(const QColor &color) | ||
{ | ||||
QPen p = pen(); | ||||
if (p.color() != color) { | ||||
p.setColor(color); | ||||
setPen(p); | ||||
} | ||||
} | ||||
QColor QXYSeries::color() const | ||||
{ | ||||
return pen().color(); | ||||
} | ||||
|
r938 | |||
void QXYSeries::setPointsVisible(bool visible) | ||||
{ | ||||
Q_D(QXYSeries); | ||||
if (d->m_pointsVisible != visible){ | ||||
d->m_pointsVisible = visible; | ||||
emit d->updated(); | ||||
} | ||||
} | ||||
bool QXYSeries::pointsVisible() const | ||||
{ | ||||
Q_D(const QXYSeries); | ||||
return d->m_pointsVisible; | ||||
} | ||||
|
r467 | |||
|
r466 | /*! | ||
Stream operator for adding a data \a point to the series. | ||||
|
r796 | \sa append() | ||
|
r466 | */ | ||
QXYSeries& QXYSeries::operator<< (const QPointF &point) | ||||
{ | ||||
|
r796 | append(point); | ||
|
r466 | return *this; | ||
} | ||||
|
r481 | /*! | ||
Stream operator for adding a list of \a points to the series. | ||||
|
r796 | \sa append() | ||
|
r481 | */ | ||
|
r1057 | QXYSeries& QXYSeries::operator<< (const QList<QPointF>& points) | ||
|
r481 | { | ||
|
r796 | append(points); | ||
|
r481 | return *this; | ||
} | ||||
|
r938 | ////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////// | ||
|
r990 | |||
|
r1230 | QXYSeriesPrivate::QXYSeriesPrivate(QXYSeries *q) : | ||
QAbstractSeriesPrivate(q), | ||||
|
r988 | m_pointsVisible(false) | ||
|
r938 | { | ||
} | ||||
|
r943 | void QXYSeriesPrivate::scaleDomain(Domain& domain) | ||
{ | ||||
qreal minX(domain.minX()); | ||||
qreal minY(domain.minY()); | ||||
qreal maxX(domain.maxX()); | ||||
qreal maxY(domain.maxY()); | ||||
|
r1059 | Q_Q(QXYSeries); | ||
|
r1057 | |||
|
r1059 | const QList<QPointF>& points = q->points(); | ||
|
r1070 | |||
|
r1217 | |||
|
r1533 | if (points.isEmpty()){ | ||
|
r1679 | minX = qMin(minX, (qreal)0.0); | ||
minY = qMin(minY, (qreal)0.0); | ||||
maxX = qMax(maxX, (qreal)1.0); | ||||
maxY = qMax(maxY, (qreal)1.0); | ||||
|
r1205 | } | ||
|
r1533 | for (int i = 0; i < points.count(); i++) { | ||
|
r1205 | qreal x = points[i].x(); | ||
qreal y = points[i].y(); | ||||
minX = qMin(minX, x); | ||||
minY = qMin(minY, y); | ||||
maxX = qMax(maxX, x); | ||||
maxY = qMax(maxY, y); | ||||
} | ||||
|
r1698 | domain.setRange(minX,maxX,minY,maxY); | ||
|
r943 | } | ||
|
r950 | QList<LegendMarker*> QXYSeriesPrivate::createLegendMarker(QLegend* legend) | ||
{ | ||||
Q_Q(QXYSeries); | ||||
QList<LegendMarker*> list; | ||||
return list << new XYLegendMarker(q,legend); | ||||
} | ||||
|
r1695 | void QXYSeriesPrivate::initializeAxis(QAbstractAxis* axis) | ||
|
r1556 | { | ||
|
r1588 | Q_UNUSED(axis); | ||
|
r1556 | } | ||
|
r1695 | QAbstractAxis::AxisType QXYSeriesPrivate::defaultAxisType(Qt::Orientation orientation) const | ||
|
r1588 | { | ||
|
r1695 | Q_UNUSED(orientation); | ||
|
r1588 | return QAbstractAxis::AxisTypeValues; | ||
|
r1556 | } | ||
|
r466 | #include "moc_qxyseries.cpp" | ||
|
r938 | #include "moc_qxyseries_p.cpp" | ||
|
r466 | |||
QTCOMMERCIALCHART_END_NAMESPACE | ||||