HG_REPOSITORIES/LPP/INSTRUMENTATION/USERS/JEANDET/qtcharts Commit - r1901:af3b9ac225d6

qml documentation for horizontal barcharts

sauimone -

r1901:af3b9ac225d6

parent child

Context file:

r1901:af3b9ac225d6

Collapse all files

doc/images/demos_qmlchart10.png created 644 binary 0 0

NO CONTENT: new file 100644, binary diff hidden

doc/images/demos_qmlchart11.png created 644 binary 0 0

NO CONTENT: new file 100644, binary diff hidden

doc/images/demos_qmlchart9.png created 644 binary 0 0

NO CONTENT: new file 100644, binary diff hidden

doc/src/qml.qdoc +3 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-horizontalbarseries.html">HorizontalBarSeries</a></li>
+                                <li><a href="qml-horizontalstackedbarseries.html">HorizontalStackedBarSeries</a></li>
+                                <li><a href="qml-horizontalpercentbarseries.html">HorizontalPercentBarSeries</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
             */

src/barchart/horizontal/bar/qhorizontalbarseries.cpp +5 -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$
             **
             ****************************************************************************/
             #include "qhorizontalbarseries.h"
             #include "qhorizontalbarseries_p.h"
             #include "horizontalbarchartitem_p.h"
             #include "horizontalbaranimation_p.h"
             #include "qbarcategoryaxis.h"
             #include "chartdataset_p.h"
             #include "charttheme_p.h"
             QTCOMMERCIALCHART_BEGIN_NAMESPACE
             /*!
                 \class QHorizontalBarSeries
                 \brief Series for creating horizontal bar chart
                 \mainclass
                 QHorizontalBarSeries represents a series of data shown as bars. The purpose of this class is to draw bars
                 as groups, where bars in same category are grouped next to each other. QHorizontalBarSeries groups the data
                 from sets to categories, which are defined by a QStringList.
                 See the \l {HorizontalBarChart Example} {horizontal bar chart example} to learn how to create a horizontal bar chart.
                 \image examples_horizontalbarchart.png
                 \sa QBarSet, QBarSeries, QPercentBarSeries, QAbstractBarSeries, QStackedBarSeries, QHorizontalStackedBarSeries, QHorizontalPercentBarSeries
             */
-            /*
+            /*!
-                // TODO:
+                \qmlclass HorizontalBarSeries QHorizontalBarSeries
-                \qmlclass Horizontal QHorizontalBarSeries
                 \inherits AbstractBarSeries
-                The following QML shows how to create a simple grouped bar chart:
+                The following QML shows how to create a simple horizontal bar chart:
-                \snippet ../demos/qmlchart/qml/qmlchart/View6.qml 1
+                \snippet ../demos/qmlchart/qml/qmlchart/View9.qml 1
                 \beginfloatleft
-                \image demos_qmlchart6.png
+                \image demos_qmlchart9.png
                 \endfloat
                 \clearfloat
             */
             /*!
                 Constructs empty QHorizontalBarSeries.
                 QHorizontalBarSeries is QObject which is a child of a \a parent.
             */
             QHorizontalBarSeries::QHorizontalBarSeries(QObject *parent) :
                 QAbstractBarSeries(*new QHorizontalBarSeriesPrivate(this), parent)
             {
             }
             /*!
                 Destructor
                 Removes series from chart.
             */
             QHorizontalBarSeries::~QHorizontalBarSeries()
             {
                 Q_D(QHorizontalBarSeries);
                 if(d->m_dataset) {
                     d->m_dataset->removeSeries(this);
                 }
             }
             /*!
                 Returns QChartSeries::SeriesTypeHorizontalBar.
             */
             QAbstractSeries::SeriesType QHorizontalBarSeries::type() const
             {
                 return QAbstractSeries::SeriesTypeHorizontalBar;
             }
             ///////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
             QHorizontalBarSeriesPrivate::QHorizontalBarSeriesPrivate(QHorizontalBarSeries *q) : QAbstractBarSeriesPrivate(q)
             {
             }
             void QHorizontalBarSeriesPrivate::scaleDomain(Domain& domain)
             {
                 qreal minX(domain.minX());
                 qreal minY(domain.minY());
                 qreal maxX(domain.maxX());
                 qreal maxY(domain.maxY());
                 qreal y = categoryCount();
                 minX = qMin(minX, min());
                 minY = qMin(minY, - (qreal)0.5);
                 maxX = qMax(maxX, max());
                 maxY = qMax(maxY, y - (qreal)0.5);
                 domain.setRange(minX,maxX,minY,maxY);
             }
             ChartElement* QHorizontalBarSeriesPrivate::createGraphics(ChartPresenter* presenter)
             {
                 Q_Q(QHorizontalBarSeries);
                 HorizontalBarChartItem* bar = new HorizontalBarChartItem(q,presenter);
                 if(presenter->animationOptions().testFlag(QChart::SeriesAnimations)) {
                     bar->setAnimation(new HorizontalBarAnimation(bar));
                 }
                 presenter->chartTheme()->decorate(q, presenter->dataSet()->seriesIndex(q));
                 return bar;
             }
             #include "moc_qhorizontalbarseries.cpp"
             QTCOMMERCIALCHART_END_NAMESPACE

