qcategoryaxis.cpp
376 lines
| 11.3 KiB
| text/x-c
|
CppLexer
Miikka Heikkinen
|
r2854 | /**************************************************************************** | ||
Marek Rosa
|
r1701 | ** | ||
|
Miikka Heikkinen
|
r2854 | ** Copyright (C) 2016 The Qt Company Ltd. | ||
| ** Contact: https://www.qt.io/licensing/ | ||||
|
Marek Rosa
|
r1701 | ** | ||
|
Miikka Heikkinen
|
r2854 | ** This file is part of the Qt Charts module of the Qt Toolkit. | ||
|
Marek Rosa
|
r1701 | ** | ||
|
Miikka Heikkinen
|
r2854 | ** $QT_BEGIN_LICENSE:GPL$ | ||
Titta Heikkala
|
r2845 | ** 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 | ||||
|
Miikka Heikkinen
|
r2854 | ** 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. | ||||
|
Marek Rosa
|
r1701 | ** | ||
|
Titta Heikkala
|
r2845 | ** $QT_END_LICENSE$ | ||
| ** | ||||
|
Miikka Heikkinen
|
r2854 | ****************************************************************************/ | ||
|
Marek Rosa
|
r1701 | |||
|
Titta Heikkala
|
r2714 | #include <QtCharts/QCategoryAxis> | ||
| #include <private/qcategoryaxis_p.h> | ||||
| #include <private/chartcategoryaxisx_p.h> | ||||
| #include <private/chartcategoryaxisy_p.h> | ||||
| #include <private/polarchartcategoryaxisangular_p.h> | ||||
| #include <private/polarchartcategoryaxisradial_p.h> | ||||
| #include <QtCharts/QChart> | ||||
| #include <QtCore/QtMath> | ||||
| #include <QtCore/QDebug> | ||||
|
Marek Rosa
|
r1701 | |||
Titta Heikkala
|
r2712 | QT_CHARTS_BEGIN_NAMESPACE | ||
|
Marek Rosa
|
r1701 | /*! | ||
|
Marek Rosa
|
r1816 | \class QCategoryAxis | ||
|
Titta Heikkala
|
r2639 | \inmodule Qt Charts | ||
|
Marek Rosa
|
r1834 | \brief The QCategoryAxis class allows putting a named ranges on the axis. | ||
| This class can be used when the underlying data needs to be given extra meaning. | ||||
| Unlike with the QBarCategoryAxis the QCategoryAxis allows the categories ranges widths to be specified freely. | ||||
|
Marek Rosa
|
r1887 | |||
Tero Ahola
|
r2220 | Example code on how to use QCategoryAxis: | ||
|
Titta Heikkala
|
r2750 | \image api_category_axis.png | ||
| \code | ||||
| QChartView *chartView = new QChartView; | ||||
| QLineSeries *series = new QLineSeries; | ||||
| // ... | ||||
| chartView->chart()->addSeries(series); | ||||
|
Marek Rosa
|
r1887 | |||
|
Titta Heikkala
|
r2750 | QCategoryAxis *axisY = new QCategoryAxis; | ||
| axisY->setMin(0); | ||||
| axisY->setMax(52); | ||||
| axisY->setStartValue(15); | ||||
| axisY->append("First", 20); | ||||
| axisY->append("Second", 37); | ||||
| axisY->append("Third", 52); | ||||
| chartView->chart()->setAxisY(axisY, series); | ||||
| \endcode | ||||
|
Marek Rosa
|
r1701 | */ | ||
|
Titta Heikkala
|
r2639 | /*! | ||
| \qmltype CategoryAxis | ||||
| \instantiates QCategoryAxis | ||||
|
Titta Heikkala
|
r2712 | \inqmlmodule QtCharts | ||
|
Titta Heikkala
|
r2639 | |||
|
Titta Heikkala
|
r2712 | \inherits AbstractAxis | ||
| \brief CategoryAxis allows putting a named ranges on the axis. | ||||
|
Tero Ahola
|
r1870 | |||
|
Titta Heikkala
|
r2712 | For example: | ||
|
Titta Heikkala
|
r2750 | \image examples_qmlaxes3.png | ||
| \snippet qmlaxes/qml/qmlaxes/View3.qml 1 | ||||
|
Marek Rosa
|
r1834 | */ | ||
| /*! | ||||
| \property QCategoryAxis::startValue | ||||
| Defines the low end of the first category on the axis. | ||||
| */ | ||||
| /*! | ||||
| \qmlproperty int CategoryAxis::startValue | ||||
| Defines the low end of the first category on the axis. | ||||
|
Marek Rosa
|
r1701 | */ | ||
|
Tero Ahola
|
r2249 | /*! | ||
| \property QCategoryAxis::count | ||||
| The count of categories. | ||||
| */ | ||||
| /*! | ||||
| \qmlproperty int CategoryAxis::count | ||||
| The count of categories. | ||||
| */ | ||||
| /*! | ||||
| \property QCategoryAxis::categoriesLabels | ||||
| The category labels as a string list. | ||||
| */ | ||||
| /*! | ||||
| \qmlproperty StringList CategoryAxis::categoriesLabels | ||||
| The category labels as a list of strings. | ||||
| */ | ||||
Miikka Heikkinen
|
r2483 | /*! | ||
| \fn void QCategoryAxis::categoriesChanged() | ||||
| Axis emits signal when the categories of the axis have changed. | ||||
| */ | ||||
|
Titta Heikkala
|
r2780 | /*! | ||
| \enum QCategoryAxis::AxisLabelsPosition | ||||
| This enum describes the position of the category labels. | ||||
| \value AxisLabelsPositionCenter Labels are centered to category. | ||||
| \value AxisLabelsPositionOnValue Labels are positioned to the high end limit of the category. | ||||
| */ | ||||
| /*! | ||||
| \property QCategoryAxis::labelsPosition | ||||
| Defines the position of the category labels. The labels in the beginning and in the end of the | ||||
| axes may overlap other axes labels when positioned on value. | ||||
| */ | ||||
| /*! | ||||
| \qmlproperty AxisLabelsPosition CategoryAxis::labelsPosition | ||||
| Defines the position of the category labels. The labels in the beginning and in the end of the | ||||
| axes may overlap other axes labels when positioned on value. | ||||
| */ | ||||
|
Miikka Heikkinen
|
r2483 | |||
|
Marek Rosa
|
r1701 | /*! | ||
| Constructs an axis object which is a child of \a parent. | ||||
| */ | ||||
|
Marek Rosa
|
r1816 | QCategoryAxis::QCategoryAxis(QObject *parent): | ||
Jani Honkonen
|
r2097 | QValueAxis(*new QCategoryAxisPrivate(this), parent) | ||
|
Marek Rosa
|
r1701 | { | ||
| } | ||||
| /*! | ||||
| Destroys the object | ||||
| */ | ||||
|
Marek Rosa
|
r1816 | QCategoryAxis::~QCategoryAxis() | ||
|
Marek Rosa
|
r1701 | { | ||
Michal Klocek
|
r2273 | Q_D(QCategoryAxis); | ||
| if (d->m_chart) | ||||
| d->m_chart->removeAxis(this); | ||||
|
Marek Rosa
|
r1701 | } | ||
| /*! | ||||
| \internal | ||||
| */ | ||||
|
Jani Honkonen
|
r2097 | QCategoryAxis::QCategoryAxis(QCategoryAxisPrivate &d, QObject *parent): QValueAxis(d, parent) | ||
|
Marek Rosa
|
r1701 | { | ||
| } | ||||
|
Tero Ahola
|
r1870 | /*! | ||
| \qmlmethod CategoryAxis::append(string label, real endValue) | ||||
| Appends new category to the axis with an \a label. Category label has to be unique. | ||||
| Parameter \a endValue specifies the high end limit of the category. | ||||
| It has to be greater than the high end limit of the previous category. | ||||
| Otherwise the method returns without adding a new category. | ||||
| */ | ||||
|
Marek Rosa
|
r1701 | /*! | ||
|
Marek Rosa
|
r1829 | Appends new category to the axis with an \a categoryLabel. | ||
| Category label has to be unique. | ||||
|
Marek Rosa
|
r1849 | Parameter \a categoryEndValue specifies the high end limit of the category. | ||
|
Marek Rosa
|
r1829 | It has to be greater than the high end limit of the previous category. | ||
| Otherwise the method returns without adding a new category. | ||||
|
Marek Rosa
|
r1701 | */ | ||
|
Jani Honkonen
|
r2104 | void QCategoryAxis::append(const QString &categoryLabel, qreal categoryEndValue) | ||
|
Marek Rosa
|
r1701 | { | ||
|
Marek Rosa
|
r1816 | Q_D(QCategoryAxis); | ||
|
Marek Rosa
|
r1708 | |||
|
Jani Honkonen
|
r2097 | if (!d->m_categories.contains(categoryLabel)) { | ||
| if (d->m_categories.isEmpty()) { | ||||
|
Marek Rosa
|
r1849 | Range range(d->m_categoryMinimum, categoryEndValue); | ||
|
Marek Rosa
|
r1829 | d->m_categoriesMap.insert(categoryLabel, range); | ||
| d->m_categories.append(categoryLabel); | ||||
|
Miikka Heikkinen
|
r2483 | emit categoriesChanged(); | ||
|
Jani Honkonen
|
r2097 | } else if (categoryEndValue > endValue(d->m_categories.last())) { | ||
|
Marek Rosa
|
r1829 | Range previousRange = d->m_categoriesMap.value(d->m_categories.last()); | ||
|
Marek Rosa
|
r1849 | d->m_categoriesMap.insert(categoryLabel, Range(previousRange.second, categoryEndValue)); | ||
|
Marek Rosa
|
r1829 | d->m_categories.append(categoryLabel); | ||
|
Miikka Heikkinen
|
r2483 | emit categoriesChanged(); | ||
|
Marek Rosa
|
r1708 | } | ||
|
Marek Rosa
|
r1701 | } | ||
| } | ||||
|
Marek Rosa
|
r1834 | /*! | ||
| Sets \a min to be the low end limit of the first category on the axis. | ||||
|
Marek Rosa
|
r1847 | If there is already some categories added to the axis then passed value must be lower than the high end value of the already defined first category range. | ||
| Otherwise nothing is done. | ||||
|
Marek Rosa
|
r1731 | */ | ||
|
Marek Rosa
|
r1829 | void QCategoryAxis::setStartValue(qreal min) | ||
|
Marek Rosa
|
r1701 | { | ||
|
Marek Rosa
|
r1816 | Q_D(QCategoryAxis); | ||
|
Jani Honkonen
|
r2097 | if (d->m_categories.isEmpty()) { | ||
|
Marek Rosa
|
r1708 | d->m_categoryMinimum = min; | ||
|
Miikka Heikkinen
|
r2483 | emit categoriesChanged(); | ||
|
Jani Honkonen
|
r2097 | } else { | ||
|
Marek Rosa
|
r1829 | Range range = d->m_categoriesMap.value(d->m_categories.first()); | ||
|
Miikka Heikkinen
|
r2483 | if (min < range.second) { | ||
|
Marek Rosa
|
r1847 | d->m_categoriesMap.insert(d->m_categories.first(), Range(min, range.second)); | ||
|
Miikka Heikkinen
|
r2483 | emit categoriesChanged(); | ||
| } | ||||
|
Marek Rosa
|
r1708 | } | ||
|
Marek Rosa
|
r1701 | } | ||
|
Marek Rosa
|
r1731 | /*! | ||
|
Marek Rosa
|
r1829 | Returns the low end limit of the category specified by an \a categoryLabel | ||
|
Marek Rosa
|
r1731 | */ | ||
|
Jani Honkonen
|
r2104 | qreal QCategoryAxis::startValue(const QString &categoryLabel) const | ||
|
Marek Rosa
|
r1701 | { | ||
|
Marek Rosa
|
r1816 | Q_D(const QCategoryAxis); | ||
|
Jani Honkonen
|
r1935 | if (categoryLabel.isEmpty()) | ||
|
Marek Rosa
|
r1847 | return d->m_categoryMinimum; | ||
|
Jani Honkonen
|
r2097 | return d->m_categoriesMap.value(categoryLabel).first; | ||
|
Marek Rosa
|
r1701 | } | ||
|
Marek Rosa
|
r1731 | /*! | ||
|
Marek Rosa
|
r1829 | Returns the high end limit of the interval specified by an \a categoryLabel | ||
|
Marek Rosa
|
r1731 | */ | ||
|
Jani Honkonen
|
r2104 | qreal QCategoryAxis::endValue(const QString &categoryLabel) const | ||
|
Marek Rosa
|
r1701 | { | ||
|
Marek Rosa
|
r1816 | Q_D(const QCategoryAxis); | ||
|
Marek Rosa
|
r1829 | return d->m_categoriesMap.value(categoryLabel).second; | ||
|
Marek Rosa
|
r1701 | } | ||
|
Tero Ahola
|
r1870 | /*! | ||
| \qmlmethod CategoryAxis::remove(string label) | ||||
| Removes a category specified by the \a label from the axis | ||||
| */ | ||||
|
Marek Rosa
|
r1701 | /*! | ||
|
Marek Rosa
|
r1829 | Removes an interval specified by the \a categoryLabel from the axis | ||
|
Marek Rosa
|
r1701 | */ | ||
|
Marek Rosa
|
r1829 | void QCategoryAxis::remove(const QString &categoryLabel) | ||
|
Marek Rosa
|
r1701 | { | ||
|
Marek Rosa
|
r1816 | Q_D(QCategoryAxis); | ||
|
Marek Rosa
|
r1829 | int labelIndex = d->m_categories.indexOf(categoryLabel); | ||
|
Marek Rosa
|
r1708 | |||
| // check if such label exists | ||||
| if (labelIndex != -1) { | ||||
|
Marek Rosa
|
r1829 | d->m_categories.removeAt(labelIndex); | ||
| d->m_categoriesMap.remove(categoryLabel); | ||||
|
Marek Rosa
|
r1708 | |||
| // the range of the interval that follows (if exists) needs to be updated | ||||
|
Marek Rosa
|
r1829 | if (labelIndex < d->m_categories.count()) { | ||
| QString label = d->m_categories.at(labelIndex); | ||||
| Range range = d->m_categoriesMap.value(label); | ||||
|
Marek Rosa
|
r1708 | |||
| // set the range | ||||
| if (labelIndex == 0) { | ||||
| range.first = d->m_categoryMinimum; | ||||
|
Marek Rosa
|
r1829 | d->m_categoriesMap.insert(label, range); | ||
|
Marek Rosa
|
r1708 | } else { | ||
|
Marek Rosa
|
r1829 | range.first = d->m_categoriesMap.value(d->m_categories.at(labelIndex - 1)).second; | ||
| d->m_categoriesMap.insert(label, range); | ||||
|
Marek Rosa
|
r1708 | } | ||
|
Michal Klocek
|
r2407 | } | ||
|
Miikka Heikkinen
|
r2483 | emit categoriesChanged(); | ||
|
Marek Rosa
|
r1708 | } | ||
|
Marek Rosa
|
r1701 | } | ||
|
Tero Ahola
|
r1870 | /*! | ||
| \qmlmethod CategoryAxis::replace(string oldLabel, string newLabel) | ||||
| Replaces \a oldLabel of an existing category with a \a newLabel. | ||||
| If the old label does not exist the method returns without making any changes. | ||||
| */ | ||||
|
Marek Rosa
|
r1800 | /*! | ||
|
Marek Rosa
|
r1829 | Replaces \a oldLabel of an existing category with a \a newLabel | ||
|
Marek Rosa
|
r1800 | If the old label does not exist the method returns without making any changes. | ||
| */ | ||||
|
Jani Honkonen
|
r2104 | void QCategoryAxis::replaceLabel(const QString &oldLabel, const QString &newLabel) | ||
|
Marek Rosa
|
r1777 | { | ||
|
Marek Rosa
|
r1816 | Q_D(QCategoryAxis); | ||
|
Marek Rosa
|
r1829 | int labelIndex = d->m_categories.indexOf(oldLabel); | ||
|
Marek Rosa
|
r1777 | |||
| // check if such label exists | ||||
| if (labelIndex != -1) { | ||||
|
Marek Rosa
|
r1829 | d->m_categories.replace(labelIndex, newLabel); | ||
| Range range = d->m_categoriesMap.value(oldLabel); | ||||
| d->m_categoriesMap.remove(oldLabel); | ||||
|
Michal Klocek
|
r2407 | d->m_categoriesMap.insert(newLabel, range); | ||
|
Miikka Heikkinen
|
r2483 | emit categoriesChanged(); | ||
|
Marek Rosa
|
r1777 | } | ||
| } | ||||
|
Marek Rosa
|
r1800 | /*! | ||
| Returns the list of the intervals labels | ||||
| */ | ||||
|
Marek Rosa
|
r1829 | QStringList QCategoryAxis::categoriesLabels() | ||
|
Marek Rosa
|
r1701 | { | ||
|
Marek Rosa
|
r1816 | Q_D(QCategoryAxis); | ||
|
Marek Rosa
|
r1829 | return d->m_categories; | ||
|
Marek Rosa
|
r1701 | } | ||
| /*! | ||||
|
Marek Rosa
|
r1799 | Returns number of intervals. | ||
|
Marek Rosa
|
r1701 | */ | ||
|
Marek Rosa
|
r1816 | int QCategoryAxis::count() const | ||
|
Marek Rosa
|
r1701 | { | ||
|
Marek Rosa
|
r1816 | Q_D(const QCategoryAxis); | ||
|
Marek Rosa
|
r1829 | return d->m_categories.count(); | ||
|
Marek Rosa
|
r1701 | } | ||
| /*! | ||||
| Returns the type of the axis | ||||
| */ | ||||
|
Marek Rosa
|
r1816 | QAbstractAxis::AxisType QCategoryAxis::type() const | ||
|
Marek Rosa
|
r1701 | { | ||
|
Marek Rosa
|
r1818 | return QAbstractAxis::AxisTypeCategory; | ||
|
Marek Rosa
|
r1701 | } | ||
|
Titta Heikkala
|
r2780 | void QCategoryAxis::setLabelsPosition(QCategoryAxis::AxisLabelsPosition position) | ||
| { | ||||
| Q_D(QCategoryAxis); | ||||
| if (d->m_labelsPosition != position) { | ||||
| d->m_labelsPosition = position; | ||||
| emit labelsPositionChanged(position); | ||||
| } | ||||
| } | ||||
| QCategoryAxis::AxisLabelsPosition QCategoryAxis::labelsPosition() const | ||||
| { | ||||
| Q_D(const QCategoryAxis); | ||||
| return d->m_labelsPosition; | ||||
| } | ||||
|
Marek Rosa
|
r1701 | ////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////// | ||
|
Jani Honkonen
|
r2104 | QCategoryAxisPrivate::QCategoryAxisPrivate(QCategoryAxis *q) | ||
| : QValueAxisPrivate(q), | ||||
|
Titta Heikkala
|
r2780 | m_categoryMinimum(0), | ||
| m_labelsPosition(QCategoryAxis::AxisLabelsPositionCenter) | ||||
|
Marek Rosa
|
r1701 | { | ||
| } | ||||
|
Marek Rosa
|
r1816 | QCategoryAxisPrivate::~QCategoryAxisPrivate() | ||
|
Marek Rosa
|
r1701 | { | ||
| } | ||||
|
Marek Rosa
|
r1816 | int QCategoryAxisPrivate::ticksCount() const | ||
|
Marek Rosa
|
r1701 | { | ||
|
Marek Rosa
|
r1829 | return m_categories.count() + 1; | ||
|
Marek Rosa
|
r1701 | } | ||
|
Miikka Heikkinen
|
r2483 | void QCategoryAxisPrivate::initializeGraphics(QGraphicsItem *parent) | ||
|
Marek Rosa
|
r1701 | { | ||
|
Marek Rosa
|
r1816 | Q_Q(QCategoryAxis); | ||
|
Miikka Heikkinen
|
r2483 | ChartAxisElement *axis(0); | ||
| if (m_chart->chartType() == QChart::ChartTypeCartesian) { | ||||
| if (orientation() == Qt::Vertical) | ||||
| axis = new ChartCategoryAxisY(q,parent); | ||||
| else if (orientation() == Qt::Horizontal) | ||||
| axis = new ChartCategoryAxisX(q,parent); | ||||
| } | ||||
| if (m_chart->chartType() == QChart::ChartTypePolar) { | ||||
| if (orientation() == Qt::Vertical) | ||||
| axis = new PolarChartCategoryAxisRadial(q, parent); | ||||
| if (orientation() == Qt::Horizontal) | ||||
| axis = new PolarChartCategoryAxisAngular(q, parent); | ||||
| } | ||||
|
Michal Klocek
|
r2273 | |||
| m_item.reset(axis); | ||||
| QAbstractAxisPrivate::initializeGraphics(parent); | ||||
|
Marek Rosa
|
r1701 | } | ||
|
Marek Rosa
|
r1817 | #include "moc_qcategoryaxis.cpp" | ||
| #include "moc_qcategoryaxis_p.cpp" | ||||
|
Marek Rosa
|
r1701 | |||
|
Titta Heikkala
|
r2712 | QT_CHARTS_END_NAMESPACE | ||