/**************************************************************************** ** ** Copyright (C) 2016 The Qt Company Ltd. ** Contact: https://www.qt.io/licensing/ ** ** This file is part of the Qt Charts module of the Qt Toolkit. ** ** $QT_BEGIN_LICENSE:GPL$ ** 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 ** 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. ** ** $QT_END_LICENSE$ ** ****************************************************************************/ // W A R N I N G // ------------- // // This file is not part of the Qt Chart API. It exists purely as an // implementation detail. This header file may change from version to // version without notice, or even be removed. // // We mean it. #ifndef DECLARATIVECHART_H #define DECLARATIVECHART_H #include #include #include #include #include #include #include #include #include QT_CHARTS_BEGIN_NAMESPACE class DeclarativeMargins; class Domain; class DeclarativeAxes; class QT_QMLCHARTS_PRIVATE_EXPORT DeclarativeChart : public QQuickItem { Q_OBJECT Q_PROPERTY(Theme theme READ theme WRITE setTheme) Q_PROPERTY(Animation animationOptions READ animationOptions WRITE setAnimationOptions) Q_PROPERTY(int animationDuration READ animationDuration WRITE setAnimationDuration NOTIFY animationDurationChanged REVISION 5) Q_PROPERTY(QEasingCurve animationEasingCurve READ animationEasingCurve WRITE setAnimationEasingCurve NOTIFY animationEasingCurveChanged REVISION 5) Q_PROPERTY(QString title READ title WRITE setTitle) Q_PROPERTY(QFont titleFont READ titleFont WRITE setTitleFont) Q_PROPERTY(QColor titleColor READ titleColor WRITE setTitleColor NOTIFY titleColorChanged) Q_PROPERTY(QtCharts::QLegend *legend READ legend CONSTANT) Q_PROPERTY(int count READ count) Q_PROPERTY(QColor backgroundColor READ backgroundColor WRITE setBackgroundColor NOTIFY backgroundColorChanged) Q_PROPERTY(bool dropShadowEnabled READ dropShadowEnabled WRITE setDropShadowEnabled NOTIFY dropShadowEnabledChanged) Q_PROPERTY(qreal backgroundRoundness READ backgroundRoundness WRITE setBackgroundRoundness NOTIFY backgroundRoundnessChanged REVISION 3) Q_PROPERTY(QtCharts::DeclarativeMargins *margins READ margins NOTIFY marginsChanged REVISION 2) Q_PROPERTY(QRectF plotArea READ plotArea WRITE setPlotArea NOTIFY plotAreaChanged REVISION 1) Q_PROPERTY(QColor plotAreaColor READ plotAreaColor WRITE setPlotAreaColor NOTIFY plotAreaColorChanged REVISION 3) Q_PROPERTY(QQmlListProperty axes READ axes REVISION 2) Q_PROPERTY(bool localizeNumbers READ localizeNumbers WRITE setLocalizeNumbers NOTIFY localizeNumbersChanged REVISION 4) Q_PROPERTY(QLocale locale READ locale WRITE setLocale NOTIFY localeChanged REVISION 4) Q_ENUMS(Animation) Q_ENUMS(Theme) Q_ENUMS(SeriesType) public: // duplicating enums from QChart to make the QML api namings 1-to-1 with the C++ api enum Theme { ChartThemeLight = 0, ChartThemeBlueCerulean, ChartThemeDark, ChartThemeBrownSand, ChartThemeBlueNcs, ChartThemeHighContrast, ChartThemeBlueIcy, ChartThemeQt }; enum Animation { NoAnimation = 0x0, GridAxisAnimations = 0x1, SeriesAnimations = 0x2, AllAnimations = 0x3 }; enum SeriesType { SeriesTypeLine, SeriesTypeArea, SeriesTypeBar, SeriesTypeStackedBar, SeriesTypePercentBar, SeriesTypePie, SeriesTypeScatter, SeriesTypeSpline, SeriesTypeHorizontalBar, SeriesTypeHorizontalStackedBar, SeriesTypeHorizontalPercentBar, SeriesTypeBoxPlot, SeriesTypeCandlestick }; public: DeclarativeChart(QQuickItem *parent = 0); ~DeclarativeChart(); public: // From parent classes void childEvent(QChildEvent *event); void componentComplete(); void geometryChanged(const QRectF &newGeometry, const QRectF &oldGeometry); QSGNode *updatePaintNode(QSGNode *oldNode, UpdatePaintNodeData *); protected: void mousePressEvent(QMouseEvent *event); void mouseReleaseEvent(QMouseEvent *event); void hoverMoveEvent(QHoverEvent *event); void mouseDoubleClickEvent(QMouseEvent *event); private Q_SLOTS: void handleAntialiasingChanged(bool enable); void sceneChanged(QList region); void renderScene(); public: void setTheme(DeclarativeChart::Theme theme); DeclarativeChart::Theme theme(); void setAnimationOptions(DeclarativeChart::Animation animations); DeclarativeChart::Animation animationOptions(); void setAnimationDuration(int msecs); int animationDuration() const; void setAnimationEasingCurve(const QEasingCurve &curve); QEasingCurve animationEasingCurve() const; void setTitle(QString title); QString title(); QLegend *legend(); QFont titleFont() const; void setTitleFont(const QFont &font); void setTitleColor(QColor color); QColor titleColor(); void setBackgroundColor(QColor color); QColor backgroundColor(); void setPlotAreaColor(QColor color); QColor plotAreaColor(); void setLocalizeNumbers(bool localize); bool localizeNumbers() const; void setLocale(const QLocale &locale); QLocale locale() const; int count(); void setDropShadowEnabled(bool enabled); bool dropShadowEnabled(); qreal backgroundRoundness() const; void setBackgroundRoundness(qreal diameter); // Margins & plotArea DeclarativeMargins *margins() { return m_margins; } QRectF plotArea() { return m_chart->plotArea(); } void setPlotArea(const QRectF &rect); // Axis handling QAbstractAxis *defaultAxis(Qt::Orientation orientation, QAbstractSeries *series); void initializeAxes(QAbstractSeries *series); void doInitializeAxes(QAbstractSeries *series, DeclarativeAxes *axes); QQmlListProperty axes(); static void axesAppendFunc(QQmlListProperty *list, QAbstractAxis *element); static int axesCountFunc(QQmlListProperty *list); static QAbstractAxis *axesAtFunc(QQmlListProperty *list, int index); static void axesClearFunc(QQmlListProperty *list); public: Q_INVOKABLE QAbstractSeries *series(int index); Q_INVOKABLE QAbstractSeries *series(QString seriesName); Q_INVOKABLE QAbstractSeries *createSeries(int type, QString name = "", QAbstractAxis *axisX = 0, QAbstractAxis *axisY = 0); Q_INVOKABLE void removeSeries(QAbstractSeries *series); Q_INVOKABLE void removeAllSeries() { m_chart->removeAllSeries(); } Q_INVOKABLE void setAxisX(QAbstractAxis *axis, QAbstractSeries *series = 0); Q_INVOKABLE void setAxisY(QAbstractAxis *axis, QAbstractSeries *series = 0); Q_INVOKABLE QAbstractAxis *axisX(QAbstractSeries *series = 0); Q_INVOKABLE QAbstractAxis *axisY(QAbstractSeries *series = 0); Q_INVOKABLE void zoom(qreal factor); Q_REVISION(5) Q_INVOKABLE void zoomIn(); Q_REVISION(5) Q_INVOKABLE void zoomIn(const QRectF &rectangle); Q_REVISION(5) Q_INVOKABLE void zoomOut(); Q_REVISION(5) Q_INVOKABLE void zoomReset(); Q_REVISION(5) Q_INVOKABLE bool isZoomed(); Q_INVOKABLE void scrollLeft(qreal pixels); Q_INVOKABLE void scrollRight(qreal pixels); Q_INVOKABLE void scrollUp(qreal pixels); Q_INVOKABLE void scrollDown(qreal pixels); Q_REVISION(5) Q_INVOKABLE QPointF mapToValue(const QPointF &position, QAbstractSeries *series = 0); Q_REVISION(5) Q_INVOKABLE QPointF mapToPosition(const QPointF &value, QAbstractSeries *series = 0); Q_SIGNALS: void axisLabelsChanged(); void titleColorChanged(QColor color); void backgroundColorChanged(); void dropShadowEnabledChanged(bool enabled); Q_REVISION(2) void marginsChanged(); void plotAreaChanged(QRectF plotArea); void seriesAdded(QAbstractSeries *series); void seriesRemoved(QAbstractSeries *series); Q_REVISION(3) void plotAreaColorChanged(); Q_REVISION(3) void backgroundRoundnessChanged(qreal diameter); Q_REVISION(4) void localizeNumbersChanged(); Q_REVISION(4) void localeChanged(); Q_REVISION(5) void animationDurationChanged(int msecs); Q_REVISION(5) void animationEasingCurveChanged(QEasingCurve curve); void needRender(); void pendingRenderNodeMouseEventResponses(); private Q_SLOTS: void changeMargins(int top, int bottom, int left, int right); void handleAxisXSet(QAbstractAxis *axis); void handleAxisYSet(QAbstractAxis *axis); void handleAxisXTopSet(QAbstractAxis *axis); void handleAxisYRightSet(QAbstractAxis *axis); void handleSeriesAdded(QAbstractSeries *series); void handlePendingRenderNodeMouseEventResponses(); protected: explicit DeclarativeChart(QChart::ChartType type, QQuickItem *parent); private: void initChart(QChart::ChartType type); void seriesAxisAttachHelper(QAbstractSeries *series, QAbstractAxis *axis, Qt::Orientations orientation, Qt::Alignment alignment); void findMinMaxForSeries(QAbstractSeries *series,Qt::Orientations orientation, qreal &min, qreal &max); void queueRendererMouseEvent(QMouseEvent *event); // Extending QChart with DeclarativeChart is not possible because QObject does not support // multi inheritance, so we now have a QChart as a member instead QChart *m_chart; QGraphicsScene *m_scene; QPointF m_mousePressScenePoint; QPoint m_mousePressScreenPoint; QPointF m_lastMouseMoveScenePoint; QPoint m_lastMouseMoveScreenPoint; Qt::MouseButton m_mousePressButton; Qt::MouseButtons m_mousePressButtons; QImage *m_sceneImage; bool m_sceneImageDirty; bool m_updatePending; Qt::HANDLE m_paintThreadId; Qt::HANDLE m_guiThreadId; DeclarativeMargins *m_margins; GLXYSeriesDataManager *m_glXYDataManager; bool m_sceneImageNeedsClear; QVector m_pendingRenderNodeMouseEvents; QVector m_pendingRenderNodeMouseEventResponses; QRectF m_adjustedPlotArea; }; QT_CHARTS_END_NAMESPACE #endif // DECLARATIVECHART_H