qxyseries.cpp
991 lines
| 26.5 KiB
| text/x-c
|
CppLexer
|
r2854 | /**************************************************************************** | ||
|
r794 | ** | ||
|
r2854 | ** Copyright (C) 2016 The Qt Company Ltd. | ||
** Contact: https://www.qt.io/licensing/ | ||||
|
r794 | ** | ||
|
r2854 | ** This file is part of the Qt Charts module of the Qt Toolkit. | ||
|
r794 | ** | ||
|
r2854 | ** $QT_BEGIN_LICENSE:GPL$ | ||
|
r2845 | ** Commercial License Usage | ||
** Licensees holding valid commercial Qt licenses may use this file in | ||||
** accordance with the commercial license agreement provided with the | ||||
** Software or, alternatively, in accordance with the terms contained in | ||||
** a written agreement between you and The Qt Company. For licensing terms | ||||
|
r2854 | ** and conditions see https://www.qt.io/terms-conditions. For further | ||
** information use the contact form at https://www.qt.io/contact-us. | ||||
** | ||||
** GNU General Public License Usage | ||||
** Alternatively, this file may be used under the terms of the GNU | ||||
** General Public License version 3 or (at your option) any later version | ||||
** approved by the KDE Free Qt Foundation. The licenses are as published by | ||||
** the Free Software Foundation and appearing in the file LICENSE.GPL3 | ||||
** included in the packaging of this file. Please review the following | ||||
** information to ensure the GNU General Public License requirements will | ||||
** be met: https://www.gnu.org/licenses/gpl-3.0.html. | ||||
|
r794 | ** | ||
|
r2845 | ** $QT_END_LICENSE$ | ||
** | ||||
|
r2854 | ****************************************************************************/ | ||
|
r794 | |||
|
r2714 | #include <QtCharts/QXYSeries> | ||
#include <private/qxyseries_p.h> | ||||
#include <private/abstractdomain_p.h> | ||||
#include <QtCharts/QValueAxis> | ||||
#include <private/xychart_p.h> | ||||
#include <QtCharts/QXYLegendMarker> | ||||
#include <private/charthelpers_p.h> | ||||
#include <private/qchart_p.h> | ||||
#include <QtGui/QPainter> | ||||
|
r2175 | |||
|
r2712 | QT_CHARTS_BEGIN_NAMESPACE | ||
|
r466 | |||
/*! | ||||
\class QXYSeries | ||||
|
r2639 | \inmodule Qt Charts | ||
|
r470 | \brief The QXYSeries class is a base class for line, spline and scatter series. | ||
|
r466 | */ | ||
|
r1491 | /*! | ||
|
r2639 | \qmltype XYSeries | ||
\instantiates QXYSeries | ||||
|
r2712 | \inqmlmodule QtCharts | ||
|
r1491 | |||
|
r2712 | \inherits AbstractSeries | ||
\brief The XYSeries type is a base type for line, spline and scatter series. | ||||
|
r2639 | |||
|
r2712 | The XYSeries class is a base class for line, spline and scatter series. | ||
The class cannot be instantiated directly. | ||||
|
r2639 | */ | ||
|
r466 | |||
|
r2331 | /*! | ||
\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 | ||||
*/ | ||||
|
r2483 | /*! | ||
\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 | ||||
*/ | ||||
|
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. | ||||
|
r2805 | \sa pen(), brush() | ||
|
r1491 | */ | ||
/*! | ||||
\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 | */ | ||
|
r2689 | /*! | ||
\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. | ||||
|
r2805 | \sa pointLabelsVisible, pointLabelsFont, pointLabelsColor | ||
|
r2689 | */ | ||
/*! | ||||
\qmlproperty string XYSeries::pointLabelsFormat | ||||
The \a format used for showing labels with series points. | ||||
|
r2805 | \sa pointLabelsFormat, pointLabelsVisible, pointLabelsFont, pointLabelsColor | ||
|
r2689 | */ | ||
/*! | ||||
\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. | ||||
|
r2815 | \sa pointLabelsFormat, pointLabelsClipping | ||
|
r2689 | */ | ||
/*! | ||||
\qmlproperty bool XYSeries::pointLabelsVisible | ||||
Defines the visibility for data point labels. | ||||
|
r2815 | \sa pointLabelsFormat, pointLabelsClipping | ||
|
r2689 | */ | ||
/*! | ||||
\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. | ||||
|
r2805 | \sa pointLabelsFormat | ||
|
r2689 | */ | ||
/*! | ||||
\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. | ||||
|
r2805 | \sa pointLabelsFormat | ||
|
r2689 | */ | ||
/*! | ||||
\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. | ||||
*/ | ||||
|
r2815 | /*! | ||
\property QXYSeries::pointLabelsClipping | ||||
Defines the clipping for data point labels. True by default. The labels on the edge of the plot | ||||
area are cut when clipping is enabled. | ||||
\sa pointLabelsVisible | ||||
*/ | ||||
/*! | ||||
\qmlproperty bool XYSeries::pointLabelsClipping | ||||
Defines the clipping for data point labels. True by default. The labels on the edge of the plot | ||||
area are cut when clipping is enabled. | ||||
\sa pointLabelsVisible | ||||
*/ | ||||
/*! | ||||
|
r2820 | \fn void QXYSeries::pointLabelsClippingChanged(bool clipping) | ||
|
r2815 | The clipping of the data point labels is changed to \a clipping. | ||
*/ | ||||
/*! | ||||
\qmlsignal XYSeries::onPointLabelsClippingChanged(bool clipping) | ||||
The clipping of the data point labels is changed to \a clipping. | ||||
*/ | ||||
|
r574 | /*! | ||
\fn void QXYSeries::clicked(const QPointF& point) | ||||
|
r2746 | \brief Signal is emitted when user clicks the \a point on chart. The \a point is the point | ||
where the press was triggered. | ||||
\sa pressed, released, doubleClicked | ||||
|
r574 | */ | ||
|
r1491 | /*! | ||
\qmlsignal XYSeries::onClicked(QPointF point) | ||||
|
r2746 | Signal is emitted when user clicks the \a point on chart. The \a point is the point where the | ||
press was triggered. For example: | ||||
|
r1491 | \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 | ||||
|
r2746 | \sa onPressed, onReleased, onDoubleClicked | ||
|
r1491 | */ | ||
|
r574 | |||
|
r2362 | /*! | ||
\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. | ||||
*/ | ||||
|
r2739 | /*! | ||
\fn void QXYSeries::pressed(const QPointF& point) | ||||
\brief Signal is emitted when user presses the \a point on chart. | ||||
|
r2746 | \sa clicked, released, doubleClicked | ||
|
r2739 | */ | ||
/*! | ||||
\qmlsignal XYSeries::onPressed(QPointF point) | ||||
Signal is emitted when user presses the \a point on chart. For example: | ||||
\code | ||||
LineSeries { | ||||
XYPoint { x: 0; y: 0 } | ||||
XYPoint { x: 1.1; y: 2.1 } | ||||
onPressed: console.log("onPressed: " + point.x + ", " + point.y); | ||||
} | ||||
\endcode | ||||
|
r2746 | \sa onClicked, onReleased, onDoubleClicked | ||
|
r2739 | */ | ||
/*! | ||||
\fn void QXYSeries::released(const QPointF& point) | ||||
|
r2746 | \brief Signal is emitted when user releases a press that was triggered on a \a point on chart. | ||
\sa pressed, clicked, doubleClicked | ||||
|
r2739 | */ | ||
/*! | ||||
\qmlsignal XYSeries::onReleased(QPointF point) | ||||
|
r2746 | Signal is emitted when user releases a press that was triggered on a \a point on chart. | ||
For example: | ||||
|
r2739 | \code | ||
LineSeries { | ||||
XYPoint { x: 0; y: 0 } | ||||
XYPoint { x: 1.1; y: 2.1 } | ||||
onReleased: console.log("onReleased: " + point.x + ", " + point.y); | ||||
} | ||||
\endcode | ||||
|
r2746 | \sa onPressed, onClicked, onDoubleClicked | ||
|
r2739 | */ | ||
/*! | ||||
\fn void QXYSeries::doubleClicked(const QPointF& point) | ||||
|
r2746 | \brief Signal is emitted when user doubleclicks the \a point on chart. The \a point is the | ||
point where the first press was triggered. | ||||
\sa pressed, released, clicked | ||||
|
r2739 | */ | ||
/*! | ||||
\qmlsignal XYSeries::onDoubleClicked(QPointF point) | ||||
|
r2746 | Signal is emitted when user doubleclicks the \a point on chart. The \a point is the point where | ||
the first press was triggered. For example: | ||||
|
r2739 | \code | ||
LineSeries { | ||||
XYPoint { x: 0; y: 0 } | ||||
XYPoint { x: 1.1; y: 2.1 } | ||||
onDoubleClicked: console.log("onDoubleClicked: " + point.x + ", " + point.y); | ||||
} | ||||
\endcode | ||||
|
r2746 | \sa onPressed, onReleased, onClicked | ||
|
r2739 | */ | ||
|
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 | |||
|
r1783 | /*! | ||
\fn void QXYSeries::pointsReplaced() | ||||
|
r2494 | Signal is emitted when all points have been replaced with other points. | ||
|
r1783 | \sa replace() | ||
*/ | ||||
/*! | ||||
\qmlsignal XYSeries::onPointsReplaced() | ||||
|
r2770 | Signal is emitted when all points have been replaced with other points. | ||
|
r1783 | */ | ||
|
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 | */ | ||
|
r2739 | |||
|
r1491 | /*! | ||
|
r1531 | \qmlsignal XYSeries::onPointRemoved(int index) | ||
|
r1491 | Signal is emitted when a point has been removed from \a index. | ||
*/ | ||||
|
r466 | |||
|
r2805 | /*! | ||
\fn void QXYSeries::pointsRemoved(int index, int count) | ||||
Signal is emitted when a \a count of points has been removed starting at \a index. | ||||
\sa removePoints(), clear() | ||||
*/ | ||||
/*! | ||||
\qmlsignal XYSeries::onPointsRemoved(int index, int count) | ||||
Signal is emitted when a \a count of points has been removed starting at \a index. | ||||
*/ | ||||
|
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 | |||
|
r2820 | /*! | ||
\fn void QXYSeries::penChanged(const QPen &pen) | ||||
\brief Signal is emitted when the line pen has changed to \a pen. | ||||
*/ | ||||
|
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. | ||||
*/ | ||||
|
r2805 | /*! | ||
\qmlmethod XYSeries::remove(int index) | ||||
Removes a point from the series at \a index. | ||||
*/ | ||||
/*! | ||||
\qmlmethod XYSeries::removePoints(int index, int count) | ||||
Removes \a count points from the series starting at \a index. | ||||
*/ | ||||
|
r1521 | /*! | ||
\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. | ||
|
r2494 | When series object is added to QChart instance ownerships is transferred. | ||
|
r466 | */ | ||
|
r2097 | QXYSeries::QXYSeries(QXYSeriesPrivate &d, QObject *parent) | ||
: QAbstractSeries(d, parent) | ||||
|
r938 | { | ||
|
r466 | } | ||
|
r1342 | |||
|
r466 | /*! | ||
|
r2494 | Destroys the object. Series added to QChart instances are owned by those, | ||
and are destroyed when QChart instances are destroyed. | ||||
|
r466 | */ | ||
QXYSeries::~QXYSeries() | ||||
{ | ||||
} | ||||
/*! | ||||
|
r2494 | Adds data point (\a x, \a y) to the series. | ||
|
r466 | */ | ||
|
r2097 | void QXYSeries::append(qreal x, qreal y) | ||
|
r466 | { | ||
|
r2097 | append(QPointF(x, y)); | ||
|
r466 | } | ||
/*! | ||||
This is an overloaded function. | ||||
|
r2494 | Adds data \a point to the series. | ||
|
r466 | */ | ||
|
r796 | void QXYSeries::append(const QPointF &point) | ||
|
r466 | { | ||
|
r1057 | Q_D(QXYSeries); | ||
|
r2424 | |||
if (isValidValue(point)) { | ||||
d->m_points << point; | ||||
emit pointAdded(d->m_points.count() - 1); | ||||
} | ||||
|
r466 | } | ||
|
r481 | /*! | ||
This is an overloaded function. | ||||
|
r2494 | Adds list of data \a points to the series. | ||
|
r481 | */ | ||
|
r1057 | void QXYSeries::append(const QList<QPointF> &points) | ||
|
r481 | { | ||
|
r2097 | foreach (const QPointF &point , points) | ||
|
r1057 | append(point); | ||
|
r481 | } | ||
|
r1336 | /*! | ||
|
r2494 | Replaces data point (\a oldX, \a oldY) with data point (\a newX, \a newY). | ||
|
r2805 | \sa pointReplaced() | ||
|
r1336 | */ | ||
|
r2097 | void QXYSeries::replace(qreal oldX, qreal oldY, qreal newX, qreal newY) | ||
|
r466 | { | ||
|
r2097 | replace(QPointF(oldX, oldY), QPointF(newX, newY)); | ||
|
r466 | } | ||
|
r1336 | /*! | ||
Replaces \a oldPoint with \a newPoint. | ||||
|
r2805 | \sa pointReplaced() | ||
|
r1336 | */ | ||
|
r2097 | void QXYSeries::replace(const QPointF &oldPoint, const QPointF &newPoint) | ||
|
r622 | { | ||
|
r938 | Q_D(QXYSeries); | ||
|
r1057 | int index = d->m_points.indexOf(oldPoint); | ||
|
r2097 | if (index == -1) | ||
return; | ||||
|
r2496 | replace(index, newPoint); | ||
} | ||||
|
r2503 | /*! | ||
Replaces the point at \a index with data point (\a newX, \a newY). | ||||
|
r2805 | \sa pointReplaced() | ||
|
r2503 | */ | ||
|
r2496 | void QXYSeries::replace(int index, qreal newX, qreal newY) | ||
{ | ||||
replace(index, QPointF(newX, newY)); | ||||
} | ||||
|
r2503 | /*! | ||
Replaces the point at \a index with \a newPoint. | ||||
|
r2805 | \sa pointReplaced() | ||
|
r2503 | */ | ||
|
r2496 | void QXYSeries::replace(int index, const QPointF &newPoint) | ||
{ | ||||
Q_D(QXYSeries); | ||||
|
r2424 | if (isValidValue(newPoint)) { | ||
d->m_points[index] = newPoint; | ||||
emit pointReplaced(index); | ||||
} | ||||
|
r622 | } | ||
|
r1783 | /*! | ||
|
r2494 | Replaces the current points with \a points. | ||
\note This is much faster than replacing data points one by one, | ||||
|
r1783 | or first clearing all data, and then appending the new data. Emits QXYSeries::pointsReplaced() | ||
|
r2798 | when the points have been replaced. However, note that using the overload that takes | ||
|
r2820 | \c{QVector<QPointF>} as parameter is faster than using this overload. | ||
|
r2805 | \sa pointsReplaced() | ||
|
r1783 | */ | ||
void QXYSeries::replace(QList<QPointF> points) | ||||
|
r2798 | { | ||
replace(points.toVector()); | ||||
} | ||||
/*! | ||||
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. | ||||
|
r2805 | \sa pointsReplaced() | ||
|
r2798 | */ | ||
void QXYSeries::replace(QVector<QPointF> points) | ||||
|
r1783 | { | ||
Q_D(QXYSeries); | ||||
|
r2798 | d->m_points = points; | ||
|
r1783 | emit pointsReplaced(); | ||
} | ||||
|
r466 | /*! | ||
|
r2494 | Removes the point (\a x, \a y) from the series. | ||
|
r2805 | \sa pointRemoved() | ||
|
r466 | */ | ||
|
r2097 | void QXYSeries::remove(qreal x, qreal y) | ||
|
r466 | { | ||
|
r2097 | remove(QPointF(x, y)); | ||
|
r466 | } | ||
/*! | ||||
|
r2494 | Removes the \a point from the series. | ||
|
r2805 | \sa pointRemoved() | ||
|
r466 | */ | ||
|
r743 | void QXYSeries::remove(const QPointF &point) | ||
|
r466 | { | ||
|
r1057 | Q_D(QXYSeries); | ||
int index = d->m_points.indexOf(point); | ||||
|
r2097 | if (index == -1) | ||
return; | ||||
|
r2496 | remove(index); | ||
} | ||||
|
r2503 | /*! | ||
Removes the point at \a index from the series. | ||||
|
r2805 | \sa pointRemoved() | ||
|
r2503 | */ | ||
|
r2496 | void QXYSeries::remove(int index) | ||
{ | ||||
Q_D(QXYSeries); | ||||
|
r1057 | d->m_points.remove(index); | ||
|
r1262 | emit pointRemoved(index); | ||
|
r466 | } | ||
|
r2805 | /*! | ||
Removes \a count number of points from the series starting at \a index. | ||||
\sa pointsRemoved() | ||||
*/ | ||||
void QXYSeries::removePoints(int index, int count) | ||||
{ | ||||
// This function doesn't overload remove as there is chance for it to get mixed up with | ||||
// remove(qreal, qreal) overload in some implicit casting cases. | ||||
Q_D(QXYSeries); | ||||
if (count > 0) { | ||||
d->m_points.remove(index, count); | ||||
emit pointsRemoved(index, count); | ||||
} | ||||
} | ||||
|
r1336 | /*! | ||
Inserts a \a point in the series at \a index position. | ||||
|
r2805 | \sa pointAdded() | ||
|
r1336 | */ | ||
|
r1256 | void QXYSeries::insert(int index, const QPointF &point) | ||
{ | ||||
Q_D(QXYSeries); | ||||
|
r2424 | if (isValidValue(point)) { | ||
|
r2772 | index = qMax(0, qMin(index, d->m_points.size())); | ||
|
r2424 | d->m_points.insert(index, point); | ||
emit pointAdded(index); | ||||
} | ||||
|
r1256 | } | ||
|
r1336 | /*! | ||
|
r2805 | Removes all points from the series. | ||
\sa pointsRemoved() | ||||
|
r1336 | */ | ||
|
r1256 | void QXYSeries::clear() | ||
{ | ||||
Q_D(QXYSeries); | ||||
|
r2805 | removePoints(0, d->m_points.size()); | ||
|
r1256 | } | ||
|
r466 | /*! | ||
|
r2820 | Returns the points in the series as a list. | ||
Use QXYSeries::pointsVector() for better performance. | ||||
|
r466 | */ | ||
|
r1057 | QList<QPointF> QXYSeries::points() const | ||
|
r466 | { | ||
|
r938 | Q_D(const QXYSeries); | ||
|
r1230 | return d->m_points.toList(); | ||
|
r466 | } | ||
|
r2820 | /*! | ||
Returns the points in the series as a vector. | ||||
This is more efficient that calling QXYSeries::points(); | ||||
*/ | ||||
QVector<QPointF> QXYSeries::pointsVector() const | ||||
{ | ||||
Q_D(const QXYSeries); | ||||
return d->m_points; | ||||
} | ||||
|
r2483 | /*! | ||
Returns point at \a index in internal points vector. | ||||
*/ | ||||
|
r2491 | const QPointF &QXYSeries::at(int index) const | ||
|
r2483 | { | ||
Q_D(const QXYSeries); | ||||
return d->m_points.at(index); | ||||
} | ||||
|
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()); | ||||
|
r2820 | emit penChanged(pen); | ||
|
r467 | } | ||
} | ||||
|
r938 | QPen QXYSeries::pen() const | ||
{ | ||||
Q_D(const QXYSeries); | ||||
|
r2519 | if (d->m_pen == QChartPrivate::defaultPen()) | ||
return QPen(); | ||||
else | ||||
return d->m_pen; | ||||
|
r938 | } | ||
|
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); | ||
|
r2097 | if (d->m_brush != brush) { | ||
|
r938 | d->m_brush = brush; | ||
emit d->updated(); | ||||
|
r467 | } | ||
} | ||||
|
r938 | QBrush QXYSeries::brush() const | ||
{ | ||||
Q_D(const QXYSeries); | ||||
|
r2519 | if (d->m_brush == QChartPrivate::defaultBrush()) | ||
return QBrush(); | ||||
else | ||||
return d->m_brush; | ||||
|
r938 | } | ||
|
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); | ||||
|
r2097 | if (d->m_pointsVisible != visible) { | ||
|
r938 | d->m_pointsVisible = visible; | ||
emit d->updated(); | ||||
} | ||||
} | ||||
bool QXYSeries::pointsVisible() const | ||||
{ | ||||
Q_D(const QXYSeries); | ||||
return d->m_pointsVisible; | ||||
} | ||||
|
r2689 | 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; | ||||
} | ||||
|
r467 | |||
|
r2815 | void QXYSeries::setPointLabelsClipping(bool enabled) | ||
{ | ||||
Q_D(QXYSeries); | ||||
if (d->m_pointLabelsClipping != enabled) { | ||||
d->m_pointLabelsClipping = enabled; | ||||
emit pointLabelsClippingChanged(enabled); | ||||
} | ||||
} | ||||
bool QXYSeries::pointLabelsClipping() const | ||||
{ | ||||
Q_D(const QXYSeries); | ||||
return d->m_pointLabelsClipping; | ||||
} | ||||
|
r466 | /*! | ||
Stream operator for adding a data \a point to the series. | ||||
|
r796 | \sa append() | ||
|
r466 | */ | ||
|
r2104 | QXYSeries &QXYSeries::operator<< (const QPointF &point) | ||
|
r466 | { | ||
|
r796 | append(point); | ||
|
r466 | return *this; | ||
} | ||||
|
r481 | /*! | ||
Stream operator for adding a list of \a points to the series. | ||||
|
r796 | \sa append() | ||
|
r481 | */ | ||
|
r2104 | QXYSeries &QXYSeries::operator<< (const QList<QPointF>& points) | ||
|
r481 | { | ||
|
r796 | append(points); | ||
|
r481 | return *this; | ||
} | ||||
|
r938 | ////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////// | ||
|
r990 | |||
|
r2104 | QXYSeriesPrivate::QXYSeriesPrivate(QXYSeries *q) | ||
: QAbstractSeriesPrivate(q), | ||||
|
r2516 | m_pen(QChartPrivate::defaultPen()), | ||
m_brush(QChartPrivate::defaultBrush()), | ||||
|
r2689 | m_pointsVisible(false), | ||
m_pointLabelsFormat(QLatin1String("@xPoint, @yPoint")), | ||||
m_pointLabelsVisible(false), | ||||
m_pointLabelsFont(QChartPrivate::defaultFont()), | ||||
|
r2815 | m_pointLabelsColor(QChartPrivate::defaultPen().color()), | ||
m_pointLabelsClipping(true) | ||||
|
r938 | { | ||
} | ||||
|
r2273 | void QXYSeriesPrivate::initializeDomain() | ||
|
r943 | { | ||
|
r1740 | qreal minX(0); | ||
qreal minY(0); | ||||
qreal maxX(1); | ||||
qreal maxY(1); | ||||
|
r943 | |||
|
r1059 | Q_Q(QXYSeries); | ||
|
r1057 | |||
|
r2820 | const QVector<QPointF> &points = q->pointsVector(); | ||
|
r1070 | |||
|
r2097 | if (!points.isEmpty()) { | ||
|
r1740 | 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); | ||||
} | ||||
|
r1205 | } | ||
|
r2273 | domain()->setRange(minX, maxX, minY, maxY); | ||
|
r943 | } | ||
|
r2163 | QList<QLegendMarker*> QXYSeriesPrivate::createLegendMarkers(QLegend* legend) | ||
{ | ||||
|
r2175 | Q_Q(QXYSeries); | ||
|
r2163 | QList<QLegendMarker*> list; | ||
|
r2175 | return list << new QXYLegendMarker(q,legend); | ||
|
r2163 | } | ||
|
r2273 | void QXYSeriesPrivate::initializeAxes() | ||
|
r1556 | { | ||
|
r2273 | |||
|
r1556 | } | ||
|
r1695 | QAbstractAxis::AxisType QXYSeriesPrivate::defaultAxisType(Qt::Orientation orientation) const | ||
|
r1588 | { | ||
|
r1695 | Q_UNUSED(orientation); | ||
|
r1818 | return QAbstractAxis::AxisTypeValue; | ||
|
r1556 | } | ||
|
r2273 | QAbstractAxis* QXYSeriesPrivate::createDefaultAxis(Qt::Orientation orientation) const | ||
{ | ||||
Q_UNUSED(orientation); | ||||
|
r2614 | return new QValueAxis; | ||
|
r2273 | } | ||
|
r2804 | void QXYSeriesPrivate::initializeAnimations(QtCharts::QChart::AnimationOptions options, | ||
int duration, QEasingCurve &curve) | ||||
|
r2273 | { | ||
XYChart *item = static_cast<XYChart *>(m_item.data()); | ||||
Q_ASSERT(item); | ||||
|
r2555 | if (item->animation()) | ||
item->animation()->stopAndDestroyLater(); | ||||
if (options.testFlag(QChart::SeriesAnimations)) | ||||
|
r2804 | item->setAnimation(new XYAnimation(item, duration, curve)); | ||
|
r2555 | else | ||
|
r2273 | item->setAnimation(0); | ||
|
r2804 | QAbstractSeriesPrivate::initializeAnimations(options, duration, curve); | ||
|
r2273 | } | ||
|
r2696 | void QXYSeriesPrivate::drawSeriesPointLabels(QPainter *painter, const QVector<QPointF> &points, | ||
const int offset) | ||||
|
r2689 | { | ||
static const QString xPointTag(QLatin1String("@xPoint")); | ||||
static const QString yPointTag(QLatin1String("@yPoint")); | ||||
|
r2696 | const int labelOffset = offset + 2; | ||
|
r2689 | |||
painter->setFont(m_pointLabelsFont); | ||||
painter->setPen(QPen(m_pointLabelsColor)); | ||||
QFontMetrics fm(painter->font()); | ||||
|
r2779 | // m_points is used for the label here as it has the series point information | ||
// points variable passed is used for positioning because it has the coordinates | ||||
for (int i(0); i < m_points.size(); i++) { | ||||
|
r2689 | QString pointLabel = m_pointLabelsFormat; | ||
|
r2779 | pointLabel.replace(xPointTag, presenter()->numberToString(m_points.at(i).x())); | ||
pointLabel.replace(yPointTag, presenter()->numberToString(m_points.at(i).y())); | ||||
|
r2689 | |||
// Position text in relation to the point | ||||
int pointLabelWidth = fm.width(pointLabel); | ||||
QPointF position(points.at(i)); | ||||
|
r2781 | if (!reverseXAxis()) | ||
position.setX(position.x() - pointLabelWidth / 2); | ||||
else | ||||
position.setX(domain()->size().width() - position.x() - pointLabelWidth / 2); | ||||
if (!reverseYAxis()) | ||||
position.setY(position.y() - labelOffset); | ||||
else | ||||
position.setY(domain()->size().height() - position.y() - labelOffset); | ||||
|
r2689 | |||
painter->drawText(position, pointLabel); | ||||
} | ||||
} | ||||
|
r466 | #include "moc_qxyseries.cpp" | ||
|
r938 | #include "moc_qxyseries_p.cpp" | ||
|
r466 | |||
|
r2712 | QT_CHARTS_END_NAMESPACE | ||