##// END OF EJS Templates
Add assistant (qch) documentation generation...
Add assistant (qch) documentation generation Modified "docs" target to generate both html and qch documentation. "html_docs" target can be used if only html docs are required. Qch documentation is generated under "doc/qch" folder. Task-number: QTRD-1480 Reviewed-by: Mika Salmela

File last commit:

r2407:d108889b4c99
r2418:d84ad300b3d2
Show More
qchart.cpp
665 lines | 18.5 KiB | text/x-c | CppLexer
/****************************************************************************
**
** 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$
**
****************************************************************************/
#include "qchart.h"
#include "qchart_p.h"
#include "legendscroller_p.h"
#include "qlegend_p.h"
#include "chartbackground_p.h"
#include "qabstractaxis.h"
#include "chartlayout_p.h"
#include "charttheme_p.h"
#include "chartpresenter_p.h"
#include "chartdataset_p.h"
#include <QGraphicsScene>
#include <QGraphicsSceneResizeEvent>
QTCOMMERCIALCHART_BEGIN_NAMESPACE
/*!
\enum QChart::ChartTheme
This enum describes the theme used by the chart.
\value ChartThemeLight The default theme
\value ChartThemeBlueCerulean
\value ChartThemeDark
\value ChartThemeBrownSand
\value ChartThemeBlueNcs
\value ChartThemeHighContrast
\value ChartThemeBlueIcy
*/
/*!
\enum QChart::AnimationOption
For enabling/disabling animations. Defaults to NoAnimation.
\value NoAnimation
\value GridAxisAnimations
\value SeriesAnimations
\value AllAnimations
*/
/*!
\class QChart
\brief QtCommercial chart API.
QChart is a QGraphicsWidget that you can show in a QGraphicsScene. It manages the graphical
representation of different types of series and other chart related objects like
QAxis and QLegend. If you simply want to show a chart in a layout, you can use the
convenience class QChartView instead of QChart.
\sa QChartView
*/
/*!
\property QChart::animationOptions
The animation \a options for the chart. Animations are enabled/disabled based on this setting.
*/
/*!
\property QChart::backgroundVisible
Whether the chart background is visible or not.
\sa setBackgroundBrush(), setBackgroundPen()
*/
/*!
\property QChart::dropShadowEnabled
If set to true, the background drop shadow effect is enabled. If set to false, it is disabled. Note that the drop
shadow effect depends on theme, which means the setting may be changed if you switch to another theme.
*/
/*!
\property QChart::minimumMargins
Minimum margins between the plot area (axes) and the edge of the chart widget.
*/
/*!
\property QChart::margins
Minimum between the plot area (axes) and the edge of the chart widget.
*/
/*!
\property QChart::theme
Theme is a built-in collection of UI style related settings applied for all visual elements of a chart, like colors,
pens, brushes and fonts of series, axes, title and legend. \l {Chart themes demo} shows an example with a few
different themes.
Note: changing the theme will overwrite all customizations previously applied to the series.
*/
/*!
\property QChart::title
Title is the name (label) of a chart. It is shown as a headline on top of the chart.
*/
/*!
Constructs a chart object which is a child of a\a parent. Parameter \a wFlags is passed to the QGraphicsWidget constructor.
*/
QChart::QChart(QGraphicsItem *parent, Qt::WindowFlags wFlags)
: QGraphicsWidget(parent, wFlags),
d_ptr(new QChartPrivate(this))
{
d_ptr->m_legend = new LegendScroller(this);
setTheme(QChart::ChartThemeLight);
//TODO: what is that ?
//connect(d_ptr->m_presenter, SIGNAL(marginsChanged(QRectF)), this, SIGNAL(marginsChanged(QRectF)));
setLayout(d_ptr->m_presenter->layout());
}
/*!
Destroys the object and it's children, like series and axis objects added to it.
*/
QChart::~QChart()
{
//start by deleting dataset, it will remove all series and axes
delete d_ptr->m_dataset;
d_ptr->m_dataset = 0;
}
/*!
Adds the \a series onto the chart and takes the ownership of the object.
If auto scaling is enabled, re-scales the axes the series is bound to (both the x axis and
the y axis).
\sa removeSeries(), removeAllSeries()
*/
void QChart::addSeries(QAbstractSeries *series)
{
Q_ASSERT(series);
d_ptr->m_dataset->addSeries(series);
}
/*!
Removes the \a series specified in a perameter from the QChartView.
It releses its ownership of the specified QChartSeries object.
It does not delete the pointed QChartSeries data object
\sa addSeries(), removeAllSeries()
*/
void QChart::removeSeries(QAbstractSeries *series)
{
Q_ASSERT(series);
d_ptr->m_dataset->removeSeries(series);
}
/*!
Removes all the QChartSeries that have been added to the QChartView
It also deletes the pointed QChartSeries data objects
\sa addSeries(), removeSeries()
*/
void QChart::removeAllSeries()
{
foreach (QAbstractSeries *s , d_ptr->m_dataset->series()){
removeSeries(s);
delete s;
}
}
/*!
Sets the \a brush that is used for painting the background of the chart area.
*/
void QChart::setBackgroundBrush(const QBrush &brush)
{
d_ptr->m_presenter->setBackgroundBrush(brush);
}
/*!
Gets the brush that is used for painting the background of the chart area.
*/
QBrush QChart::backgroundBrush() const
{
return d_ptr->m_presenter->backgroundBrush();
}
/*!
Sets the \a pen that is used for painting the background of the chart area.
*/
void QChart::setBackgroundPen(const QPen &pen)
{
d_ptr->m_presenter->setBackgroundPen(pen);
}
/*!
Gets the pen that is used for painting the background of the chart area.
*/
QPen QChart::backgroundPen() const
{
return d_ptr->m_presenter->backgroundPen();
}
/*!
Sets the chart \a title. The description text that is drawn above the chart.
*/
void QChart::setTitle(const QString &title)
{
d_ptr->m_presenter->setTitle(title);
}
/*!
Returns the chart title. The description text that is drawn above the chart.
*/
QString QChart::title() const
{
return d_ptr->m_presenter->title();
}
/*!
Sets the \a font that is used for drawing the chart description text that is rendered above the chart.
*/
void QChart::setTitleFont(const QFont &font)
{
d_ptr->m_presenter->setTitleFont(font);
}
/*!
Gets the font that is used for drawing the chart description text that is rendered above the chart.
*/
QFont QChart::titleFont() const
{
return d_ptr->m_presenter->titleFont();
}
/*!
Sets the \a brush used for rendering the title text.
*/
void QChart::setTitleBrush(const QBrush &brush)
{
d_ptr->m_presenter->setTitleBrush(brush);
}
/*!
Returns the brush used for rendering the title text.
*/
QBrush QChart::titleBrush() const
{
return d_ptr->m_presenter->titleBrush();
}
void QChart::setTheme(QChart::ChartTheme theme)
{
d_ptr->m_themeManager->setTheme(theme);
}
QChart::ChartTheme QChart::theme() const
{
return d_ptr->m_themeManager->theme()->id();
}
/*!
Zooms in the view by a factor of 2
*/
void QChart::zoomIn()
{
d_ptr->zoomIn(2.0);
}
/*!
Zooms in the view to a maximum level at which \a rect is still fully visible.
*/
void QChart::zoomIn(const QRectF &rect)
{
d_ptr->zoomIn(rect);
}
/*!
Restores the view zoom level to the previous one.
*/
void QChart::zoomOut()
{
d_ptr->zoomOut(2.0);
}
/*!
Zooms in the view by a \a factor.
A factor over 1.0 zooms the view in and factor between 0.0 and 1.0 zooms out.
*/
void QChart::zoom(qreal factor)
{
if (qFuzzyCompare(factor, 0))
return;
if (qFuzzyCompare(factor, (qreal)1.0))
return;
if (factor < 0)
return;
if (factor > 1.0)
d_ptr->zoomIn(factor);
else
d_ptr->zoomOut(1.0 / factor);
}
/*!
Returns the pointer to the x axis object of the chart asociated with the specified \a series
If no series is provided then pointer to currently visible axis is provided
*/
QAbstractAxis *QChart::axisX(QAbstractSeries *series) const
{
QList<QAbstractAxis *> axisList = axes(Qt::Horizontal, series);
if (axisList.count())
return axisList[0];
return 0;
}
/*!
Returns the pointer to the y axis object of the chart asociated with the specified \a series
If no series is provided then pointer to currently visible axis is provided
*/
QAbstractAxis *QChart::axisY(QAbstractSeries *series) const
{
QList<QAbstractAxis *> axisList = axes(Qt::Vertical, series);
if (axisList.count())
return axisList[0];
return 0;
}
/*!
Returns the axes added for the \a series with \a orientation. If no series is provided, then all axes with the
specified orientation are returned.
\sa addAxis(), createDefaultAxes()
*/
QList<QAbstractAxis *> QChart::axes(Qt::Orientations orientation, QAbstractSeries *series) const
{
QList<QAbstractAxis *> result ;
if (series) {
foreach (QAbstractAxis *axis, series->attachedAxes()){
if (orientation.testFlag(axis->orientation()))
result << axis;
}
} else {
foreach (QAbstractAxis *axis, d_ptr->m_dataset->axes()){
if (orientation.testFlag(axis->orientation()) && !result.contains(axis))
result << axis;
}
}
return result;
}
/*!
NOTICE: This function has to be called after series has been added to the chart if no customized axes are set to the chart. Otherwise axisX(), axisY() calls return NULL.
Creates the axes for the chart based on the series that has already been added to the chart.
\table
\header
\o Series type
\o X-axis
\o Y-axis
\row
\o QXYSeries
\o QValueAxis
\o QValueAxis
\row
\o QBarSeries
\o QBarCategoryAxis
\o QValueAxis
\row
\o QPieSeries
\o None
\o None
\endtable
If there are several QXYSeries derived series added to the chart and no other series type has been added then only one pair of axes is created.
If there are sevaral series added of different types then each series gets its own axes pair.
NOTICE: if there is more than one x and y axes created then no axis is drawn by default and one needs to choose explicitly which axis should be shown.
Axis specifix to the series can be later obtained from the chart by providing the series as the parameter of axisX(), axisY() function calls.
QPieSeries does not create any axes.
\sa axisX(), axisY(), setAxisX(), setAxisY()
*/
void QChart::createDefaultAxes()
{
d_ptr->m_dataset->createDefaultAxes();
}
/*!
Returns the legend object of the chart. Ownership stays in chart.
*/
QLegend *QChart::legend() const
{
return d_ptr->m_legend;
}
/*!
Sets the minimum \a margins between the plot area (axes) and the edge of the chart widget.
Deprecated. Use setMargins().
*/
void QChart::setMinimumMargins(const QMargins &margins)
{
qWarning() << "QChart::setMinimumMargins is deprecated. Use QChart::setMargins instead.";
d_ptr->m_presenter->layout()->setMargins(margins);
}
/*!
Returns the rect that contains information about margins (distance between chart widget edge and axes).
Individual margins can be obtained by calling left, top, right, bottom on the returned rect.
Deprecated. Use margins().
*/
QMargins QChart::minimumMargins() const
{
qWarning() << "QChart::minimumMargins is deprecated. Use QChart::margins instead.";
return d_ptr->m_presenter->layout()->margins();
}
/*!
Sets the minimum \a margins between the plot area (axes) and the edge of the chart widget.
*/
void QChart::setMargins(const QMargins &margins)
{
d_ptr->m_presenter->layout()->setMargins(margins);
}
/*!
Returns the rect that contains information about margins (distance between chart widget edge and axes).
Individual margins can be obtained by calling left, top, right, bottom on the returned rect.
*/
QMargins QChart::margins() const
{
return d_ptr->m_presenter->layout()->margins();
}
/*!
Returns the the rect within which the drawing of the chart is done.
It does not include the area defines by margins.
*/
QRectF QChart::plotArea() const
{
return d_ptr->m_presenter->geometry();
}
///*!
// TODO: Dummy.
// Adjest the ranges of the axes so that all the data of the specified \a series is visible
// */
//void QChart::adjustViewToSeries(QAbstractSeries* series)
//{
// //
//}
/*!
Sets animation \a options for the chart
*/
void QChart::setAnimationOptions(AnimationOptions options)
{
d_ptr->m_presenter->setAnimationOptions(options);
}
QChart::AnimationOptions QChart::animationOptions() const
{
return d_ptr->m_presenter->animationOptions();
}
/*!
Scrolls the visible area of the chart by the distance defined in the \a dx and \a dy.
*/
void QChart::scroll(qreal dx, qreal dy)
{
d_ptr->scroll(dx,dy);
}
void QChart::setBackgroundVisible(bool visible)
{
d_ptr->m_presenter->setBackgroundVisible(visible);
}
bool QChart::isBackgroundVisible() const
{
return d_ptr->m_presenter->isBackgroundVisible();
}
void QChart::setDropShadowEnabled(bool enabled)
{
d_ptr->m_presenter->setBackgroundDropShadowEnabled(enabled);
}
bool QChart::isDropShadowEnabled() const
{
return d_ptr->m_presenter->isBackgroundDropShadowEnabled();
}
/*!
Returns all the series that are added to the chart.
\sa addSeries(), removeSeries(), removeAllSeries()
*/
QList<QAbstractSeries *> QChart::series() const
{
return d_ptr->m_dataset->series();
}
/*!
Sets \a axis to the chart, which will control the presentation of the \a series
\sa axisX(), axisY(), setAxisY(), createDefaultAxes()
*/
void QChart::setAxisX(QAbstractAxis *axis , QAbstractSeries *series)
{
QList<QAbstractAxis*> list = axes(Qt::Horizontal,series);
foreach(QAbstractAxis* a, list){
d_ptr->m_dataset->removeAxis(a);
delete a;
}
if(!d_ptr->m_dataset->axes().contains(axis))
d_ptr->m_dataset->addAxis(axis,Qt::AlignBottom);
d_ptr->m_dataset->attachAxis(series,axis);
}
/*!
Sets \a axis to the chart, which will control the presentation of the \a series
\sa axisX(), axisY(), setAxisX(), createDefaultAxes()
*/
void QChart::setAxisY(QAbstractAxis *axis , QAbstractSeries *series)
{
QList<QAbstractAxis*> list = axes(Qt::Vertical,series);
foreach(QAbstractAxis* a, list) {
d_ptr->m_dataset->removeAxis(a);
delete a;
}
if(!d_ptr->m_dataset->axes().contains(axis))
d_ptr->m_dataset->addAxis(axis,Qt::AlignLeft);
d_ptr->m_dataset->attachAxis(series,axis);
}
/*!
Adds \a axis to the chart with \a alignment. The chart takes the ownership of the axis.
\sa removeAxis(), createDefaultAxes(), QAbstractSeries::attachAxis()
*/
void QChart::addAxis(QAbstractAxis *axis, Qt::Alignment alignment)
{
d_ptr->m_dataset->addAxis(axis, alignment);
}
/*!
Removes \a axis from the chart. The ownership is returned to the caller.
\sa addAxis(), createDefaultAxes(), QAbstractSeries::detachAxis()
*/
void QChart::removeAxis(QAbstractAxis *axis)
{
d_ptr->m_dataset->removeAxis(axis);
}
/*!
Returns the value in the \a series domain that coresponds to the charts widget point defines by \a position.
*/
QPointF QChart::mapToValue(const QPointF &position, QAbstractSeries *series)
{
return d_ptr->m_dataset->mapToValue(position, series);
}
/*!
Returns the position on the charts widget that coresponds to the \a value in the \a series domain.
*/
QPointF QChart::mapToPosition(const QPointF &value, QAbstractSeries *series)
{
return d_ptr->m_dataset->mapToPosition(value, series);
}
//////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
QChartPrivate::QChartPrivate(QChart *q):
q_ptr(q),
m_legend(0),
m_dataset(new ChartDataSet(q)),
m_presenter(new ChartPresenter(q)),
m_themeManager(new ChartThemeManager(q))
{
QObject::connect(m_dataset, SIGNAL(seriesAdded(QAbstractSeries*)), m_presenter, SLOT(handleSeriesAdded(QAbstractSeries*)));
QObject::connect(m_dataset, SIGNAL(seriesRemoved(QAbstractSeries*)), m_presenter, SLOT(handleSeriesRemoved(QAbstractSeries*)));
QObject::connect(m_dataset, SIGNAL(axisAdded(QAbstractAxis*)), m_presenter, SLOT(handleAxisAdded(QAbstractAxis*)));
QObject::connect(m_dataset, SIGNAL(axisRemoved(QAbstractAxis*)), m_presenter, SLOT(handleAxisRemoved(QAbstractAxis*)));
QObject::connect(m_dataset, SIGNAL(seriesAdded(QAbstractSeries*)), m_themeManager, SLOT(handleSeriesAdded(QAbstractSeries*)));
QObject::connect(m_dataset, SIGNAL(seriesRemoved(QAbstractSeries*)), m_themeManager, SLOT(handleSeriesRemoved(QAbstractSeries*)));
QObject::connect(m_dataset, SIGNAL(axisAdded(QAbstractAxis*)), m_themeManager, SLOT(handleAxisAdded(QAbstractAxis*)));
QObject::connect(m_dataset, SIGNAL(axisRemoved(QAbstractAxis*)), m_themeManager, SLOT(handleAxisRemoved(QAbstractAxis*)));
}
QChartPrivate::~QChartPrivate()
{
}
void QChartPrivate::zoomIn(qreal factor)
{
QRectF rect = m_presenter->geometry();
rect.setWidth(rect.width() / factor);
rect.setHeight(rect.height() / factor);
rect.moveCenter(m_presenter->geometry().center());
zoomIn(rect);
}
void QChartPrivate::zoomIn(const QRectF &rect)
{
if (!rect.isValid())
return;
QRectF r = rect.normalized();
const QRectF geometry = m_presenter->geometry();
r.translate(-geometry.topLeft());
if (!r.isValid())
return;
QPointF zoomPoint(r.center().x() / geometry.width(), r.center().y() / geometry.height());
m_presenter->setState(ChartPresenter::ZoomInState,zoomPoint);
m_dataset->zoomInDomain(r);
m_presenter->setState(ChartPresenter::ShowState,QPointF());
}
void QChartPrivate::zoomOut(qreal factor)
{
const QRectF geometry = m_presenter->geometry();
QRectF r;
r.setSize(geometry.size() / factor);
r.moveCenter(QPointF(geometry.size().width()/2 ,geometry.size().height()/2));
if (!r.isValid())
return;
QPointF zoomPoint(r.center().x() / geometry.width(), r.center().y() / geometry.height());
m_presenter->setState(ChartPresenter::ZoomOutState,zoomPoint);
m_dataset->zoomOutDomain(r);
m_presenter->setState(ChartPresenter::ShowState,QPointF());
}
void QChartPrivate::scroll(qreal dx, qreal dy)
{
if (dx < 0) m_presenter->setState(ChartPresenter::ScrollLeftState,QPointF());
if (dx > 0) m_presenter->setState(ChartPresenter::ScrollRightState,QPointF());
if (dy < 0) m_presenter->setState(ChartPresenter::ScrollUpState,QPointF());
if (dy > 0) m_presenter->setState(ChartPresenter::ScrollDownState,QPointF());
m_dataset->scrollDomain(dx, dy);
m_presenter->setState(ChartPresenter::ShowState,QPointF());
}
#include "moc_qchart.cpp"
QTCOMMERCIALCHART_END_NAMESPACE