qchart.cpp
485 lines
| 12.8 KiB
| text/x-c
|
CppLexer
/ src / qchart.cpp
|
r746 | /**************************************************************************** | ||
** | ||||
** 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$ | ||||
** | ||||
****************************************************************************/ | ||||
|
r12 | #include "qchart.h" | ||
|
r740 | #include "qchart_p.h" | ||
|
r950 | #include "legendscroller_p.h" | ||
#include "qlegend_p.h" | ||||
|
r1006 | #include "chartbackground_p.h" | ||
|
r1541 | #include "qabstractaxis.h" | ||
|
r42 | #include <QGraphicsScene> | ||
|
r115 | #include <QGraphicsSceneResizeEvent> | ||
|
r1534 | #include <QGraphicsLayout> | ||
|
r12 | |||
|
r277 | QTCOMMERCIALCHART_BEGIN_NAMESPACE | ||
/*! | ||||
|
r740 | \enum QChart::ChartTheme | ||
|
r277 | |||
|
r740 | This enum describes the theme used by the chart. | ||
|
r277 | |||
|
r853 | \value ChartThemeLight The default theme | ||
|
r740 | \value ChartThemeBlueCerulean | ||
\value ChartThemeDark | ||||
\value ChartThemeBrownSand | ||||
\value ChartThemeBlueNcs | ||||
|
r757 | \value ChartThemeHighContrast | ||
\value ChartThemeBlueIcy | ||||
|
r740 | */ | ||
|
r277 | |||
|
r302 | /*! | ||
|
r740 | \enum QChart::AnimationOption | ||
|
r302 | |||
|
r740 | For enabling/disabling animations. Defaults to NoAnimation. | ||
|
r302 | |||
|
r740 | \value NoAnimation | ||
\value GridAxisAnimations | ||||
\value SeriesAnimations | ||||
\value AllAnimations | ||||
*/ | ||||
|
r302 | |||
|
r264 | /*! | ||
|
r740 | \class QChart | ||
\brief QtCommercial chart API. | ||||
|
r264 | |||
|
r740 | QChart is a QGraphicsWidget that you can show in a QGraphicsScene. It manages the graphical | ||
|
r1023 | 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 | ||||
|
r740 | convenience class QChartView instead of QChart. | ||
\sa QChartView | ||||
*/ | ||||
|
r264 | |||
|
r1526 | /*! | ||
\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::margins | ||||
Margins around the plot area. Note that the margin area is used for drawing chart title, legend and axes. | ||||
*/ | ||||
/*! | ||||
\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. | ||||
*/ | ||||
/*! | ||||
\fn void QChart::marginsChanged(QRectF newMargins) | ||||
The margins around plot area have changed to \a newMargins. This may happen for example if you change title font size, | ||||
modify axes or hide/show legend. | ||||
*/ | ||||
|
r264 | /*! | ||
|
r740 | Constructs a chart object which is a child of a\a parent. Parameter \a wFlags is passed to the QGraphicsWidget constructor. | ||
*/ | ||||
|
r115 | QChart::QChart(QGraphicsItem *parent, Qt::WindowFlags wFlags) : QGraphicsWidget(parent,wFlags), | ||
|
r924 | d_ptr(new QChartPrivate()) | ||
|
r12 | { | ||
|
r740 | d_ptr->m_dataset = new ChartDataSet(this); | ||
d_ptr->m_presenter = new ChartPresenter(this,d_ptr->m_dataset); | ||||
|
r871 | d_ptr->createConnections(); | ||
|
r950 | d_ptr->m_legend = new LegendScroller(this); | ||
d_ptr->m_presenter->setTheme(QChart::ChartThemeLight, false); | ||||
|
r1534 | //connect(d_ptr->m_presenter, SIGNAL(marginsChanged(QRectF)), this, SIGNAL(marginsChanged(QRectF))); | ||
setLayout(d_ptr->m_presenter->layout()); | ||||
|
r12 | } | ||
|
r264 | /*! | ||
|
r1023 | Destroys the object and it's children, like series and axis objects added to it. | ||
|
r740 | */ | ||
|
r264 | QChart::~QChart() | ||
{ | ||||
|
r686 | //delete first presenter , since this is a root of all the graphical items | ||
|
r1534 | setLayout(0); | ||
|
r740 | delete d_ptr->m_presenter; | ||
d_ptr->m_presenter=0; | ||||
|
r264 | } | ||
|
r12 | |||
|
r264 | /*! | ||
|
r1575 | Adds the \a series onto the chart and takes the ownership of the object. | ||
|
r740 | If auto scaling is enabled, re-scales the axes the series is bound to (both the x axis and | ||
the y axis). | ||||
|
r1316 | |||
\sa removeSeries(), removeAllSeries() | ||||
|
r740 | */ | ||
|
r1541 | void QChart::addSeries(QAbstractSeries *series) | ||
|
r223 | { | ||
|
r895 | Q_ASSERT(series); | ||
|
r1541 | d_ptr->m_dataset->addSeries(series); | ||
|
r223 | } | ||
|
r42 | |||
|
r274 | /*! | ||
|
r740 | 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() | ||||
*/ | ||||
|
r988 | void QChart::removeSeries(QAbstractSeries *series) | ||
|
r223 | { | ||
|
r895 | Q_ASSERT(series); | ||
|
r740 | d_ptr->m_dataset->removeSeries(series); | ||
|
r42 | } | ||
|
r48 | |||
|
r274 | /*! | ||
|
r740 | Removes all the QChartSeries that have been added to the QChartView | ||
It also deletes the pointed QChartSeries data objects | ||||
\sa addSeries(), removeSeries() | ||||
*/ | ||||
|
r258 | void QChart::removeAllSeries() | ||
{ | ||||
|
r740 | d_ptr->m_dataset->removeAllSeries(); | ||
|
r258 | } | ||
|
r287 | /*! | ||
|
r740 | Sets the \a brush that is used for painting the background of the chart area. | ||
*/ | ||||
|
r645 | void QChart::setBackgroundBrush(const QBrush& brush) | ||
|
r122 | { | ||
|
r1534 | d_ptr->m_presenter->setBackgroundBrush(brush); | ||
|
r122 | } | ||
|
r924 | /*! | ||
Gets the brush that is used for painting the background of the chart area. | ||||
*/ | ||||
|
r645 | QBrush QChart::backgroundBrush() const | ||
{ | ||||
|
r1534 | return d_ptr->m_presenter->backgroundBrush(); | ||
|
r645 | } | ||
|
r287 | /*! | ||
|
r740 | Sets the \a pen that is used for painting the background of the chart area. | ||
*/ | ||||
|
r645 | void QChart::setBackgroundPen(const QPen& pen) | ||
|
r122 | { | ||
|
r1534 | d_ptr->m_presenter->setBackgroundPen(pen); | ||
|
r122 | } | ||
|
r924 | /*! | ||
Gets the pen that is used for painting the background of the chart area. | ||||
*/ | ||||
|
r645 | QPen QChart::backgroundPen() const | ||
{ | ||||
|
r1534 | return d_ptr->m_presenter->backgroundPen(); | ||
|
r645 | } | ||
|
r274 | /*! | ||
|
r740 | Sets the chart \a title. The description text that is drawn above the chart. | ||
*/ | ||||
|
r645 | void QChart::setTitle(const QString& title) | ||
|
r69 | { | ||
|
r1534 | d_ptr->m_presenter->setTitle(title); | ||
|
r476 | } | ||
/*! | ||||
|
r740 | Returns the chart title. The description text that is drawn above the chart. | ||
*/ | ||||
|
r645 | QString QChart::title() const | ||
|
r476 | { | ||
|
r1534 | return d_ptr->m_presenter->title(); | ||
|
r192 | } | ||
|
r274 | /*! | ||
|
r924 | Sets the \a font that is used for drawing the chart description text that is rendered above the chart. | ||
|
r740 | */ | ||
|
r645 | void QChart::setTitleFont(const QFont& font) | ||
|
r192 | { | ||
|
r1534 | d_ptr->m_presenter->setTitleFont(font); | ||
|
r69 | } | ||
|
r924 | /*! | ||
Gets the font that is used for drawing the chart description text that is rendered above the chart. | ||||
*/ | ||||
|
r895 | QFont QChart::titleFont() const | ||
{ | ||||
|
r1534 | return d_ptr->m_presenter->titleFont(); | ||
|
r895 | } | ||
|
r495 | /*! | ||
|
r740 | Sets the \a brush used for rendering the title text. | ||
*/ | ||||
|
r645 | void QChart::setTitleBrush(const QBrush &brush) | ||
|
r495 | { | ||
|
r1534 | d_ptr->m_presenter->setTitleBrush(brush); | ||
|
r495 | } | ||
/*! | ||||
|
r740 | Returns the brush used for rendering the title text. | ||
*/ | ||||
|
r645 | QBrush QChart::titleBrush() const | ||
|
r495 | { | ||
|
r1534 | return d_ptr->m_presenter->titleBrush(); | ||
|
r223 | } | ||
|
r740 | void QChart::setTheme(QChart::ChartTheme theme) | ||
|
r64 | { | ||
|
r740 | d_ptr->m_presenter->setTheme(theme); | ||
|
r64 | } | ||
|
r740 | QChart::ChartTheme QChart::theme() const | ||
|
r120 | { | ||
|
r740 | return d_ptr->m_presenter->theme(); | ||
|
r120 | } | ||
|
r285 | /*! | ||
|
r740 | Zooms in the view by a factor of 2 | ||
*/ | ||||
|
r223 | void QChart::zoomIn() | ||
|
r67 | { | ||
|
r1187 | d_ptr->m_presenter->zoomIn(2.0); | ||
|
r67 | } | ||
|
r285 | /*! | ||
|
r740 | Zooms in the view to a maximum level at which \a rect is still fully visible. | ||
*/ | ||||
|
r223 | void QChart::zoomIn(const QRectF& rect) | ||
|
r67 | { | ||
|
r742 | if (!rect.isValid()) return; | ||
|
r740 | d_ptr->m_presenter->zoomIn(rect); | ||
|
r67 | } | ||
|
r285 | /*! | ||
|
r740 | Restores the view zoom level to the previous one. | ||
*/ | ||||
|
r67 | void QChart::zoomOut() | ||
{ | ||||
|
r1187 | d_ptr->m_presenter->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 (qFuzzyIsNull(factor)) | ||||
return; | ||||
if (qFuzzyCompare(factor, 1.0)) | ||||
return; | ||||
if (factor < 0) | ||||
return; | ||||
if (factor > 1.0) | ||||
d_ptr->m_presenter->zoomIn(factor); | ||||
else | ||||
d_ptr->m_presenter->zoomOut(1.0 / factor); | ||||
|
r67 | } | ||
|
r277 | /*! | ||
|
r1633 | Returns the pointer to the x axis object of the chart asociated with the specified \a series | ||
|
r1638 | If no series is provided then pointer to currently visible axis is provided | ||
|
r740 | */ | ||
|
r1542 | QAbstractAxis* QChart::axisX(QAbstractSeries* series) const | ||
|
r176 | { | ||
|
r1559 | return d_ptr->m_dataset->axisX(series); | ||
|
r176 | } | ||
|
r277 | /*! | ||
|
r1633 | Returns the pointer to the y axis object of the chart asociated with the specified \a series | ||
|
r1638 | If no series is provided then pointer to currently visible axis is provided | ||
|
r740 | */ | ||
|
r1541 | QAbstractAxis* QChart::axisY(QAbstractSeries *series) const | ||
|
r176 | { | ||
|
r899 | return d_ptr->m_dataset->axisY(series); | ||
|
r85 | } | ||
|
r1633 | /*! | ||
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. | ||||
|
r1638 | |||
\table | ||||
\header | ||||
\o Series type | ||||
\o X-axis | ||||
\o Y-axis | ||||
\row | ||||
\o QXYSeries | ||||
\o QValuesAxis | ||||
\o QValuesAxis | ||||
\row | ||||
\o QBarSeries | ||||
\o QBarCategoriesAxis | ||||
\o QValuesAxis | ||||
\row | ||||
\o QPieSeries | ||||
\o None | ||||
\o None | ||||
\endtable | ||||
|
r1633 | 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() | ||||
*/ | ||||
|
r1577 | void QChart::createDefaultAxes() | ||
{ | ||||
d_ptr->m_dataset->createDefaultAxes(); | ||||
} | ||||
|
r524 | /*! | ||
|
r740 | Returns the legend object of the chart. Ownership stays in chart. | ||
*/ | ||||
|
r783 | QLegend* QChart::legend() const | ||
|
r524 | { | ||
|
r783 | return d_ptr->m_legend; | ||
|
r524 | } | ||
|
r924 | /*! | ||
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. | ||||
*/ | ||||
|
r874 | QRectF QChart::margins() const | ||
|
r803 | { | ||
|
r855 | return d_ptr->m_presenter->margins(); | ||
|
r803 | } | ||
|
r287 | /*! | ||
|
r1534 | Sets animation \a options for the chart | ||
|
r740 | */ | ||
|
r115 | |||
|
r298 | void QChart::setAnimationOptions(AnimationOptions options) | ||
{ | ||||
|
r740 | d_ptr->m_presenter->setAnimationOptions(options); | ||
|
r298 | } | ||
QChart::AnimationOptions QChart::animationOptions() const | ||||
{ | ||||
|
r740 | return d_ptr->m_presenter->animationOptions(); | ||
|
r298 | } | ||
|
r1187 | /*! | ||
|
r1575 | Scrolls the visible area of the chart by the distance defined in the \a dx and \a dy. | ||
|
r1187 | */ | ||
|
r1553 | void QChart::scroll(qreal dx, qreal dy) | ||
|
r1187 | { | ||
|
r1553 | d_ptr->m_presenter->scroll(dx, dy); | ||
|
r1187 | } | ||
|
r740 | void QChart::setBackgroundVisible(bool visible) | ||
{ | ||||
|
r1534 | d_ptr->m_presenter->setBackgroundVisible(visible); | ||
|
r740 | } | ||
|
r716 | |||
|
r740 | bool QChart::isBackgroundVisible() const | ||
{ | ||||
|
r1534 | return d_ptr->m_presenter->isBackgroundVisible(); | ||
|
r716 | } | ||
|
r1462 | void QChart::setDropShadowEnabled(bool enabled) | ||
|
r1001 | { | ||
|
r1534 | d_ptr->m_presenter->setBackgroundDropShadowEnabled(enabled); | ||
|
r1001 | } | ||
|
r1462 | bool QChart::isDropShadowEnabled() const | ||
|
r1001 | { | ||
|
r1534 | return d_ptr->m_presenter->isBackgroundDropShadowEnabled(); | ||
|
r1001 | } | ||
|
r1316 | /*! | ||
Returns all the series that are added to the chart. | ||||
\sa addSeries(), removeSeries(), removeAllSeries() | ||||
*/ | ||||
|
r1107 | QList<QAbstractSeries*> QChart::series() const | ||
{ | ||||
return d_ptr->m_dataset->series(); | ||||
} | ||||
|
r1534 | void QChart::setMarginsMinimum(const QRectF& margins) | ||
{ | ||||
d_ptr->m_presenter->setMarginsMinimum(margins); | ||||
} | ||||
|
r1633 | /*! | ||
Sets \a axis to the chart, which will control the presentation of the \a series | ||||
\sa axisX(), axisY(), setAxisY(), createDefaultAxes() | ||||
*/ | ||||
|
r1577 | void QChart::setAxisX(QAbstractAxis* axis , QAbstractSeries *series) | ||
|
r1541 | { | ||
|
r1577 | d_ptr->m_dataset->setAxisX(series,axis); | ||
|
r1541 | } | ||
|
r1633 | /*! | ||
Sets \a axis to the chart, which will control the presentation of the \a series | ||||
\sa axisX(), axisY(), setAxisX(), createDefaultAxes() | ||||
*/ | ||||
|
r1577 | void QChart::setAxisY( QAbstractAxis* axis , QAbstractSeries *series) | ||
|
r1541 | { | ||
|
r1577 | d_ptr->m_dataset->setAxisY(series,axis); | ||
|
r1541 | } | ||
|
r740 | ////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////// | ||
|
r639 | |||
|
r855 | QChartPrivate::QChartPrivate(): | ||
|
r924 | m_legend(0), | ||
m_dataset(0), | ||||
m_presenter(0) | ||||
|
r639 | { | ||
|
r740 | |||
|
r639 | } | ||
|
r740 | QChartPrivate::~QChartPrivate() | ||
|
r639 | { | ||
|
r740 | |||
|
r639 | } | ||
|
r871 | void QChartPrivate::createConnections() | ||
{ | ||||
|
r1033 | QObject::connect(m_dataset,SIGNAL(seriesAdded(QAbstractSeries*,Domain*)),m_presenter,SLOT(handleSeriesAdded(QAbstractSeries*,Domain*))); | ||
QObject::connect(m_dataset,SIGNAL(seriesRemoved(QAbstractSeries*)),m_presenter,SLOT(handleSeriesRemoved(QAbstractSeries*))); | ||||
|
r1541 | QObject::connect(m_dataset,SIGNAL(axisAdded(QAbstractAxis*,Domain*)),m_presenter,SLOT(handleAxisAdded(QAbstractAxis*,Domain*))); | ||
QObject::connect(m_dataset,SIGNAL(axisRemoved(QAbstractAxis*)),m_presenter,SLOT(handleAxisRemoved(QAbstractAxis*))); | ||||
|
r1534 | //QObject::connect(m_presenter, SIGNAL(marginsChanged(QRectF)), q_ptr, SIGNAL(marginsChanged(QRectF))); | ||
|
r871 | } | ||
|
r64 | #include "moc_qchart.cpp" | ||
|
r48 | |||
|
r30 | QTCOMMERCIALCHART_END_NAMESPACE | ||