diff options
Diffstat (limited to 'src/xychart/qxyseries.cpp')
-rw-r--r-- | src/xychart/qxyseries.cpp | 804 |
1 files changed, 0 insertions, 804 deletions
diff --git a/src/xychart/qxyseries.cpp b/src/xychart/qxyseries.cpp deleted file mode 100644 index b573d7a0..00000000 --- a/src/xychart/qxyseries.cpp +++ /dev/null @@ -1,804 +0,0 @@ -/**************************************************************************** -** -** Copyright (C) 2014 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 Enterprise Charts Add-on. -** -** $QT_BEGIN_LICENSE$ -** Licensees holding valid Qt Enterprise licenses may use this file in -** accordance with the Qt Enterprise 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$ -** -****************************************************************************/ - -#include "qxyseries.h" -#include "qxyseries_p.h" -#include "abstractdomain_p.h" -#include "qvalueaxis.h" -#include "xychart_p.h" -#include "qxylegendmarker.h" -#include "charthelpers_p.h" -#include "qchart_p.h" -#include <QPainter> - -QTCOMMERCIALCHART_BEGIN_NAMESPACE - -/*! - \class QXYSeries - \inmodule Qt Charts - \brief The QXYSeries class is a base class for line, spline and scatter series. -*/ -#ifdef QDOC_QT5 -/*! - \qmltype XYSeries - \instantiates QXYSeries - \inqmlmodule QtCommercial.Chart - - \include doc/src/xyseries.qdocinc -*/ -#else -/*! - \qmlclass XYSeries QXYSeries - - \include ../doc/src/xyseries.qdocinc -*/ -#endif - -/*! - \qmlproperty AbstractAxis XYSeries::axisX - The x axis used for the series. If you leave both axisX and axisXTop undefined, a ValueAxis is created for - the series. - \sa axisXTop -*/ - -/*! - \qmlproperty AbstractAxis XYSeries::axisY - The y axis used for the series. If you leave both axisY and axisYRight undefined, a ValueAxis is created for - the series. - \sa axisYRight -*/ - -/*! - \qmlproperty AbstractAxis XYSeries::axisXTop - The x axis used for the series, drawn on top of the chart view. Note that you can only provide either axisX or - axisXTop, but not both. - \sa axisX -*/ - -/*! - \qmlproperty AbstractAxis XYSeries::axisYRight - The y axis used for the series, drawn to the right on the chart view. Note that you can only provide either axisY - or axisYRight, but not both. - \sa axisY -*/ - -/*! - \qmlproperty AbstractAxis XYSeries::axisAngular - The angular axis used for the series, drawn around the polar chart view. - \sa axisX -*/ - -/*! - \qmlproperty AbstractAxis XYSeries::axisRadial - The radial axis used for the series, drawn inside the polar chart view. - \sa axisY -*/ - -/*! - \property QXYSeries::pointsVisible - Controls if the data points are visible and should be drawn. -*/ -/*! - \qmlproperty bool XYSeries::pointsVisible - Controls if the data points are visible and should be drawn. -*/ - -/*! - \fn QPen QXYSeries::pen() const - \brief Returns pen used to draw points for series. - \sa setPen() -*/ - -/*! - \fn QBrush QXYSeries::brush() const - \brief Returns brush used to draw points for series. - \sa setBrush() -*/ - -/*! - \property QXYSeries::color - 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. -*/ - -/*! - \property QXYSeries::pointLabelsFormat - The \a format used for showing labels with series points. - - QXYSeries supports the following format tags: - \table - \row - \li @xPoint \li The x value of the data point - \row - \li @yPoint \li The y value of the data point - \endtable - - For example, the following usage of the format tags would produce labels that have the data - point (x, y) shown inside brackets separated by a comma: - \code - series->setPointLabelsFormat("(@xPoint, @yPoint)"); - \endcode - - By default, the labels format is set to '@xPoint, @yPoint'. The labels are shown on the plot - area, labels on the edge of the plot area are cut. If the points are close to each other the - labels may overlap. - - \sa QXYSeries::pointLabelsVisible, QXYSeries::pointLabelsFont, QXYSeries::pointLabelsColor -*/ -/*! - \qmlproperty string XYSeries::pointLabelsFormat - The \a format used for showing labels with series points. - - \sa QXYSeries::pointLabelsFormat, pointLabelsVisible, pointLabelsFont, pointLabelsColor -*/ -/*! - \fn void QXYSeries::pointLabelsFormatChanged(const QString &format) - Signal is emitted when the \a format of data point labels is changed. -*/ -/*! - \qmlsignal XYSeries::onPointLabelsFormatChanged(string format) - Signal is emitted when the \a format of data point labels is changed. -*/ - -/*! - \property QXYSeries::pointLabelsVisible - Defines the visibility for data point labels. False by default. - - \sa QXYSeries::pointLabelsFormat -*/ -/*! - \qmlproperty bool XYSeries::pointLabelsVisible - Defines the visibility for data point labels. - - \sa pointLabelsFormat -*/ -/*! - \fn void QXYSeries::pointLabelsVisibilityChanged(bool visible) - The visibility of the data point labels is changed to \a visible. -*/ -/*! - \qmlsignal XYSeries::onPointLabelsVisibilityChanged(bool visible) - The visibility of the data point labels is changed to \a visible. -*/ - -/*! - \property QXYSeries::pointLabelsFont - Defines the font used for data point labels. - - \sa QXYSeries::pointLabelsFormat -*/ -/*! - \qmlproperty font XYSeries::pointLabelsFont - Defines the font used for data point labels. - - \sa pointLabelsFormat -*/ -/*! - \fn void QXYSeries::pointLabelsFontChanged(const QFont &font); - The font used for data point labels is changed to \a font. -*/ -/*! - \qmlsignal XYSeries::onPointLabelsFontChanged(Font font) - The font used for data point labels is changed to \a font. -*/ - -/*! - \property QXYSeries::pointLabelsColor - Defines the color used for data point labels. By default, the color is the color of the brush - defined in theme for labels. - - \sa QXYSeries::pointLabelsFormat -*/ -/*! - \qmlproperty font XYSeries::pointLabelsColor - Defines the color used for data point labels. By default, the color is the color of the brush - defined in theme for labels. - - \sa pointLabelsFormat -*/ -/*! - \fn void QXYSeries::pointLabelsColorChanged(const QColor &color); - The color used for data point labels is changed to \a color. -*/ -/*! - \qmlsignal XYSeries::onPointLabelsColorChanged(Color color) - The color used for data point labels is changed to \a color. -*/ - -/*! - \fn void QXYSeries::clicked(const QPointF& point) - \brief Signal is emitted when user clicks the \a point on chart. -*/ -/*! - \qmlsignal XYSeries::onClicked(QPointF point) - Signal is emitted when user clicks the \a point on chart. For example: - \code - LineSeries { - XYPoint { x: 0; y: 0 } - XYPoint { x: 1.1; y: 2.1 } - onClicked: console.log("onClicked: " + point.x + ", " + point.y); - } - \endcode -*/ - -/*! - \fn void QXYSeries::hovered(const QPointF &point, bool state) - This signal is emitted when user has hovered over or away from the series. \a point shows the origin (coordinate) - of the hover event. \a state is true when user has hovered over the series and false when hover has moved away from - the series. -*/ -/*! - \qmlsignal XYSeries::onHovered(point point, bool state) - This signal is emitted when user has hovered over or away from the series. \a point shows the origin (coordinate) - of the hover event. \a state is true when user has hovered over the series and false when hover has moved away from - the series. -*/ - -/*! - \fn void QXYSeries::pointReplaced(int index) - Signal is emitted when a point has been replaced at \a index. - \sa replace() -*/ -/*! - \qmlsignal XYSeries::onPointReplaced(int index) - Signal is emitted when a point has been replaced at \a index. -*/ - -/*! - \fn void QXYSeries::pointsReplaced() - Signal is emitted when all points have been replaced with other points. - \sa replace() -*/ -/*! - \qmlsignal XYSeries::onPointsReplaced() -*/ - -/*! - \fn void QXYSeries::pointAdded(int index) - Signal is emitted when a point has been added at \a index. - \sa append(), insert() -*/ -/*! - \qmlsignal XYSeries::onPointAdded(int index) - Signal is emitted when a point has been added at \a index. -*/ - -/*! - \fn void QXYSeries::pointRemoved(int index) - Signal is emitted when a point has been removed from \a index. - \sa remove() -*/ -/*! - \qmlsignal XYSeries::onPointRemoved(int index) - Signal is emitted when a point has been removed from \a index. -*/ - -/*! - \fn void QXYSeries::colorChanged(QColor color) - \brief Signal is emitted when the line (pen) color has changed to \a color. -*/ -/*! - \qmlsignal XYSeries::onColorChanged(color color) - Signal is emitted when the line (pen) color has changed to \a color. -*/ - -/*! - \fn void QXYSeriesPrivate::updated() - \brief \internal -*/ - -/*! - \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. -*/ - -/*! - \internal - - Constructs empty series object which is a child of \a parent. - When series object is added to QChart instance ownerships is transferred. -*/ -QXYSeries::QXYSeries(QXYSeriesPrivate &d, QObject *parent) - : QAbstractSeries(d, parent) -{ -} - -/*! - Destroys the object. Series added to QChart instances are owned by those, - and are destroyed when QChart instances are destroyed. -*/ -QXYSeries::~QXYSeries() -{ -} - -/*! - Adds data point (\a x, \a y) to the series. - */ -void QXYSeries::append(qreal x, qreal y) -{ - append(QPointF(x, y)); -} - -/*! - This is an overloaded function. - Adds data \a point to the series. - */ -void QXYSeries::append(const QPointF &point) -{ - Q_D(QXYSeries); - - if (isValidValue(point)) { - d->m_points << point; - emit pointAdded(d->m_points.count() - 1); - } -} - -/*! - This is an overloaded function. - Adds list of data \a points to the series. - */ -void QXYSeries::append(const QList<QPointF> &points) -{ - foreach (const QPointF &point , points) - append(point); -} - -/*! - Replaces data point (\a oldX, \a oldY) with data point (\a newX, \a newY). - \sa QXYSeries::pointReplaced() -*/ -void QXYSeries::replace(qreal oldX, qreal oldY, qreal newX, qreal newY) -{ - replace(QPointF(oldX, oldY), QPointF(newX, newY)); -} - -/*! - Replaces \a oldPoint with \a newPoint. - \sa QXYSeries::pointReplaced() -*/ -void QXYSeries::replace(const QPointF &oldPoint, const QPointF &newPoint) -{ - Q_D(QXYSeries); - int index = d->m_points.indexOf(oldPoint); - if (index == -1) - return; - replace(index, newPoint); -} - -/*! - Replaces the point at \a index with data point (\a newX, \a newY). - \sa QXYSeries::pointReplaced() -*/ -void QXYSeries::replace(int index, qreal newX, qreal newY) -{ - replace(index, QPointF(newX, newY)); -} - -/*! - Replaces the point at \a index with \a newPoint. - \sa QXYSeries::pointReplaced() -*/ -void QXYSeries::replace(int index, const QPointF &newPoint) -{ - Q_D(QXYSeries); - if (isValidValue(newPoint)) { - d->m_points[index] = newPoint; - emit pointReplaced(index); - } -} - -/*! - Replaces the current points with \a points. - \note This is much faster than replacing data points one by one, - or first clearing all data, and then appending the new data. Emits QXYSeries::pointsReplaced() - when the points have been replaced. - \sa QXYSeries::pointsReplaced() -*/ -void QXYSeries::replace(QList<QPointF> points) -{ - Q_D(QXYSeries); - d->m_points = points.toVector(); - emit pointsReplaced(); -} - -/*! - Removes the point (\a x, \a y) from the series. -*/ -void QXYSeries::remove(qreal x, qreal y) -{ - remove(QPointF(x, y)); -} - -/*! - Removes the \a point from the series. -*/ -void QXYSeries::remove(const QPointF &point) -{ - Q_D(QXYSeries); - int index = d->m_points.indexOf(point); - if (index == -1) - return; - remove(index); -} - -/*! - Removes the point at \a index from the series. -*/ -void QXYSeries::remove(int index) -{ - Q_D(QXYSeries); - d->m_points.remove(index); - emit pointRemoved(index); -} - -/*! - Inserts a \a point in the series at \a index position. -*/ -void QXYSeries::insert(int index, const QPointF &point) -{ - Q_D(QXYSeries); - if (isValidValue(point)) { - d->m_points.insert(index, point); - emit pointAdded(index); - } -} - -/*! - Removes all points from the series. -*/ -void QXYSeries::clear() -{ - Q_D(QXYSeries); - for (int i = d->m_points.size() - 1; i >= 0; i--) - remove(d->m_points.at(i)); -} - -/*! - Returns list of points in the series. -*/ -QList<QPointF> QXYSeries::points() const -{ - Q_D(const QXYSeries); - return d->m_points.toList(); -} - -/*! - Returns point at \a index in internal points vector. -*/ -const QPointF &QXYSeries::at(int index) const -{ - Q_D(const QXYSeries); - return d->m_points.at(index); -} - -/*! - Returns number of data points within series. -*/ -int QXYSeries::count() const -{ - Q_D(const QXYSeries); - return d->m_points.count(); -} - - -/*! - Sets \a pen used for drawing points on the chart. If the pen is not defined, the - pen from chart theme is used. - \sa QChart::setTheme() -*/ -void QXYSeries::setPen(const QPen &pen) -{ - Q_D(QXYSeries); - if (d->m_pen != pen) { - bool emitColorChanged = d->m_pen.color() != pen.color(); - d->m_pen = pen; - emit d->updated(); - if (emitColorChanged) - emit colorChanged(pen.color()); - } -} - -QPen QXYSeries::pen() const -{ - Q_D(const QXYSeries); - if (d->m_pen == QChartPrivate::defaultPen()) - return QPen(); - else - return d->m_pen; -} - -/*! - Sets \a brush used for drawing points on the chart. If the brush is not defined, brush - from chart theme setting is used. - \sa QChart::setTheme() -*/ -void QXYSeries::setBrush(const QBrush &brush) -{ - Q_D(QXYSeries); - if (d->m_brush != brush) { - d->m_brush = brush; - emit d->updated(); - } -} - -QBrush QXYSeries::brush() const -{ - Q_D(const QXYSeries); - if (d->m_brush == QChartPrivate::defaultBrush()) - return QBrush(); - else - return d->m_brush; -} - -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(); -} - -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; -} - -void QXYSeries::setPointLabelsFormat(const QString &format) -{ - Q_D(QXYSeries); - if (d->m_pointLabelsFormat != format) { - d->m_pointLabelsFormat = format; - emit pointLabelsFormatChanged(format); - } -} - -QString QXYSeries::pointLabelsFormat() const -{ - Q_D(const QXYSeries); - return d->m_pointLabelsFormat; -} - -void QXYSeries::setPointLabelsVisible(bool visible) -{ - Q_D(QXYSeries); - if (d->m_pointLabelsVisible != visible) { - d->m_pointLabelsVisible = visible; - emit pointLabelsVisibilityChanged(visible); - } -} - -bool QXYSeries::pointLabelsVisible() const -{ - Q_D(const QXYSeries); - return d->m_pointLabelsVisible; -} - -void QXYSeries::setPointLabelsFont(const QFont &font) -{ - Q_D(QXYSeries); - if (d->m_pointLabelsFont != font) { - d->m_pointLabelsFont = font; - emit pointLabelsFontChanged(font); - } -} - -QFont QXYSeries::pointLabelsFont() const -{ - Q_D(const QXYSeries); - return d->m_pointLabelsFont; -} - -void QXYSeries::setPointLabelsColor(const QColor &color) -{ - Q_D(QXYSeries); - if (d->m_pointLabelsColor != color) { - d->m_pointLabelsColor = color; - emit pointLabelsColorChanged(color); - } -} - -QColor QXYSeries::pointLabelsColor() const -{ - Q_D(const QXYSeries); - if (d->m_pointLabelsColor == QChartPrivate::defaultPen().color()) - return QPen().color(); - else - return d->m_pointLabelsColor; -} - -/*! - Stream operator for adding a data \a point to the series. - \sa append() -*/ -QXYSeries &QXYSeries::operator<< (const QPointF &point) -{ - append(point); - return *this; -} - - -/*! - Stream operator for adding a list of \a points to the series. - \sa append() -*/ - -QXYSeries &QXYSeries::operator<< (const QList<QPointF>& points) -{ - append(points); - return *this; -} - -////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////// - - -QXYSeriesPrivate::QXYSeriesPrivate(QXYSeries *q) - : QAbstractSeriesPrivate(q), - m_pen(QChartPrivate::defaultPen()), - m_brush(QChartPrivate::defaultBrush()), - m_pointsVisible(false), - m_pointLabelsFormat(QLatin1String("@xPoint, @yPoint")), - m_pointLabelsVisible(false), - m_pointLabelsFont(QChartPrivate::defaultFont()), - m_pointLabelsColor(QChartPrivate::defaultPen().color()) -{ -} - -void QXYSeriesPrivate::initializeDomain() -{ - qreal minX(0); - qreal minY(0); - qreal maxX(1); - qreal maxY(1); - - Q_Q(QXYSeries); - - const QList<QPointF>& points = q->points(); - - if (!points.isEmpty()) { - minX = points[0].x(); - minY = points[0].y(); - maxX = minX; - maxY = minY; - - for (int i = 0; i < points.count(); i++) { - 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); - } - } - - domain()->setRange(minX, maxX, minY, maxY); -} - -QList<QLegendMarker*> QXYSeriesPrivate::createLegendMarkers(QLegend* legend) -{ - Q_Q(QXYSeries); - QList<QLegendMarker*> list; - return list << new QXYLegendMarker(q,legend); -} - -void QXYSeriesPrivate::initializeAxes() -{ - -} - -QAbstractAxis::AxisType QXYSeriesPrivate::defaultAxisType(Qt::Orientation orientation) const -{ - Q_UNUSED(orientation); - return QAbstractAxis::AxisTypeValue; -} - -QAbstractAxis* QXYSeriesPrivate::createDefaultAxis(Qt::Orientation orientation) const -{ - Q_UNUSED(orientation); - return new QValueAxis; -} - -void QXYSeriesPrivate::initializeAnimations(QtCommercialChart::QChart::AnimationOptions options) -{ - XYChart *item = static_cast<XYChart *>(m_item.data()); - Q_ASSERT(item); - if (item->animation()) - item->animation()->stopAndDestroyLater(); - - if (options.testFlag(QChart::SeriesAnimations)) - item->setAnimation(new XYAnimation(item)); - else - item->setAnimation(0); - QAbstractSeriesPrivate::initializeAnimations(options); -} - -void QXYSeriesPrivate::drawSeriesPointLabels(QPainter *painter, const QVector<QPointF> &points, - const int offset) -{ - static const QString xPointTag(QLatin1String("@xPoint")); - static const QString yPointTag(QLatin1String("@yPoint")); - const int labelOffset = offset + 2; - - painter->setFont(m_pointLabelsFont); - painter->setPen(QPen(m_pointLabelsColor)); - QFontMetrics fm(painter->font()); - - for (int i(0); i < m_points.size(); i++) { - QString pointLabel = m_pointLabelsFormat; - pointLabel.replace(xPointTag, presenter()->numberToString(m_points.at(i).x())); - pointLabel.replace(yPointTag, presenter()->numberToString(m_points.at(i).y())); - - // Position text in relation to the point - int pointLabelWidth = fm.width(pointLabel); - QPointF position(points.at(i)); - position.setX(position.x() - pointLabelWidth / 2); - position.setY(position.y() - labelOffset); - - painter->drawText(position, pointLabel); - } -} - -#include "moc_qxyseries.cpp" -#include "moc_qxyseries_p.cpp" - -QTCOMMERCIALCHART_END_NAMESPACE |