|
|
#include "qxyseries.h"
|
|
|
|
|
|
QTCOMMERCIALCHART_BEGIN_NAMESPACE
|
|
|
|
|
|
/*!
|
|
|
\class QXYSeries
|
|
|
\brief The QXYSeries class is used for making line charts.
|
|
|
|
|
|
\mainclass
|
|
|
|
|
|
A line chart is used to show information as a series of data points
|
|
|
connected by straight lines.
|
|
|
|
|
|
\image linechart.png
|
|
|
|
|
|
Creating basic line chart is simple:
|
|
|
\code
|
|
|
QXYSeries* series = new QXYSeries();
|
|
|
series->add(0, 6);
|
|
|
series->add(2, 4);
|
|
|
...
|
|
|
chartView->addSeries(series);
|
|
|
\endcode
|
|
|
*/
|
|
|
|
|
|
/*!
|
|
|
\fn virtual QSeriesType QXYSeries::type() const
|
|
|
\brief Returns type of series.
|
|
|
\sa QSeries, QSeriesType
|
|
|
*/
|
|
|
|
|
|
/*!
|
|
|
\fn QPen QXYSeries::pen() const
|
|
|
\brief Returns the pen used to draw line for this series.
|
|
|
\sa setPen()
|
|
|
*/
|
|
|
|
|
|
/*!
|
|
|
\fn bool QXYSeries::pointsVisible() const
|
|
|
\brief Returns if the points are drawn for this series.
|
|
|
\sa setPointsVisible()
|
|
|
*/
|
|
|
|
|
|
|
|
|
/*!
|
|
|
\fn void QXYSeries::pointReplaced(int index)
|
|
|
\brief \internal \a index
|
|
|
*/
|
|
|
|
|
|
/*!
|
|
|
\fn void QXYSeries::pointAdded(int index)
|
|
|
\brief \internal \a index
|
|
|
*/
|
|
|
|
|
|
/*!
|
|
|
\fn void QXYSeries::pointRemoved(int index)
|
|
|
\brief \internal \a index
|
|
|
*/
|
|
|
|
|
|
/*!
|
|
|
\fn void QXYSeries::updated()
|
|
|
\brief \internal
|
|
|
*/
|
|
|
|
|
|
/*!
|
|
|
Constructs empty series object which is a child of \a parent.
|
|
|
When series object is added to QChartView or QChart instance ownerships is transfered.
|
|
|
*/
|
|
|
QXYSeries::QXYSeries(QObject* parent):QSeries(parent),
|
|
|
m_pointsVisible(false)
|
|
|
{
|
|
|
}
|
|
|
/*!
|
|
|
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.
|
|
|
*/
|
|
|
void QXYSeries::add(qreal x,qreal y)
|
|
|
{
|
|
|
Q_ASSERT(m_x.size() == m_y.size());
|
|
|
m_x<<x;
|
|
|
m_y<<y;
|
|
|
emit pointAdded(m_x.size()-1);
|
|
|
}
|
|
|
|
|
|
/*!
|
|
|
This is an overloaded function.
|
|
|
Adds data \a point to the series. Points are connected with lines on the chart.
|
|
|
*/
|
|
|
void QXYSeries::add(const QPointF& point)
|
|
|
{
|
|
|
add(point.x(),point.y());
|
|
|
}
|
|
|
|
|
|
/*!
|
|
|
Modifies \a y value for given \a x a value.
|
|
|
*/
|
|
|
void QXYSeries::replace(qreal x,qreal y)
|
|
|
{
|
|
|
int index = m_x.indexOf(x);
|
|
|
m_x[index]=x;
|
|
|
m_y[index]=y;
|
|
|
emit pointReplaced(index);
|
|
|
}
|
|
|
|
|
|
/*!
|
|
|
This is an overloaded function.
|
|
|
Replaces current y value of for given \a point x value with \a point y value.
|
|
|
*/
|
|
|
void QXYSeries::replace(const QPointF& point)
|
|
|
{
|
|
|
replace(point.x(),point.y());
|
|
|
}
|
|
|
|
|
|
/*!
|
|
|
Removes current \a x and y value.
|
|
|
*/
|
|
|
void QXYSeries::remove(qreal x)
|
|
|
{
|
|
|
int index = m_x.indexOf(x);
|
|
|
emit pointRemoved(index);
|
|
|
m_x.remove(index);
|
|
|
m_y.remove(index);
|
|
|
}
|
|
|
|
|
|
/*!
|
|
|
Removes current \a point x value. Note \a point y value is ignored.
|
|
|
*/
|
|
|
void QXYSeries::remove(const QPointF& point)
|
|
|
{
|
|
|
remove(point.x());
|
|
|
}
|
|
|
|
|
|
/*!
|
|
|
Clears all the data.
|
|
|
*/
|
|
|
void QXYSeries::clear()
|
|
|
{
|
|
|
m_x.clear();
|
|
|
m_y.clear();
|
|
|
}
|
|
|
|
|
|
/*!
|
|
|
\internal \a pos
|
|
|
*/
|
|
|
qreal QXYSeries::x(int pos) const
|
|
|
{
|
|
|
return m_x.at(pos);
|
|
|
}
|
|
|
|
|
|
/*!
|
|
|
\internal \a pos
|
|
|
*/
|
|
|
qreal QXYSeries::y(int pos) const
|
|
|
{
|
|
|
return m_y.at(pos);
|
|
|
}
|
|
|
|
|
|
/*!
|
|
|
Returns number of data points within series.
|
|
|
*/
|
|
|
int QXYSeries::count() const
|
|
|
{
|
|
|
Q_ASSERT(m_x.size() == m_y.size());
|
|
|
|
|
|
return m_x.size();
|
|
|
|
|
|
}
|
|
|
|
|
|
/*!
|
|
|
Sets \a pen used for drawing given series..
|
|
|
*/
|
|
|
void QXYSeries::setPen(const QPen& pen)
|
|
|
{
|
|
|
if(pen!=m_pen){
|
|
|
m_pen=pen;
|
|
|
emit updated();
|
|
|
}
|
|
|
}
|
|
|
|
|
|
/*!
|
|
|
Sets if data points are \a visible and should be drawn on line.
|
|
|
*/
|
|
|
void QXYSeries::setPointsVisible(bool visible)
|
|
|
{
|
|
|
if(m_pointsVisible!=visible){
|
|
|
m_pointsVisible=visible;
|
|
|
emit updated();
|
|
|
}
|
|
|
}
|
|
|
|
|
|
|
|
|
/*!
|
|
|
Stream operator for adding a data \a point to the series.
|
|
|
\sa add()
|
|
|
*/
|
|
|
|
|
|
QXYSeries& QXYSeries::operator<< (const QPointF &point)
|
|
|
{
|
|
|
add(point);
|
|
|
return *this;
|
|
|
}
|
|
|
|
|
|
|
|
|
#include "moc_qxyseries.cpp"
|
|
|
|
|
|
QTCOMMERCIALCHART_END_NAMESPACE
|
|
|
|
