qchart.cpp
828 lines
| 23.0 KiB
| text/x-c
|
CppLexer
/ src / qchart.cpp
Michal Klocek
|
r746 | /**************************************************************************** | ||
| ** | ||||
Miikka Heikkinen
|
r2432 | ** Copyright (C) 2013 Digia Plc | ||
|
Michal Klocek
|
r746 | ** All rights reserved. | ||
| ** For any questions to Digia, please use contact form at http://qt.digia.com | ||||
| ** | ||||
|
Miikka Heikkinen
|
r2574 | ** This file is part of the Qt Enterprise Charts Add-on. | ||
|
Michal Klocek
|
r746 | ** | ||
| ** $QT_BEGIN_LICENSE$ | ||||
|
Miikka Heikkinen
|
r2574 | ** Licensees holding valid Qt Enterprise licenses may use this file in | ||
| ** accordance with the Qt Enterprise License Agreement provided with the | ||||
|
Michal Klocek
|
r746 | ** 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$ | ||||
| ** | ||||
| ****************************************************************************/ | ||||
|
Michal Klocek
|
r12 | #include "qchart.h" | ||
|
Michal Klocek
|
r740 | #include "qchart_p.h" | ||
|
Michal Klocek
|
r950 | #include "legendscroller_p.h" | ||
| #include "qlegend_p.h" | ||||
|
Michal Klocek
|
r1006 | #include "chartbackground_p.h" | ||
|
Michal Klocek
|
r1541 | #include "qabstractaxis.h" | ||
|
Miikka Heikkinen
|
r2483 | #include "abstractchartlayout_p.h" | ||
|
Michal Klocek
|
r2273 | #include "charttheme_p.h" | ||
| #include "chartpresenter_p.h" | ||||
| #include "chartdataset_p.h" | ||||
Tero Ahola
|
r42 | #include <QGraphicsScene> | ||
|
Michal Klocek
|
r115 | #include <QGraphicsSceneResizeEvent> | ||
|
Michal Klocek
|
r12 | |||
Marek Rosa
|
r277 | QTCOMMERCIALCHART_BEGIN_NAMESPACE | ||
| /*! | ||||
|
Michal Klocek
|
r740 | \enum QChart::ChartTheme | ||
|
Marek Rosa
|
r277 | |||
|
Michal Klocek
|
r740 | This enum describes the theme used by the chart. | ||
|
Marek Rosa
|
r277 | |||
|
Tero Ahola
|
r853 | \value ChartThemeLight The default theme | ||
|
Michal Klocek
|
r740 | \value ChartThemeBlueCerulean | ||
| \value ChartThemeDark | ||||
| \value ChartThemeBrownSand | ||||
| \value ChartThemeBlueNcs | ||||
|
Tero Ahola
|
r757 | \value ChartThemeHighContrast | ||
| \value ChartThemeBlueIcy | ||||
Titta Heikkala
|
r2632 | \value ChartThemeQt | ||
|
Michal Klocek
|
r740 | */ | ||
|
Marek Rosa
|
r277 | |||
|
Tero Ahola
|
r302 | /*! | ||
|
Michal Klocek
|
r740 | \enum QChart::AnimationOption | ||
|
Tero Ahola
|
r302 | |||
|
Michal Klocek
|
r740 | For enabling/disabling animations. Defaults to NoAnimation. | ||
|
Tero Ahola
|
r302 | |||
|
Michal Klocek
|
r740 | \value NoAnimation | ||
| \value GridAxisAnimations | ||||
| \value SeriesAnimations | ||||
| \value AllAnimations | ||||
| */ | ||||
|
Tero Ahola
|
r302 | |||
|
Miikka Heikkinen
|
r2483 | /*! | ||
| \enum QChart::ChartType | ||||
| This enum describes the chart type. | ||||
| \value ChartTypeUndefined | ||||
| \value ChartTypeCartesian | ||||
| \value ChartTypePolar | ||||
| */ | ||||
|
Tero Ahola
|
r264 | /*! | ||
|
Michal Klocek
|
r740 | \class QChart | ||
|
Titta Heikkala
|
r2639 | \inmodule Qt Charts | ||
|
Miikka Heikkinen
|
r2591 | \brief Main chart API for Qt Charts. | ||
|
Tero Ahola
|
r264 | |||
|
Michal Klocek
|
r740 | QChart is a QGraphicsWidget that you can show in a QGraphicsScene. It manages the graphical | ||
|
Miikka Heikkinen
|
r2494 | representation of different types of series and other chart related objects like legend and | ||
| axes. If you simply want to show a chart in a layout, you can use the | ||||
|
Michal Klocek
|
r740 | convenience class QChartView instead of QChart. | ||
|
Miikka Heikkinen
|
r2494 | \sa QChartView, QPolarChart | ||
|
Michal Klocek
|
r740 | */ | ||
|
Tero Ahola
|
r264 | |||
|
Tero Ahola
|
r1526 | /*! | ||
| \property QChart::animationOptions | ||||
| The animation \a options for the chart. Animations are enabled/disabled based on this setting. | ||||
| */ | ||||
| /*! | ||||
| \property QChart::backgroundVisible | ||||
|
Miikka Heikkinen
|
r2494 | Specifies whether the chart background is visible or not. | ||
|
Miikka Heikkinen
|
r2498 | \sa setBackgroundBrush(), setBackgroundPen(), plotAreaBackgroundVisible | ||
|
Tero Ahola
|
r1526 | */ | ||
| /*! | ||||
| \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. | ||||
| */ | ||||
|
Miikka Heikkinen
|
r2549 | /*! | ||
| \property QChart::backgroundRoundness | ||||
| The diameter of the rounding cirle at the corners of the chart background. | ||||
| */ | ||||
|
Tero Ahola
|
r1526 | /*! | ||
sauimone
|
r1982 | \property QChart::minimumMargins | ||
| Minimum margins between the plot area (axes) and the edge of the chart widget. | ||||
|
Miikka Heikkinen
|
r2494 | This property is deprecated; use margins property instead. | ||
| \sa margins | ||||
|
Tero Ahola
|
r1526 | */ | ||
|
Tero Ahola
|
r2360 | /*! | ||
| \property QChart::margins | ||||
|
Miikka Heikkinen
|
r2494 | Margins between the plot area (axes) and the edge of the chart widget. | ||
|
Tero Ahola
|
r2360 | */ | ||
|
Tero Ahola
|
r1526 | /*! | ||
| \property QChart::theme | ||||
| Theme is a built-in collection of UI style related settings applied for all visual elements of a chart, like colors, | ||||
|
Miikka Heikkinen
|
r2494 | pens, brushes, and fonts of series, axes, title, and legend. \l {Chart themes demo} shows an example with a few | ||
|
Tero Ahola
|
r1526 | different themes. | ||
|
Miikka Heikkinen
|
r2494 | \note Changing the theme will overwrite all customizations previously applied to the series. | ||
|
Tero Ahola
|
r1526 | */ | ||
| /*! | ||||
| \property QChart::title | ||||
|
Miikka Heikkinen
|
r2539 | Title is the name (label) of a chart. It is shown as a headline on top of the chart. Chart title supports html formatting. | ||
|
Tero Ahola
|
r1526 | */ | ||
|
Tero Ahola
|
r264 | /*! | ||
|
Miikka Heikkinen
|
r2483 | \property QChart::chartType | ||
| Chart type indicates if the chart is a cartesian chart or a polar chart. | ||||
|
Miikka Heikkinen
|
r2494 | This property is set internally and it is read only. | ||
|
Miikka Heikkinen
|
r2483 | \sa QPolarChart | ||
| */ | ||||
|
Miikka Heikkinen
|
r2498 | /*! | ||
| \property QChart::plotAreaBackgroundVisible | ||||
| Specifies whether the chart plot area background is visible or not. | ||||
| \note By default the plot area background is not visible and the plot area uses | ||||
| the general chart background. | ||||
| \sa setPlotAreaBackgroundBrush(), setPlotAreaBackgroundPen(), backgroundVisible | ||||
| */ | ||||
|
Miikka Heikkinen
|
r2483 | /*! | ||
| \internal | ||||
| Constructs a chart object of \a type which is a child of a \a parent. | ||||
| Parameter \a wFlags is passed to the QGraphicsWidget constructor. | ||||
| This constructor is called only by subclasses. | ||||
| */ | ||||
| QChart::QChart(QChart::ChartType type, QGraphicsItem *parent, Qt::WindowFlags wFlags) | ||||
| : QGraphicsWidget(parent, wFlags), | ||||
| d_ptr(new QChartPrivate(this, type)) | ||||
| { | ||||
| d_ptr->init(); | ||||
| } | ||||
| /*! | ||||
| Constructs a chart object which is a child of a \a parent. | ||||
| Parameter \a wFlags is passed to the QGraphicsWidget constructor. | ||||
|
Michal Klocek
|
r740 | */ | ||
Jani Honkonen
|
r2131 | QChart::QChart(QGraphicsItem *parent, Qt::WindowFlags wFlags) | ||
| : QGraphicsWidget(parent, wFlags), | ||||
|
Miikka Heikkinen
|
r2483 | d_ptr(new QChartPrivate(this, ChartTypeCartesian)) | ||
|
Michal Klocek
|
r12 | { | ||
|
Miikka Heikkinen
|
r2483 | d_ptr->init(); | ||
|
Michal Klocek
|
r12 | } | ||
|
Tero Ahola
|
r264 | /*! | ||
|
Miikka Heikkinen
|
r2494 | Destroys the chart object and its children, like series and axis objects added to it. | ||
|
Michal Klocek
|
r740 | */ | ||
|
Tero Ahola
|
r264 | QChart::~QChart() | ||
| { | ||||
|
Michal Klocek
|
r2273 | //start by deleting dataset, it will remove all series and axes | ||
| delete d_ptr->m_dataset; | ||||
| d_ptr->m_dataset = 0; | ||||
|
Tero Ahola
|
r264 | } | ||
|
Michal Klocek
|
r12 | |||
|
Tero Ahola
|
r264 | /*! | ||
|
Miikka Heikkinen
|
r2494 | Adds the \a series onto the chart and takes the ownership of it. | ||
| \note A newly added series is attached to no axes by default, including any axes that were created for the chart | ||||
| using createDefaultAxes() before the series was added to the chart. If no axes are attached to | ||||
| the newly added series before the chart is shown, the series will get drawn as if it had axes with ranges | ||||
| that exactly fit the series to the plot area of the chart. This can be confusing if the same chart also displays other | ||||
| series that have properly attached axes, so always make sure you either call createDefaultAxes() after | ||||
| a series has been added or explicitly attach axes for the series. | ||||
|
Jani Honkonen
|
r1316 | |||
|
Miikka Heikkinen
|
r2494 | \sa removeSeries(), removeAllSeries(), createDefaultAxes(), QAbstractSeries::attachAxis() | ||
|
Michal Klocek
|
r740 | */ | ||
|
Michal Klocek
|
r1541 | void QChart::addSeries(QAbstractSeries *series) | ||
|
Michal Klocek
|
r223 | { | ||
|
Michal Klocek
|
r895 | Q_ASSERT(series); | ||
|
Michal Klocek
|
r1541 | d_ptr->m_dataset->addSeries(series); | ||
|
Michal Klocek
|
r223 | } | ||
|
Tero Ahola
|
r42 | |||
|
Marek Rosa
|
r274 | /*! | ||
|
Miikka Heikkinen
|
r2494 | Removes the \a series from the chart. | ||
| The chart releases its ownership of the specified \a series object. | ||||
|
Michal Klocek
|
r740 | \sa addSeries(), removeAllSeries() | ||
| */ | ||||
|
Tero Ahola
|
r988 | void QChart::removeSeries(QAbstractSeries *series) | ||
|
Michal Klocek
|
r223 | { | ||
|
Michal Klocek
|
r895 | Q_ASSERT(series); | ||
|
Michal Klocek
|
r740 | d_ptr->m_dataset->removeSeries(series); | ||
|
Tero Ahola
|
r42 | } | ||
|
Tero Ahola
|
r48 | |||
|
Marek Rosa
|
r274 | /*! | ||
|
Miikka Heikkinen
|
r2494 | Removes and deletes all series objects that have been added to the chart. | ||
|
Michal Klocek
|
r740 | \sa addSeries(), removeSeries() | ||
| */ | ||||
|
Michal Klocek
|
r258 | void QChart::removeAllSeries() | ||
| { | ||||
|
Michal Klocek
|
r2284 | foreach (QAbstractSeries *s , d_ptr->m_dataset->series()){ | ||
| removeSeries(s); | ||||
| delete s; | ||||
| } | ||||
|
Michal Klocek
|
r258 | } | ||
|
Marek Rosa
|
r287 | /*! | ||
|
Michal Klocek
|
r740 | Sets the \a brush that is used for painting the background of the chart area. | ||
| */ | ||||
|
Jani Honkonen
|
r2131 | void QChart::setBackgroundBrush(const QBrush &brush) | ||
|
Michal Klocek
|
r122 | { | ||
|
Michal Klocek
|
r1534 | d_ptr->m_presenter->setBackgroundBrush(brush); | ||
|
Michal Klocek
|
r122 | } | ||
|
Marek Rosa
|
r924 | /*! | ||
|
Miikka Heikkinen
|
r2494 | Gets the brush that is used for painting the background of the chart area. | ||
|
Marek Rosa
|
r924 | */ | ||
|
Michal Klocek
|
r645 | QBrush QChart::backgroundBrush() const | ||
| { | ||||
|
Michal Klocek
|
r1534 | return d_ptr->m_presenter->backgroundBrush(); | ||
|
Michal Klocek
|
r645 | } | ||
|
Marek Rosa
|
r287 | /*! | ||
|
Michal Klocek
|
r740 | Sets the \a pen that is used for painting the background of the chart area. | ||
| */ | ||||
|
Jani Honkonen
|
r2131 | void QChart::setBackgroundPen(const QPen &pen) | ||
|
Michal Klocek
|
r122 | { | ||
|
Michal Klocek
|
r1534 | d_ptr->m_presenter->setBackgroundPen(pen); | ||
|
Michal Klocek
|
r122 | } | ||
|
Marek Rosa
|
r924 | /*! | ||
|
Miikka Heikkinen
|
r2494 | Gets the pen that is used for painting the background of the chart area. | ||
|
Marek Rosa
|
r924 | */ | ||
|
Michal Klocek
|
r645 | QPen QChart::backgroundPen() const | ||
| { | ||||
|
Michal Klocek
|
r1534 | return d_ptr->m_presenter->backgroundPen(); | ||
|
Michal Klocek
|
r645 | } | ||
|
Jani Honkonen
|
r2131 | void QChart::setTitle(const QString &title) | ||
|
Michal Klocek
|
r69 | { | ||
|
Michal Klocek
|
r1534 | d_ptr->m_presenter->setTitle(title); | ||
|
Michal Klocek
|
r476 | } | ||
|
Michal Klocek
|
r645 | QString QChart::title() const | ||
|
Michal Klocek
|
r476 | { | ||
|
Michal Klocek
|
r1534 | return d_ptr->m_presenter->title(); | ||
|
Michal Klocek
|
r192 | } | ||
|
Marek Rosa
|
r274 | /*! | ||
|
Miikka Heikkinen
|
r2494 | Sets the \a font that is used for drawing the chart title. | ||
|
Michal Klocek
|
r740 | */ | ||
|
Jani Honkonen
|
r2131 | void QChart::setTitleFont(const QFont &font) | ||
|
Michal Klocek
|
r192 | { | ||
|
Michal Klocek
|
r1534 | d_ptr->m_presenter->setTitleFont(font); | ||
|
Michal Klocek
|
r69 | } | ||
|
Marek Rosa
|
r924 | /*! | ||
|
Miikka Heikkinen
|
r2494 | Gets the font that is used for drawing the chart title. | ||
|
Marek Rosa
|
r924 | */ | ||
|
Michal Klocek
|
r895 | QFont QChart::titleFont() const | ||
| { | ||||
|
Michal Klocek
|
r1534 | return d_ptr->m_presenter->titleFont(); | ||
|
Michal Klocek
|
r895 | } | ||
|
Tero Ahola
|
r495 | /*! | ||
|
Miikka Heikkinen
|
r2494 | Sets the \a brush used for drawing the title text. | ||
|
Michal Klocek
|
r740 | */ | ||
|
Michal Klocek
|
r645 | void QChart::setTitleBrush(const QBrush &brush) | ||
|
Tero Ahola
|
r495 | { | ||
|
Michal Klocek
|
r1534 | d_ptr->m_presenter->setTitleBrush(brush); | ||
|
Tero Ahola
|
r495 | } | ||
| /*! | ||||
|
Miikka Heikkinen
|
r2494 | Returns the brush used for drawing the title text. | ||
|
Michal Klocek
|
r740 | */ | ||
|
Michal Klocek
|
r645 | QBrush QChart::titleBrush() const | ||
|
Tero Ahola
|
r495 | { | ||
|
Michal Klocek
|
r1534 | return d_ptr->m_presenter->titleBrush(); | ||
|
Michal Klocek
|
r223 | } | ||
|
Michal Klocek
|
r740 | void QChart::setTheme(QChart::ChartTheme theme) | ||
|
Tero Ahola
|
r64 | { | ||
|
Michal Klocek
|
r2273 | d_ptr->m_themeManager->setTheme(theme); | ||
|
Tero Ahola
|
r64 | } | ||
|
Michal Klocek
|
r740 | QChart::ChartTheme QChart::theme() const | ||
|
Tero Ahola
|
r120 | { | ||
|
Michal Klocek
|
r2273 | return d_ptr->m_themeManager->theme()->id(); | ||
|
Tero Ahola
|
r120 | } | ||
|
Marek Rosa
|
r285 | /*! | ||
|
Miikka Heikkinen
|
r2494 | Zooms in the view by a factor of two. | ||
|
Michal Klocek
|
r740 | */ | ||
|
Michal Klocek
|
r223 | void QChart::zoomIn() | ||
|
Michal Klocek
|
r67 | { | ||
|
Michal Klocek
|
r2273 | d_ptr->zoomIn(2.0); | ||
|
Michal Klocek
|
r67 | } | ||
|
Marek Rosa
|
r285 | /*! | ||
|
Michal Klocek
|
r740 | Zooms in the view to a maximum level at which \a rect is still fully visible. | ||
|
Miikka Heikkinen
|
r2483 | \note This is not supported for polar charts. | ||
|
Michal Klocek
|
r740 | */ | ||
|
Jani Honkonen
|
r2131 | void QChart::zoomIn(const QRectF &rect) | ||
|
Michal Klocek
|
r67 | { | ||
|
Miikka Heikkinen
|
r2483 | if (d_ptr->m_type == QChart::ChartTypePolar) | ||
| return; | ||||
|
Marek Rosa
|
r2344 | d_ptr->zoomIn(rect); | ||
|
Michal Klocek
|
r67 | } | ||
|
Marek Rosa
|
r285 | /*! | ||
|
Miikka Heikkinen
|
r2494 | Zooms out the view by a factor of two. | ||
|
Michal Klocek
|
r740 | */ | ||
|
Michal Klocek
|
r67 | void QChart::zoomOut() | ||
| { | ||||
|
Michal Klocek
|
r2273 | d_ptr->zoomOut(2.0); | ||
|
Jani Honkonen
|
r1187 | } | ||
| /*! | ||||
|
Miikka Heikkinen
|
r2494 | Zooms in the view by a custom \a factor. | ||
|
Jani Honkonen
|
r1187 | |||
| A factor over 1.0 zooms the view in and factor between 0.0 and 1.0 zooms out. | ||||
| */ | ||||
| void QChart::zoom(qreal factor) | ||||
| { | ||||
|
Marek Rosa
|
r2242 | if (qFuzzyCompare(factor, 0)) | ||
|
Jani Honkonen
|
r1187 | return; | ||
|
Marek Rosa
|
r1679 | if (qFuzzyCompare(factor, (qreal)1.0)) | ||
|
Jani Honkonen
|
r1187 | return; | ||
| if (factor < 0) | ||||
| return; | ||||
| if (factor > 1.0) | ||||
|
Michal Klocek
|
r2273 | d_ptr->zoomIn(factor); | ||
|
Jani Honkonen
|
r1187 | else | ||
|
Michal Klocek
|
r2273 | d_ptr->zoomOut(1.0 / factor); | ||
|
Michal Klocek
|
r67 | } | ||
|
Miikka Heikkinen
|
r2545 | |||
| /*! | ||||
| Resets the series domains to what they were before any zoom method was called. | ||||
| Note that this will also reset any scrolls and explicit axis range settings done between | ||||
| the first zoom operation and calling this method. If no zoom operation has been | ||||
| done, this method does nothing. | ||||
| */ | ||||
| void QChart::zoomReset() | ||||
| { | ||||
| d_ptr->zoomReset(); | ||||
| } | ||||
| /*! | ||||
| Returns true if any series has a zoomed domain. | ||||
| */ | ||||
| bool QChart::isZoomed() | ||||
| { | ||||
| return d_ptr->isZoomed(); | ||||
| } | ||||
|
Marek Rosa
|
r277 | /*! | ||
|
Miikka Heikkinen
|
r2494 | Returns a pointer to the horizontal axis attached to the specified \a series. | ||
| If no \a series is specified, the first horizontal axis added to the chart is returned. | ||||
| \sa addAxis(), QAbstractSeries::attachAxis() | ||||
|
Michal Klocek
|
r740 | */ | ||
|
Jani Honkonen
|
r2131 | QAbstractAxis *QChart::axisX(QAbstractSeries *series) const | ||
|
Michal Klocek
|
r176 | { | ||
|
Tero Ahola
|
r2384 | QList<QAbstractAxis *> axisList = axes(Qt::Horizontal, series); | ||
| if (axisList.count()) | ||||
| return axisList[0]; | ||||
| return 0; | ||||
|
Michal Klocek
|
r176 | } | ||
|
Marek Rosa
|
r277 | /*! | ||
|
Miikka Heikkinen
|
r2494 | Returns a pointer to the vertical axis attached to the specified \a series. | ||
| If no \a series is specified, the first vertical axis added to the chart is returned. | ||||
| \sa addAxis(), QAbstractSeries::attachAxis() | ||||
|
Michal Klocek
|
r740 | */ | ||
|
Jani Honkonen
|
r2131 | QAbstractAxis *QChart::axisY(QAbstractSeries *series) const | ||
|
Michal Klocek
|
r176 | { | ||
|
Tero Ahola
|
r2384 | QList<QAbstractAxis *> axisList = axes(Qt::Vertical, series); | ||
| if (axisList.count()) | ||||
| return axisList[0]; | ||||
| return 0; | ||||
|
Michal Klocek
|
r2273 | } | ||
|
Tero Ahola
|
r2360 | /*! | ||
|
Miikka Heikkinen
|
r2494 | Returns the axes attached to the \a series with \a orientation. If no \a series is provided, | ||
| then all axes added to the chart with the specified orientation are returned. | ||||
|
Tero Ahola
|
r2360 | \sa addAxis(), createDefaultAxes() | ||
| */ | ||||
|
Michal Klocek
|
r2273 | QList<QAbstractAxis *> QChart::axes(Qt::Orientations orientation, QAbstractSeries *series) const | ||
| { | ||||
| QList<QAbstractAxis *> result ; | ||||
|
Tero Ahola
|
r2296 | if (series) { | ||
| foreach (QAbstractAxis *axis, series->attachedAxes()){ | ||||
| if (orientation.testFlag(axis->orientation())) | ||||
| result << axis; | ||||
| } | ||||
| } else { | ||||
|
Tero Ahola
|
r2384 | foreach (QAbstractAxis *axis, d_ptr->m_dataset->axes()){ | ||
| if (orientation.testFlag(axis->orientation()) && !result.contains(axis)) | ||||
| result << axis; | ||||
|
Tero Ahola
|
r2296 | } | ||
|
Michal Klocek
|
r2273 | } | ||
| return result; | ||||
|
Michal Klocek
|
r85 | } | ||
|
Marek Rosa
|
r1633 | /*! | ||
|
Miikka Heikkinen
|
r2494 | Creates axes for the chart based on the series that have already been added to the chart. Any axes previously added to | ||
| the chart will be deleted. | ||||
|
Marek Rosa
|
r1633 | |||
|
Miikka Heikkinen
|
r2494 | \note This function has to be called after all series have been added to the chart. The axes created by this function | ||
| will NOT get automatically attached to any series added to the chart after this function has been called. | ||||
| A series with no axes attached will by default scale to utilize the entire plot area of the chart, which can be confusing | ||||
| if there are other series with properly attached axes also present. | ||||
|
Marek Rosa
|
r1638 | |||
|
Miikka Heikkinen
|
r2494 | \table | ||
|
Marek Rosa
|
r1638 | \header | ||
|
Titta Heikkala
|
r2639 | \li Series type | ||
| \li X-axis | ||||
| \li Y-axis | ||||
|
Marek Rosa
|
r1638 | \row | ||
|
Titta Heikkala
|
r2639 | \li QXYSeries | ||
| \li QValueAxis | ||||
| \li QValueAxis | ||||
|
Marek Rosa
|
r1638 | \row | ||
|
Titta Heikkala
|
r2639 | \li QBarSeries | ||
| \li QBarCategoryAxis | ||||
| \li QValueAxis | ||||
|
Marek Rosa
|
r1638 | \row | ||
|
Titta Heikkala
|
r2639 | \li QPieSeries | ||
| \li None | ||||
| \li None | ||||
|
Miikka Heikkinen
|
r2494 | \endtable | ||
|
Marek Rosa
|
r1638 | |||
|
Miikka Heikkinen
|
r2494 | If there are several QXYSeries derived series added to the chart and no series of other types have been added, then only one pair of axes is created. | ||
| If there are several series of different types added to the chart, then each series gets its own axes pair. | ||||
|
Marek Rosa
|
r1633 | |||
|
Miikka Heikkinen
|
r2494 | The axes specific to the series can be later obtained from the chart by providing the series as the parameter for axes() function call. | ||
|
Marek Rosa
|
r1633 | QPieSeries does not create any axes. | ||
|
Miikka Heikkinen
|
r2494 | \sa axisX(), axisY(), axes(), setAxisX(), setAxisY(), QAbstractSeries::attachAxis() | ||
|
Marek Rosa
|
r1633 | */ | ||
|
Michal Klocek
|
r1577 | void QChart::createDefaultAxes() | ||
| { | ||||
|
Jani Honkonen
|
r2131 | d_ptr->m_dataset->createDefaultAxes(); | ||
|
Michal Klocek
|
r1577 | } | ||
|
sauimone
|
r524 | /*! | ||
|
Miikka Heikkinen
|
r2494 | Returns the legend object of the chart. Ownership stays with the chart. | ||
|
Michal Klocek
|
r740 | */ | ||
|
Jani Honkonen
|
r2131 | QLegend *QChart::legend() const | ||
|
sauimone
|
r524 | { | ||
|
sauimone
|
r783 | return d_ptr->m_legend; | ||
|
sauimone
|
r524 | } | ||
|
Jani Honkonen
|
r2272 | void QChart::setMinimumMargins(const QMargins &margins) | ||
| { | ||||
| qWarning() << "QChart::setMinimumMargins is deprecated. Use QChart::setMargins instead."; | ||||
| d_ptr->m_presenter->layout()->setMargins(margins); | ||||
| } | ||||
| QMargins QChart::minimumMargins() const | ||||
| { | ||||
| qWarning() << "QChart::minimumMargins is deprecated. Use QChart::margins instead."; | ||||
| return d_ptr->m_presenter->layout()->margins(); | ||||
| } | ||||
|
Jani Honkonen
|
r2131 | void QChart::setMargins(const QMargins &margins) | ||
|
Michal Klocek
|
r1883 | { | ||
|
Michal Klocek
|
r2105 | d_ptr->m_presenter->layout()->setMargins(margins); | ||
|
Michal Klocek
|
r1883 | } | ||
|
Michal Klocek
|
r1965 | QMargins QChart::margins() const | ||
|
sauimone
|
r803 | { | ||
|
Michal Klocek
|
r2105 | return d_ptr->m_presenter->layout()->margins(); | ||
|
sauimone
|
r803 | } | ||
|
Miikka Heikkinen
|
r2483 | QChart::ChartType QChart::chartType() const | ||
| { | ||||
| return d_ptr->m_type; | ||||
| } | ||||
|
Marek Rosa
|
r1657 | /*! | ||
|
Miikka Heikkinen
|
r2494 | Returns the the rectangle within which the drawing of the chart is done. | ||
| It does not include the area defined by margins. | ||||
|
Marek Rosa
|
r1657 | */ | ||
|
Michal Klocek
|
r1648 | QRectF QChart::plotArea() const | ||
| { | ||||
|
Michal Klocek
|
r2273 | return d_ptr->m_presenter->geometry(); | ||
|
Michal Klocek
|
r1648 | } | ||
|
Miikka Heikkinen
|
r2498 | /*! | ||
| Sets the \a brush for the background of the plot area of the chart. | ||||
| \sa plotArea(), plotAreaBackgroundVisible, setPlotAreaBackgroundPen(), plotAreaBackgroundBrush() | ||||
| */ | ||||
| void QChart::setPlotAreaBackgroundBrush(const QBrush &brush) | ||||
| { | ||||
| d_ptr->m_presenter->setPlotAreaBackgroundBrush(brush); | ||||
| } | ||||
| /*! | ||||
| Returns the brush for the background of the plot area of the chart. | ||||
| \sa plotArea(), plotAreaBackgroundVisible, plotAreaBackgroundPen(), setPlotAreaBackgroundBrush() | ||||
| */ | ||||
| QBrush QChart::plotAreaBackgroundBrush() const | ||||
| { | ||||
| return d_ptr->m_presenter->plotAreaBackgroundBrush(); | ||||
| } | ||||
| /*! | ||||
| Sets the \a pen for the background of the plot area of the chart. | ||||
| \sa plotArea(), plotAreaBackgroundVisible, setPlotAreaBackgroundBrush(), plotAreaBackgroundPen() | ||||
| */ | ||||
| void QChart::setPlotAreaBackgroundPen(const QPen &pen) | ||||
| { | ||||
| d_ptr->m_presenter->setPlotAreaBackgroundPen(pen); | ||||
| } | ||||
| /*! | ||||
|
Miikka Heikkinen
|
r2503 | Returns the pen for the background of the plot area of the chart. | ||
|
Miikka Heikkinen
|
r2498 | |||
| \sa plotArea(), plotAreaBackgroundVisible, plotAreaBackgroundBrush(), setPlotAreaBackgroundPen() | ||||
| */ | ||||
| QPen QChart::plotAreaBackgroundPen() const | ||||
| { | ||||
| return d_ptr->m_presenter->plotAreaBackgroundPen(); | ||||
| } | ||||
| void QChart::setPlotAreaBackgroundVisible(bool visible) | ||||
| { | ||||
| d_ptr->m_presenter->setPlotAreaBackgroundVisible(visible); | ||||
| } | ||||
| bool QChart::isPlotAreaBackgroundVisible() const | ||||
| { | ||||
| return d_ptr->m_presenter->isPlotAreaBackgroundVisible(); | ||||
| } | ||||
|
Michal Klocek
|
r298 | void QChart::setAnimationOptions(AnimationOptions options) | ||
| { | ||||
|
Michal Klocek
|
r740 | d_ptr->m_presenter->setAnimationOptions(options); | ||
|
Michal Klocek
|
r298 | } | ||
| QChart::AnimationOptions QChart::animationOptions() const | ||||
| { | ||||
|
Michal Klocek
|
r740 | return d_ptr->m_presenter->animationOptions(); | ||
|
Michal Klocek
|
r298 | } | ||
|
Jani Honkonen
|
r1187 | /*! | ||
|
sauimone
|
r1575 | Scrolls the visible area of the chart by the distance defined in the \a dx and \a dy. | ||
|
Miikka Heikkinen
|
r2483 | |||
| For polar charts, \a dx indicates the angle along angular axis instead of distance. | ||||
|
Jani Honkonen
|
r1187 | */ | ||
|
Michal Klocek
|
r1553 | void QChart::scroll(qreal dx, qreal dy) | ||
|
Jani Honkonen
|
r1187 | { | ||
|
Michal Klocek
|
r2273 | d_ptr->scroll(dx,dy); | ||
|
Jani Honkonen
|
r1187 | } | ||
|
Michal Klocek
|
r740 | void QChart::setBackgroundVisible(bool visible) | ||
| { | ||||
|
Michal Klocek
|
r1534 | d_ptr->m_presenter->setBackgroundVisible(visible); | ||
|
Michal Klocek
|
r740 | } | ||
|
sauimone
|
r716 | |||
|
Michal Klocek
|
r740 | bool QChart::isBackgroundVisible() const | ||
| { | ||||
|
Michal Klocek
|
r1534 | return d_ptr->m_presenter->isBackgroundVisible(); | ||
|
sauimone
|
r716 | } | ||
|
Tero Ahola
|
r1462 | void QChart::setDropShadowEnabled(bool enabled) | ||
|
Tero Ahola
|
r1001 | { | ||
|
Michal Klocek
|
r1534 | d_ptr->m_presenter->setBackgroundDropShadowEnabled(enabled); | ||
|
Tero Ahola
|
r1001 | } | ||
|
Tero Ahola
|
r1462 | bool QChart::isDropShadowEnabled() const | ||
|
Tero Ahola
|
r1001 | { | ||
|
Michal Klocek
|
r1534 | return d_ptr->m_presenter->isBackgroundDropShadowEnabled(); | ||
|
Tero Ahola
|
r1001 | } | ||
|
Miikka Heikkinen
|
r2549 | void QChart::setBackgroundRoundness(qreal diameter) | ||
| { | ||||
| d_ptr->m_presenter->setBackgroundRoundness(diameter); | ||||
| } | ||||
| qreal QChart::backgroundRoundness() const | ||||
| { | ||||
| return d_ptr->m_presenter->backgroundRoundness(); | ||||
| } | ||||
|
Jani Honkonen
|
r1316 | /*! | ||
|
Miikka Heikkinen
|
r2494 | Returns all series that are added to the chart. | ||
|
Jani Honkonen
|
r1316 | |||
| \sa addSeries(), removeSeries(), removeAllSeries() | ||||
| */ | ||||
|
Jani Honkonen
|
r2131 | QList<QAbstractSeries *> QChart::series() const | ||
|
Michal Klocek
|
r1107 | { | ||
| return d_ptr->m_dataset->series(); | ||||
| } | ||||
|
Michal Klocek
|
r1534 | |||
|
Marek Rosa
|
r1633 | /*! | ||
|
Miikka Heikkinen
|
r2494 | Adds the \a axis to the chart and attaches it to the \a series as a bottom-aligned horizontal axis. | ||
| The chart takes ownership of both the \a axis and the \a series. | ||||
| Any horizontal axes previously attached to the \a series are deleted. | ||||
|
Marek Rosa
|
r1633 | |||
|
Miikka Heikkinen
|
r2494 | \sa axisX(), axisY(), setAxisY(), createDefaultAxes(), QAbstractSeries::attachAxis() | ||
|
Marek Rosa
|
r1633 | */ | ||
|
Miikka Heikkinen
|
r2494 | void QChart::setAxisX(QAbstractAxis *axis ,QAbstractSeries *series) | ||
|
Michal Klocek
|
r1541 | { | ||
|
Miikka Heikkinen
|
r2494 | QList<QAbstractAxis*> list = axes(Qt::Horizontal, series); | ||
|
Michal Klocek
|
r2273 | |||
|
Miikka Heikkinen
|
r2494 | foreach (QAbstractAxis* a, list) { | ||
|
Michal Klocek
|
r2278 | d_ptr->m_dataset->removeAxis(a); | ||
| delete a; | ||||
|
Marek Rosa
|
r2344 | } | ||
|
Michal Klocek
|
r2273 | |||
|
Miikka Heikkinen
|
r2494 | if (!d_ptr->m_dataset->axes().contains(axis)) | ||
| d_ptr->m_dataset->addAxis(axis, Qt::AlignBottom); | ||||
| d_ptr->m_dataset->attachAxis(series, axis); | ||||
|
Michal Klocek
|
r1541 | } | ||
|
Marek Rosa
|
r1633 | /*! | ||
|
Miikka Heikkinen
|
r2494 | Adds the \a axis to the chart and attaches it to the \a series as a left-aligned vertical axis. | ||
| The chart takes ownership of both the \a axis and the \a series. | ||||
| Any vertical axes previously attached to the \a series are deleted. | ||||
|
Marek Rosa
|
r1633 | |||
|
Miikka Heikkinen
|
r2494 | \sa axisX(), axisY(), setAxisX(), createDefaultAxes(), QAbstractSeries::attachAxis() | ||
|
Marek Rosa
|
r1633 | */ | ||
|
Miikka Heikkinen
|
r2494 | void QChart::setAxisY(QAbstractAxis *axis ,QAbstractSeries *series) | ||
|
Michal Klocek
|
r1541 | { | ||
|
Miikka Heikkinen
|
r2494 | QList<QAbstractAxis*> list = axes(Qt::Vertical, series); | ||
|
Michal Klocek
|
r2273 | |||
|
Miikka Heikkinen
|
r2494 | foreach (QAbstractAxis* a, list) { | ||
|
Michal Klocek
|
r2278 | d_ptr->m_dataset->removeAxis(a); | ||
| delete a; | ||||
|
Michal Klocek
|
r2273 | } | ||
|
Miikka Heikkinen
|
r2494 | if (!d_ptr->m_dataset->axes().contains(axis)) | ||
| d_ptr->m_dataset->addAxis(axis, Qt::AlignLeft); | ||||
| d_ptr->m_dataset->attachAxis(series, axis); | ||||
|
Michal Klocek
|
r2273 | } | ||
|
Tero Ahola
|
r2360 | /*! | ||
|
Miikka Heikkinen
|
r2494 | Adds the \a axis to the chart with \a alignment. The chart takes the ownership of the axis. | ||
|
Tero Ahola
|
r2360 | \sa removeAxis(), createDefaultAxes(), QAbstractSeries::attachAxis() | ||
| */ | ||||
| void QChart::addAxis(QAbstractAxis *axis, Qt::Alignment alignment) | ||||
|
Michal Klocek
|
r2273 | { | ||
|
Tero Ahola
|
r2360 | d_ptr->m_dataset->addAxis(axis, alignment); | ||
|
Michal Klocek
|
r2273 | } | ||
|
Tero Ahola
|
r2360 | /*! | ||
|
Miikka Heikkinen
|
r2494 | Removes the \a axis from the chart. | ||
| The chart releases its ownership of the specified \a axis object. | ||||
|
Tero Ahola
|
r2360 | \sa addAxis(), createDefaultAxes(), QAbstractSeries::detachAxis() | ||
| */ | ||||
|
Michal Klocek
|
r2273 | void QChart::removeAxis(QAbstractAxis *axis) | ||
| { | ||||
|
Marek Rosa
|
r2344 | d_ptr->m_dataset->removeAxis(axis); | ||
| } | ||||
|
Marek Rosa
|
r2357 | /*! | ||
|
Miikka Heikkinen
|
r2494 | Returns the value in the \a series domain that corresponds to the \a position relative to chart widget. | ||
|
Marek Rosa
|
r2357 | */ | ||
|
Marek Rosa
|
r2344 | QPointF QChart::mapToValue(const QPointF &position, QAbstractSeries *series) | ||
| { | ||||
| return d_ptr->m_dataset->mapToValue(position, series); | ||||
| } | ||||
|
Marek Rosa
|
r2357 | /*! | ||
|
Miikka Heikkinen
|
r2494 | Returns the position on the chart widget that corresponds to the \a value in the \a series domain. | ||
|
Marek Rosa
|
r2357 | */ | ||
|
Marek Rosa
|
r2344 | QPointF QChart::mapToPosition(const QPointF &value, QAbstractSeries *series) | ||
| { | ||||
| return d_ptr->m_dataset->mapToPosition(value, series); | ||||
|
Michal Klocek
|
r1541 | } | ||
|
Michal Klocek
|
r740 | ////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////// | ||
|
Michal Klocek
|
r639 | |||
|
Miikka Heikkinen
|
r2483 | QChartPrivate::QChartPrivate(QChart *q, QChart::ChartType type): | ||
|
Michal Klocek
|
r2273 | q_ptr(q), | ||
|
Marek Rosa
|
r924 | m_legend(0), | ||
|
Michal Klocek
|
r2273 | m_dataset(new ChartDataSet(q)), | ||
|
Miikka Heikkinen
|
r2483 | m_presenter(new ChartPresenter(q, type)), | ||
|
Miikka Heikkinen
|
r2504 | m_themeManager(new ChartThemeManager(q)), | ||
| m_type(type) | ||||
|
Michal Klocek
|
r639 | { | ||
|
Michal Klocek
|
r2273 | 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*))); | ||||
|
Michal Klocek
|
r639 | } | ||
|
Michal Klocek
|
r740 | QChartPrivate::~QChartPrivate() | ||
|
Michal Klocek
|
r639 | { | ||
| } | ||||
|
Miikka Heikkinen
|
r2516 | // Hackish solution to the problem of explicitly assigning the default pen/brush/font | ||
| // to a series or axis and having theme override it: | ||||
| // Initialize pens, brushes, and fonts to something nobody is likely to ever use, | ||||
| // so that default theme initialization will always set these properly. | ||||
| QPen &QChartPrivate::defaultPen() | ||||
| { | ||||
|
Miikka Heikkinen
|
r2543 | static QPen defaultPen(QColor(1, 2, 0), 0.93247536); | ||
| return defaultPen; | ||||
|
Miikka Heikkinen
|
r2516 | } | ||
| QBrush &QChartPrivate::defaultBrush() | ||||
| { | ||||
|
Miikka Heikkinen
|
r2543 | static QBrush defaultBrush(QColor(1, 2, 0), Qt::Dense7Pattern); | ||
| return defaultBrush; | ||||
|
Miikka Heikkinen
|
r2516 | } | ||
| QFont &QChartPrivate::defaultFont() | ||||
| { | ||||
|
Miikka Heikkinen
|
r2543 | static bool defaultFontInitialized(false); | ||
| static QFont defaultFont; | ||||
| if (!defaultFontInitialized) { | ||||
| defaultFont.setPointSizeF(8.34563465); | ||||
| defaultFontInitialized = true; | ||||
|
Miikka Heikkinen
|
r2516 | } | ||
|
Miikka Heikkinen
|
r2543 | return defaultFont; | ||
|
Miikka Heikkinen
|
r2516 | } | ||
|
Miikka Heikkinen
|
r2483 | void QChartPrivate::init() | ||
| { | ||||
| m_legend = new LegendScroller(q_ptr); | ||||
| q_ptr->setTheme(QChart::ChartThemeLight); | ||||
| q_ptr->setLayout(m_presenter->layout()); | ||||
| } | ||||
|
Michal Klocek
|
r2273 | void QChartPrivate::zoomIn(qreal factor) | ||
|
Michal Klocek
|
r871 | { | ||
|
Michal Klocek
|
r2273 | 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()) | ||||
|
Marek Rosa
|
r2344 | return; | ||
|
Michal Klocek
|
r2273 | |||
| 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()); | ||||
| } | ||||
|
Miikka Heikkinen
|
r2545 | void QChartPrivate::zoomReset() | ||
| { | ||||
| m_dataset->zoomResetDomain(); | ||||
| } | ||||
| bool QChartPrivate::isZoomed() | ||||
| { | ||||
| return m_dataset->isZoomedDomain(); | ||||
| } | ||||
|
Michal Klocek
|
r2273 | 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()); | ||||
|
Michal Klocek
|
r871 | } | ||
|
Tero Ahola
|
r64 | #include "moc_qchart.cpp" | ||
|
Tero Ahola
|
r48 | |||
|
Tero Ahola
|
r30 | QTCOMMERCIALCHART_END_NAMESPACE | ||