src/barchart/horizontal/percent/qhorizontalpercentbarseries.cpp +11 0

             #include "qhorizontalpercentbarseries.h"
             #include "qhorizontalpercentbarseries_p.h"
             #include "horizontalpercentbarchartitem_p.h"
             #include "horizontalpercentbaranimation_p.h"
             #include "chartdataset_p.h"
             #include "charttheme_p.h"
             QTCOMMERCIALCHART_BEGIN_NAMESPACE
             /*!
                 \class QHorizontalPercentBarSeries
                 \brief Series for creating horizontal percent bar chart
                 \mainclass
                 QHorizontalPercentBarSeries represents a series of data shown as bars. The purpose of this class is to draw bars
                 as groups, where bars in same category are grouped next to each other. QHorizontalPercentBarSeries groups the data
                 from sets to categories, which are defined by a QStringList.
                 See the \l {HorizontalPercentBarChart Example} {horizontal percent bar chart example} to learn how to create a horizontal percent bar chart.
                 \image examples_horizontalpercentbarchart.png
                 \sa QBarSet, QBarSeries, QPercentBarSeries, QAbstractBarSeries, QStackedBarSeries, QHorizontalStackedBarSeries, QHorizontalBarSeries
             */
+            /*!
+                \qmlclass HorizontalPercentBarSeries QHorizontalPercentBarSeries
+                \inherits QAbstractBarSeries
+                The following QML shows how to create a simple horizontal percent bar chart:
+                \snippet ../demos/qmlchart/qml/qmlchart/View11.qml 1
+                \beginfloatleft
+                \image demos_qmlchart11.png
+                \endfloat
+                \clearfloat
+            */
             /*!
                 Constructs empty QHorizontalPercentBarSeries.
                 QHorizontalPercentBarSeries is QObject which is a child of a \a parent.
             */
             QHorizontalPercentBarSeries::QHorizontalPercentBarSeries(QObject *parent) :
                 QAbstractBarSeries(*new QHorizontalPercentBarSeriesPrivate(this), parent)
             {
             }
             /*!
                 Returns QChartSeries::SeriesTypeHorizontalPercentBar.
             */
             QAbstractSeries::SeriesType QHorizontalPercentBarSeries::type() const
             {
                 return QAbstractSeries::SeriesTypeHorizontalPercentBar;
             }
             /*!
                 Destructor
                 Removes series from chart.
             */
             QHorizontalPercentBarSeries::~QHorizontalPercentBarSeries()
             {
                 Q_D(QHorizontalPercentBarSeries);
                 if(d->m_dataset) {
                     d->m_dataset->removeSeries(this);
                 }
             }
             ///////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
             QHorizontalPercentBarSeriesPrivate::QHorizontalPercentBarSeriesPrivate(QHorizontalPercentBarSeries *q) : QAbstractBarSeriesPrivate(q)
             {
             }
             void QHorizontalPercentBarSeriesPrivate::scaleDomain(Domain& domain)
             {
                 qreal minX(domain.minX());
                 qreal minY(domain.minY());
                 qreal maxX(domain.maxX());
                 qreal maxY(domain.maxY());
                 qreal y = categoryCount();
                 minX = 0;
                 maxX = 100;
                 minY = qMin(minY, - (qreal)0.5);
                 maxY = qMax(maxY, y - (qreal)0.5);
                 domain.setRange(minX,maxX,minY,maxY);
             }
             ChartElement* QHorizontalPercentBarSeriesPrivate::createGraphics(ChartPresenter* presenter)
             {
                 Q_Q(QHorizontalPercentBarSeries);
                 HorizontalPercentBarChartItem* bar = new HorizontalPercentBarChartItem(q,presenter);
                 if(presenter->animationOptions().testFlag(QChart::SeriesAnimations)) {
                     bar->setAnimation(new HorizontalPercentBarAnimation(bar));
                 }
                 presenter->chartTheme()->decorate(q, presenter->dataSet()->seriesIndex(q));
                 return bar;
             }
             #include "moc_qhorizontalpercentbarseries.cpp"
             QTCOMMERCIALCHART_END_NAMESPACE

