HG_REPOSITORIES/LPP/INSTRUMENTATION/USERS/JEANDET/qtcharts Commit - r1870:102af68fd8c5

Added CategoryAxis and CategoryRange to QML API

Tero Ahola -

r1870:102af68fd8c5

parent child

Context file:

r1870:102af68fd8c5

Collapse all files

demos/qmlchart/qml/qmlchart/View4.qml +18 -7

             /****************************************************************************
             **
             ** 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$
             **
             ****************************************************************************/
             import QtQuick 1.0
             import QtCommercial.Chart 1.1
             Rectangle {
                 anchors.fill: parent
                 //![1]
                 ChartView {
                     title: "NHL All-Star Team Players"
                     anchors.fill: parent
-                    BarCategoriesAxis {
+                    CategoryAxis {
-                        id: catergoriesAxis
+                        id: categoriesAxis
-                        categories: ["2000", "2001", "2002", "2003", "2004", "2005", "2006", "2007", "2008",
+                        startValue: -0.5
-                            "2009", "2010", "2011" ]
+                        CategoryRange { endValue: 0.5; label: "2000" }
+                        CategoryRange { endValue: 1.5; label: "2001" }
+                        CategoryRange { endValue: 2.5; label: "2002" }
+                        CategoryRange { endValue: 3.5; label: "2003" }
+                        CategoryRange { endValue: 4.5; label: "2004" }
+                        CategoryRange { endValue: 5.5; label: "2005" }
+                        CategoryRange { endValue: 6.5; label: "2006" }
+                        CategoryRange { endValue: 7.5; label: "2007" }
+                        CategoryRange { endValue: 8.5; label: "2008" }
+                        CategoryRange { endValue: 9.5; label: "2009" }
+                        CategoryRange { endValue: 10.5; label: "2010" }
+                        CategoryRange { endValue: 11.5; label: "2011" }
                     }
                     AreaSeries {
                         name: "Russian"
-                        axisX: catergoriesAxis
+                        axisX: categoriesAxis
                         upperSeries: LineSeries {
                             XYPoint { x: 0; y: 1 }
                             XYPoint { x: 1; y: 1 }
                             XYPoint { x: 2; y: 1 }
                             XYPoint { x: 3; y: 1 }
                             XYPoint { x: 4; y: 1 }
                             XYPoint { x: 5; y: 0 }
                             XYPoint { x: 6; y: 1 }
                             XYPoint { x: 7; y: 1 }
                             XYPoint { x: 8; y: 4 }
                             XYPoint { x: 9; y: 3 }
                             XYPoint { x: 10; y: 2 }
                             XYPoint { x: 11; y: 1 }
                         }
                     }
                     // ...
                     //![1]
                     AreaSeries {
                         name: "Swedish"
-                        axisX: catergoriesAxis
+                        axisX: categoriesAxis
                         upperSeries: LineSeries {
                             XYPoint { x: 0; y: 1 }
                             XYPoint { x: 1; y: 1 }
                             XYPoint { x: 2; y: 3 }
                             XYPoint { x: 3; y: 3 }
                             XYPoint { x: 4; y: 2 }
                             XYPoint { x: 5; y: 0 }
                             XYPoint { x: 6; y: 2 }
                             XYPoint { x: 7; y: 1 }
                             XYPoint { x: 8; y: 2 }
                             XYPoint { x: 9; y: 1 }
                             XYPoint { x: 10; y: 3 }
                             XYPoint { x: 11; y: 3 }
                         }
                     }
                     AreaSeries {
                         name: "Finnish"
-                        axisX: catergoriesAxis
+                        axisX: categoriesAxis
                         upperSeries: LineSeries {
                             XYPoint { x: 0; y: 0 }
                             XYPoint { x: 1; y: 0 }
                             XYPoint { x: 2; y: 0 }
                             XYPoint { x: 3; y: 0 }
                             XYPoint { x: 4; y: 0 }
                             XYPoint { x: 5; y: 0 }
                             XYPoint { x: 6; y: 1 }
                             XYPoint { x: 7; y: 0 }
                             XYPoint { x: 8; y: 0 }
                             XYPoint { x: 9; y: 0 }
                             XYPoint { x: 10; y: 0 }
                             XYPoint { x: 11; y: 1 }
                         }
                         onClicked: {
                             color = "white";
                             borderColor = "blue";
                         }
                     }
                 }
             }

doc/src/qml.qdoc +2 0

             /*!
                 \page qml.html
                 \title QtCommercial Charts QML API
                 \keyword Charts QML API
                 QtCommercial Charts QML API is an intuitive and simple way to show charts in your QML
                 applications. The following QML shows you to create a simple pie chart:
                 \snippet ../examples/qmlpiechart/qml/qmlpiechart/main.qml 1
                 \snippet ../examples/qmlpiechart/qml/qmlpiechart/main.qml 2
                 \snippet ../examples/qmlpiechart/qml/qmlpiechart/main.qml 3
                 \raw HTML
                     <table cellpadding="2" cellspacing="1" border="0" width="95%" class="indextable">
                         <tr>
                             <th class="titleheader" width="25%"> ChartView and it's properties </th>
                         </tr>
                         <tr>
                             <td valign="top">
                                 <ul>
                                 <li><a href="qml-chartview.html">ChartView</a></li>
                                 <li><a href="qml-abstractaxis.html">AbstractAxis</a></li>
                                 <li><a href="qml-valueaxis.html">ValueAxis</a></li>
+                                <li><a href="qml-categoryaxis.html">CategoryAxis</a></li>
+                                <li><a href="qml-categoryrange.html">CategoryRange</a></li>
                                 <li><a href="qml-barcategoryaxis.html">BarCategoryAxis</a></li>
                                 <li><a href="qml-legend.html">Legend</a></li>
                                 <li><a href="qml-abstractseries.html">AbstractSeries</a></li>
                                 </ul>
                             </td>
                         </tr>
                     </table>
                     <table cellpadding="2" cellspacing="1" border="0" width="95%" class="indextable">
                         <tr>
                             <th class="titleheader" width="25%"> XY chart </th>
                         </tr>
                         <tr>
                             <td valign="top">
                                 <ul>
                                 <li><a href="qml-xyseries.html">XYSeries</a></li>
                                 <li><a href="qml-lineseries.html">LineSeries</a></li>
                                 <li><a href="qml-areaseries.html">AreaSeries</a></li>
                                 <li><a href="qml-scatterseries.html">ScatterSeries</a></li>
                                 <li><a href="qml-splineseries.html">SplineSeries</a></li>
                                 <li><a href="qml-xypoint.html">XYPoint</a></li>
                                 <li><a href="qml-hxymodelmapper.html">HXYModelMapper</a></li>
                                 <li><a href="qml-vxymodelmapper.html">VXYModelMapper</a></li>
                                 </ul>
                             </td>
                         </tr>
                     </table>
                     <table cellpadding="2" cellspacing="1" border="0" width="95%" class="indextable">
                         <tr>
                             <th class="titleheader" width="25%"> Pie chart </th>
                         <tr>
                             <td valign="top">
                                 <ul>
                                 <li><a href="qml-pieseries.html">PieSeries</a></li>
                                 <li><a href="qml-pieslice.html">PieSlice</a></li>
                                 <li><a href="qml-hpiemodelmapper.html">HPieModelMapper</a></li>
                                 <li><a href="qml-vpiemodelmapper.html">VPieModelMapper</a></li>
                                 </ul>
                             </td>
                         </tr>
                     </table>
                     <table cellpadding="2" cellspacing="1" border="0" width="95%" class="indextable">
                         <tr>
                             <th class="titleheader" width="25%"> Bar chart </th>
                         <tr>
                             <td valign="top">
                                 <ul>
                                 <li><a href="qml-barseries.html">BarSeries</a></li>
                                 <li><a href="qml-stackedbarseries.html">StackedBarSeries</a></li>
                                 <li><a href="qml-percentbarseries.html">PercentBarSeries</a></li>
                                 <li><a href="qml-barset.html">BarSet</a></li>
                                 <li><a href="qml-hbarmodelmapper.html">HBarModelMapper</a></li>
                                 <li><a href="qml-vbarmodelmapper.html">VBarModelMapper</a></li>
                                 </ul>
                             </td>
                         </tr>
                     </table>
                 \endraw
             */

plugins/declarative/declarative.pro +4 -2

             TARGET = qtcommercialchartqml
             QT += declarative
             !include( ../plugins.pri ) {
                 error( "Couldn't find the plugins.pri file!" )
             }
             INCLUDEPATH += $$CHART_BUILD_PRIVATE_HEADER_DIR
             contains(QT_MAJOR_VERSION, 5) {
                 # TODO: QtQuick2 not supported by the implementation currently
                 DEFINES += QTQUICK2
             }
             CONFIG(debug, debug|release) {
               mac: TARGET = $$join(TARGET,,,_debug)
               win32: TARGET = $$join(TARGET,,,d)
             }
             SOURCES += \
                 plugin.cpp \
                 declarativechart.cpp \
                 declarativexypoint.cpp \
                 declarativexyseries.cpp \
                 declarativelineseries.cpp \
                 declarativesplineseries.cpp \
                 declarativeareaseries.cpp \
                 declarativescatterseries.cpp \
                 declarativepieseries.cpp \
-                declarativebarseries.cpp
+                declarativebarseries.cpp \
+                declarativecategoryaxis.cpp
             HEADERS += \
                 declarativechart.h \
                 declarativexypoint.h \
                 declarativexyseries.h \
                 declarativelineseries.h \
                 declarativesplineseries.h \
                 declarativeareaseries.h \
                 declarativescatterseries.h \
                 declarativepieseries.h \
-                declarativebarseries.h
+                declarativebarseries.h \
+                declarativecategoryaxis.h
             TARGETPATH = QtCommercial/Chart
             target.path = $$[QT_INSTALL_IMPORTS]/$$TARGETPATH
             qmldir.files += $$PWD/qmldir
             qmldir.path +=  $$[QT_INSTALL_IMPORTS]/$$TARGETPATH
             INSTALLS += target qmldir
             FILE = $$PWD/qmldir
             win32:{FILE = $$replace(FILE, "/","\\")}
             QMAKE_POST_LINK += $$QMAKE_COPY $$FILE $$CHART_BUILD_PLUGIN_DIR

plugins/declarative/plugin.cpp +5 0

             /****************************************************************************
             **
             ** 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 <QtDeclarative/qdeclarativeextensionplugin.h>
             #include <QtDeclarative/qdeclarative.h>
             #include "qchart.h"
             #include "qabstractaxis.h"
             #include "qvalueaxis.h"
+            #include "qdatetimeaxis.h"
+            #include "declarativecategoryaxis.h"
             #include "qbarcategoryaxis.h"
             #include "declarativechart.h"
             #include "declarativexypoint.h"
             #include "declarativelineseries.h"
             #include "declarativesplineseries.h"
             #include "declarativeareaseries.h"
             #include "declarativescatterseries.h"
             #include "declarativebarseries.h"
             #include "declarativepieseries.h"
             #include "qvxymodelmapper.h"
             #include "qhxymodelmapper.h"
             #include "qhpiemodelmapper.h"
             #include "qvpiemodelmapper.h"
             #include "qhbarmodelmapper.h"
             #include "qvbarmodelmapper.h"
             #include <QAbstractItemModel>
             QTCOMMERCIALCHART_BEGIN_NAMESPACE
             class ChartQmlPlugin : public QDeclarativeExtensionPlugin
             {
                 Q_OBJECT
             public:
                 virtual void registerTypes(const char *uri)
                 {
                     Q_ASSERT(QLatin1String(uri) == QLatin1String("QtCommercial.Chart"));
                     // QtCommercial.Chart 1.0
                     qmlRegisterType<DeclarativeChart>(uri, 1, 0, "ChartView");
                     qmlRegisterType<DeclarativeXYPoint>(uri, 1, 0, "XYPoint");
                     qmlRegisterType<DeclarativeScatterSeries>(uri, 1, 0, "ScatterSeries");
                     qmlRegisterType<DeclarativeLineSeries>(uri, 1, 0, "LineSeries");
                     qmlRegisterType<DeclarativeSplineSeries>(uri, 1, 0, "SplineSeries");
                     qmlRegisterType<DeclarativeAreaSeries>(uri, 1, 0, "AreaSeries");
                     qmlRegisterType<DeclarativeBarSeries>(uri, 1, 0, "BarSeries");
                     qmlRegisterType<DeclarativeStackedBarSeries>(uri, 1, 0, "StackedBarSeries");
                     qmlRegisterType<DeclarativePercentBarSeries>(uri, 1, 0, "PercentBarSeries");
                     qmlRegisterType<DeclarativePieSeries>(uri, 1, 0, "PieSeries");
                     qmlRegisterType<QPieSlice>(uri, 1, 0, "PieSlice");
                     qmlRegisterType<DeclarativeBarSet>(uri, 1, 0, "BarSet");
                     qmlRegisterType<QHXYModelMapper>(uri, 1, 0, "HXYModelMapper");
                     qmlRegisterType<QVXYModelMapper>(uri, 1, 0, "VXYModelMapper");
                     qmlRegisterType<QHPieModelMapper>(uri, 1, 0, "HPieModelMapper");
                     qmlRegisterType<QVPieModelMapper>(uri, 1, 0, "VPieModelMapper");
                     qmlRegisterType<QHBarModelMapper>(uri, 1, 0, "HBarModelMapper");
                     qmlRegisterType<QVBarModelMapper>(uri, 1, 0, "VBarModelMapper");
                     qmlRegisterType<QValueAxis>(uri, 1, 0, "ValuesAxis");
                     qmlRegisterType<QBarCategoryAxis>(uri, 1, 0, "BarCategoriesAxis");
                     qmlRegisterUncreatableType<QLegend>(uri, 1, 0, "Legend",
                                                       QLatin1String("Trying to create uncreatable: Legend."));
                     qmlRegisterUncreatableType<QXYSeries>(uri, 1, 0, "XYSeries",
                                                       QLatin1String("Trying to create uncreatable: XYSeries."));
                     qmlRegisterUncreatableType<QAbstractItemModel>(uri, 1, 0, "AbstractItemModel",
                                                       QLatin1String("Trying to create uncreatable: AbstractItemModel."));
                     qmlRegisterUncreatableType<QXYModelMapper>(uri, 1, 0, "XYModelMapper",
                                                       QLatin1String("Trying to create uncreatable: XYModelMapper."));
                     qmlRegisterUncreatableType<QPieModelMapper>(uri, 1, 0, "PieModelMapper",
                                                       QLatin1String("Trying to create uncreatable: PieModelMapper."));
                     qmlRegisterUncreatableType<QBarModelMapper>(uri, 1, 0, "BarModelMapper",
                                                       QLatin1String("Trying to create uncreatable: BarModelMapper."));
                     qmlRegisterUncreatableType<QAbstractSeries>(uri, 1, 0, "AbstractSeries",
                                                       QLatin1String("Trying to create uncreatable: AbstractSeries."));
                     qmlRegisterUncreatableType<QAbstractBarSeries>(uri, 1, 0, "AbstractBarSeries",
                                                          QLatin1String("Trying to create uncreatable: AbstractBarSeries."));
                     qmlRegisterUncreatableType<QAbstractAxis>(uri, 1, 0, "AbstractAxis",
                                                       QLatin1String("Trying to create uncreatable: AbstractAxis. Use specific types of axis instead."));
                     // QtCommercial.Chart 1.1
                     qmlRegisterType<DeclarativeChart>(uri, 1, 1, "ChartView");
                     qmlRegisterType<DeclarativeXYPoint>(uri, 1, 1, "XYPoint");
                     qmlRegisterType<DeclarativeScatterSeries, 1>(uri, 1, 1, "ScatterSeries");
                     qmlRegisterType<DeclarativeLineSeries, 1>(uri, 1, 1, "LineSeries");
                     qmlRegisterType<DeclarativeSplineSeries, 1>(uri, 1, 1, "SplineSeries");
                     qmlRegisterType<DeclarativeAreaSeries, 1>(uri, 1, 1, "AreaSeries");
                     qmlRegisterType<DeclarativeBarSeries, 1>(uri, 1, 1, "BarSeries");
                     qmlRegisterType<DeclarativeStackedBarSeries, 1>(uri, 1, 1, "StackedBarSeries");
                     qmlRegisterType<DeclarativePercentBarSeries, 1>(uri, 1, 1, "PercentBarSeries");
                     qmlRegisterType<DeclarativeHorizontalBarSeries, 1>(uri, 1, 1, "HorizontalBarSeries");
                     qmlRegisterType<DeclarativeHorizontalStackedBarSeries, 1>(uri, 1, 1, "HorizontalStackedBarSeries");
                     qmlRegisterType<DeclarativeHorizontalPercentBarSeries, 1>(uri, 1, 1, "HorizontalPercentBarSeries");
                     qmlRegisterType<DeclarativePieSeries>(uri, 1, 1, "PieSeries");
                     qmlRegisterType<QPieSlice>(uri, 1, 1, "PieSlice");
                     qmlRegisterType<DeclarativeBarSet>(uri, 1, 1, "BarSet");
                     qmlRegisterType<QHXYModelMapper>(uri, 1, 1, "HXYModelMapper");
                     qmlRegisterType<QVXYModelMapper>(uri, 1, 1, "VXYModelMapper");
                     qmlRegisterType<QHPieModelMapper>(uri, 1, 1, "HPieModelMapper");
                     qmlRegisterType<QVPieModelMapper>(uri, 1, 1, "VPieModelMapper");
                     qmlRegisterType<QHBarModelMapper>(uri, 1, 1, "HBarModelMapper");
                     qmlRegisterType<QVBarModelMapper>(uri, 1, 1, "VBarModelMapper");
                     qmlRegisterType<QValueAxis>(uri, 1, 1, "ValueAxis");
+                    qmlRegisterType<QDateTimeAxis>(uri, 1, 1, "DateTimeAxis");
+                    qmlRegisterType<DeclarativeCategoryAxis>(uri, 1, 1, "CategoryAxis");
+                    qmlRegisterType<DeclarativeCategoryRange>(uri, 1, 1, "CategoryRange");
                     qmlRegisterType<QBarCategoryAxis>(uri, 1, 1, "BarCategoryAxis");
                     qmlRegisterUncreatableType<QLegend>(uri, 1, 1, "Legend",
                                                       QLatin1String("Trying to create uncreatable: Legend."));
                     qmlRegisterUncreatableType<QXYSeries>(uri, 1, 1, "XYSeries",
                                                       QLatin1String("Trying to create uncreatable: XYSeries."));
                     qmlRegisterUncreatableType<QAbstractItemModel>(uri, 1, 1, "AbstractItemModel",
                                                       QLatin1String("Trying to create uncreatable: AbstractItemModel."));
                     qmlRegisterUncreatableType<QXYModelMapper>(uri, 1, 1, "XYModelMapper",
                                                       QLatin1String("Trying to create uncreatable: XYModelMapper."));
                     qmlRegisterUncreatableType<QPieModelMapper>(uri, 1, 1, "PieModelMapper",
                                                       QLatin1String("Trying to create uncreatable: PieModelMapper."));
                     qmlRegisterUncreatableType<QBarModelMapper>(uri, 1, 1, "BarModelMapper",
                                                       QLatin1String("Trying to create uncreatable: BarModelMapper."));
                     qmlRegisterUncreatableType<QAbstractSeries>(uri, 1, 1, "AbstractSeries",
                                                       QLatin1String("Trying to create uncreatable: AbstractSeries."));
                     qmlRegisterUncreatableType<QAbstractBarSeries>(uri, 1, 1, "AbstractBarSeries",
                                                          QLatin1String("Trying to create uncreatable: AbstractBarSeries."));
                     qmlRegisterUncreatableType<QAbstractAxis>(uri, 1, 1, "AbstractAxis",
                                                       QLatin1String("Trying to create uncreatable: AbstractAxis. Use specific types of axis instead."));
                 }
             };
             #include "plugin.moc"
             QTCOMMERCIALCHART_END_NAMESPACE
             QTCOMMERCIALCHART_USE_NAMESPACE
             Q_EXPORT_PLUGIN2(qtcommercialchartqml, QT_PREPEND_NAMESPACE(ChartQmlPlugin))

src/axis/categoryaxis/qcategoryaxis.cpp +27 -3

             /****************************************************************************
             **
             ** 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 "qcategoryaxis.h"
             #include "qcategoryaxis_p.h"
             #include "chartcategoryaxisx_p.h"
             #include "chartcategoryaxisy_p.h"
             #include <qmath.h>
             #include <QDebug>
             QTCOMMERCIALCHART_BEGIN_NAMESPACE
             /*!
                 \class QCategoryAxis
                 \brief The QCategoryAxis class allows putting a named ranges on the axis.
                 \mainclass
                 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.
             */
             /*!
                 \qmlclass CategoryAxis QCategoryAxis
                 \inherits AbstractAxis
-                \brief The QCategoryAxis class allows putting a named ranges on the axis.
+                \brief CategoryAxis allows putting a named ranges on the axis.
+                For example:
+                \code
+                    CategoryAxis {
+                        startValue: 0.0
+                        CategoryRange { endValue: 1.0; label: "min (0-1)" }
+                        CategoryRange { endValue: 3.0; label: "standard (1-3)" }
+                        CategoryRange { endValue: 4.0; label: "high (3-4)" }
+                    }
+                \endcode
             */
             /*!
               \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.
             */
             /*!
                 Constructs an axis object which is a child of \a parent.
             */
             QCategoryAxis::QCategoryAxis(QObject *parent):
                 QValueAxis(*new QCategoryAxisPrivate(this),parent)
             {
             }
             /*!
                 Destroys the object
             */
             QCategoryAxis::~QCategoryAxis()
             {
                 //    Q_D(QValueAxis);
                 //    if(d->m_dataset) {
                 //        d->m_dataset->removeAxis(this);
                 //    }
             }
             /*!
                 \internal
             */
             QCategoryAxis::QCategoryAxis(QCategoryAxisPrivate &d,QObject *parent):QValueAxis(d,parent)
             {
             }
             /*!
+                \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.
+            */
+            /*!
                 Appends new category to the axis with an \a categoryLabel.
                 Category label has to be unique.
                 Parameter \a categoryEndValue 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.
             */
             void QCategoryAxis::append(const QString& categoryLabel, qreal categoryEndValue)
             {
                 Q_D(QCategoryAxis);
                 if (!d->m_categories.contains(categoryLabel))
                 {
                     if(d->m_categories.isEmpty()){
                         Range range(d->m_categoryMinimum, categoryEndValue);
                         d->m_categoriesMap.insert(categoryLabel, range);
                         d->m_categories.append(categoryLabel);
                     }else if (categoryEndValue > endValue(d->m_categories.last())){
                         Range previousRange = d->m_categoriesMap.value(d->m_categories.last());
                         d->m_categoriesMap.insert(categoryLabel, Range(previousRange.second, categoryEndValue));
                         d->m_categories.append(categoryLabel);
                     }
                 }
             }
             /*!
                 Sets \a min to be the low end limit of the first category on the axis.
                 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.
             */
             void QCategoryAxis::setStartValue(qreal min)
             {
                 Q_D(QCategoryAxis);
                 if(d->m_categories.isEmpty()){
                     d->m_categoryMinimum = min;
                 }else{
                     Range range = d->m_categoriesMap.value(d->m_categories.first());
                     if (min < range.second)
                         d->m_categoriesMap.insert(d->m_categories.first(), Range(min, range.second));
                 }
             }
             /*!
                 Returns the low end limit of the category specified by an \a categoryLabel
             */
             qreal QCategoryAxis::startValue(const QString& categoryLabel) const
             {
                 Q_D(const QCategoryAxis);
                 if (categoryLabel == QString())
                     return d->m_categoryMinimum;
                 else
                     return d->m_categoriesMap.value(categoryLabel).first;
             }
             /*!
                 Returns the high end limit of the interval specified by an \a categoryLabel
             */
             qreal QCategoryAxis::endValue(const QString& categoryLabel) const
             {
                 Q_D(const QCategoryAxis);
                 return d->m_categoriesMap.value(categoryLabel).second;
             }
             /*!
+                \qmlmethod CategoryAxis::remove(string label)
+                Removes a category specified by the \a label from the axis
+            */
+            /*!
                 Removes an interval specified by the \a categoryLabel from the axis
             */
             void QCategoryAxis::remove(const QString &categoryLabel)
             {
                 Q_D(QCategoryAxis);
                 int labelIndex = d->m_categories.indexOf(categoryLabel);
                 // check if such label exists
                 if (labelIndex != -1) {
                     d->m_categories.removeAt(labelIndex);
                     d->m_categoriesMap.remove(categoryLabel);
                     // the range of the interval that follows (if exists) needs to be updated
                     if (labelIndex < d->m_categories.count()) {
                         QString label = d->m_categories.at(labelIndex);
                         Range range = d->m_categoriesMap.value(label);
                         // set the range
                         if (labelIndex == 0) {
                             range.first = d->m_categoryMinimum;
                             d->m_categoriesMap.insert(label, range);
                         } else {
                             range.first = d->m_categoriesMap.value(d->m_categories.at(labelIndex - 1)).second;
                             d->m_categoriesMap.insert(label, range);
                         }
                     }
                     d->emitUpdated();
                 }
             }
             /*!
+              \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.
+            */
+            /*!
               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.
              */
             void QCategoryAxis::replaceLabel(const QString& oldLabel, const QString& newLabel)
             {
                 Q_D(QCategoryAxis);
                 int labelIndex = d->m_categories.indexOf(oldLabel);
                 // check if such label exists
                 if (labelIndex != -1) {
                     d->m_categories.replace(labelIndex, newLabel);
                     Range range = d->m_categoriesMap.value(oldLabel);
                     d->m_categoriesMap.remove(oldLabel);
                     d->m_categoriesMap.insert(newLabel, range);
                     d->emitUpdated();
                 }
             }
             /*!
               Returns the list of the intervals labels
              */
             QStringList QCategoryAxis::categoriesLabels()
             {
                 Q_D(QCategoryAxis);
                 return d->m_categories;
             }
             /*!
               Returns number of intervals.
              */
             int QCategoryAxis::count() const
             {
                 Q_D(const QCategoryAxis);
                 return d->m_categories.count();
             }
             /*!
               Returns the type of the axis
             */
             QAbstractAxis::AxisType QCategoryAxis::type() const
             {
                 return QAbstractAxis::AxisTypeCategory;
             }
             //////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
             QCategoryAxisPrivate::QCategoryAxisPrivate(QCategoryAxis* q):
                 QValueAxisPrivate(q),
                 m_categoryMinimum(0)
             {
             }
             QCategoryAxisPrivate::~QCategoryAxisPrivate()
             {
             }
             int QCategoryAxisPrivate::ticksCount() const
             {
                 return m_categories.count() + 1;
             }
             void QCategoryAxisPrivate::handleAxisRangeChanged(qreal min, qreal max,int count)
             {
                 Q_UNUSED(count);
                 Q_UNUSED(min);
                 Q_UNUSED(max);
                 //m_min = min;
                 //m_max = max;
             }
             ChartAxis* QCategoryAxisPrivate::createGraphics(ChartPresenter* presenter)
             {
                 Q_Q(QCategoryAxis);
                 if(m_orientation == Qt::Vertical){
                     return new ChartCategoryAxisY(q,presenter);
                 }else{
                     return new ChartCategoryAxisX(q,presenter);
                 }
             }
             #include "moc_qcategoryaxis.cpp"
             #include "moc_qcategoryaxis_p.cpp"
             QTCOMMERCIALCHART_END_NAMESPACE

General Comments 0

Write
Preview

You need to be logged in to leave comments. Login now

No TODOs yet

	Site-wide shortcuts
/	Use quick search box
g h	Goto home page
g g	Goto my private gists page
g G	Goto my public gists page
g 0-9	Goto bookmarked items from 0-9
n r	New repository page
n g	New gist page

	Repositories
g s	Goto summary page
g c	Goto changelog page
g f	Goto files page
g F	Goto files page with file search activated
g p	Goto pull requests page
g o	Goto repository settings
g O	Goto repository access permissions settings
t s	Toggle sidebar on some pages