src/barchart/horizontal/stacked/qhorizontalstackedbarseries.cpp +11 0

             #include "qhorizontalstackedbarseries.h"
             #include "qhorizontalstackedbarseries_p.h"
             #include "horizontalstackedbarchartitem_p.h"
             #include "horizontalstackedbaranimation_p.h"
             #include "chartdataset_p.h"
             #include "charttheme_p.h"
             QTCOMMERCIALCHART_BEGIN_NAMESPACE
             /*!
                 \class QHorizontalStackedBarSeries
                 \brief Series for creating horizontal stacked bar chart
                 \mainclass
                 QHorizontalStackedBarSeries represents a series of data shown as bars. The purpose of this class is to draw bars
                 as groups, where bars in same category are grouped next to each other. QHorizontalStackedBarSeries groups the data
                 from sets to categories, which are defined by a QStringList.
                 See the \l {HorizontalStackedBarChart Example} {horizontal stacked bar chart example} to learn how to create a horizontal stacked bar chart.
                 \image examples_horizontalstackedbarchart.png
                 \sa QBarSet, QBarSeries, QPercentBarSeries, QAbstractBarSeries, QStackedBarSeries, QHorizontalPercentBarSeries, QHorizontalBarSeries
             */
+            /*!
+                \qmlclass HorizontalStackedBarSeries QHorizontalStackedBarSeries
+                \inherits QAbstractBarSeries
+                The following QML shows how to create a simple horizontal stacked bar chart:
+                \snippet ../demos/qmlchart/qml/qmlchart/View10.qml 1
+                \beginfloatleft
+                \image demos_qmlchart10.png
+                \endfloat
+                \clearfloat
+            */
             /*!
                 Constructs empty QHorizontalStackedBarSeries.
                 QHorizontalStackedBarSeries is QObject which is a child of a \a parent.
             */
             QHorizontalStackedBarSeries::QHorizontalStackedBarSeries(QObject *parent) :
                 QAbstractBarSeries(*new QHorizontalStackedBarSeriesPrivate(this), parent)
             {
             }
             /*!
                 Destructor
                 Removes series from chart.
             */
             QHorizontalStackedBarSeries::~QHorizontalStackedBarSeries()
             {
                 Q_D(QHorizontalStackedBarSeries);
                 if(d->m_dataset) {
                     d->m_dataset->removeSeries(this);
                 }
             }
             /*!
                 Returns QChartSeries::SeriesTypeHorizontalStackedBar.
             */
             QAbstractSeries::SeriesType QHorizontalStackedBarSeries::type() const
             {
                 return QAbstractSeries::SeriesTypeHorizontalStackedBar;
             }
             ///////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
             QHorizontalStackedBarSeriesPrivate::QHorizontalStackedBarSeriesPrivate(QHorizontalStackedBarSeries *q) : QAbstractBarSeriesPrivate(q)
             {
             }
             void QHorizontalStackedBarSeriesPrivate::scaleDomain(Domain& domain)
             {
                 qreal minX(domain.minX());
                 qreal minY(domain.minY());
                 qreal maxX(domain.maxX());
                 qreal maxY(domain.maxY());
                 qreal y = categoryCount();
                 minX = qMin(minX, bottom());
                 minY = qMin(minY, - (qreal)0.5);
                 maxX = qMax(maxX, top());
                 maxY = qMax(maxY, y - (qreal)0.5);
                 domain.setRange(minX,maxX,minY,maxY);
             }
             ChartElement* QHorizontalStackedBarSeriesPrivate::createGraphics(ChartPresenter* presenter)
             {
                 Q_Q(QHorizontalStackedBarSeries);
                 HorizontalStackedBarChartItem* bar = new HorizontalStackedBarChartItem(q,presenter);
                 if(presenter->animationOptions().testFlag(QChart::SeriesAnimations)) {
                     bar->setAnimation(new HorizontalStackedBarAnimation(bar));
                 }
                 presenter->chartTheme()->decorate(q, presenter->dataSet()->seriesIndex(q));
                 return bar;
             }
             #include "moc_qhorizontalstackedbarseries.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