HG_REPOSITORIES/LPP/INSTRUMENTATION/USERS/JEANDET/qtcharts Commit - r1407:41924dd7d514

barchart documentation update

sauimone -

r1407:41924dd7d514

parent child

Context file:

r1407:41924dd7d514

Collapse all files

doc/src/examples-barchart.qdoc +3 -1

             /*!
                 \example examples/barchart
                 \title BarChart Example
                 \subtitle
                 The example shows how to create simple bar chart. Barchart shows the data in sets as separate bars, which are drawn at the x-axis to the position defined by data.
                 \image examples_barchart.png
                 Data that barchart visualizes, is defined by QBarSet instances. Here we create some sets and append data
-                we want to visualize to them. Note that first and third QPointF in each set have smaller intervals at their x coordinates. This will be reflected in the chart.
+                we want to visualize to them. Note that x positions are not in even intervals and this will be reflected in the chart.
+            	If x positions aren't defined, then the index of value is assumed to be x position.
                 \snippet ../examples/barchart/main.cpp 1
                 To combine the sets to a chart, we need to create QBarSeries instance. Then we append our barsets to the series.
                 \snippet ../examples/barchart/main.cpp 2
                 Next we create a chart and add the series to it.
+            	We also set the title for chart
                 \snippet ../examples/barchart/main.cpp 3
                 We want to have the legend displayed at the bottom of the chart. Also we turn on the nice numbers algorithm on for y-axis.
                 \snippet ../examples/barchart/main.cpp 4
                 Finally we add the chart onto a view.
                 \snippet ../examples/barchart/main.cpp 5
                 And it is ready to be shown in a window.
                 \snippet ../examples/percentbarchart/main.cpp 6
             */

doc/src/examples-groupedbarchart.qdoc +7 -8

             /*!
                 \example examples/groupedbarchart
                 \title GroupedBarChart Example
                 \subtitle
                 The example shows how to create simple bar chart. GroupedBarChart shows the data in sets as separate bars, which are grouped in categories.
                 \image examples_groupedbarchart.png
-                First we define categories.
+                Data that groupedbarchart visualizes, is defined by QBarSet instances. Here we create the sets and append data
+                to them.
                 \snippet ../examples/groupedbarchart/main.cpp 1
-                Data that groupedbarchart visualizes, is defined by QBarSet instances. Here we create some sets and append data
+                We create the series and append the sets to it. The grouped barseries groups the data from sets to categories.
-                we want to visualize to them.
+            	First value of each set are gropuped together at first category second value to second category and so on.
                 \snippet ../examples/groupedbarchart/main.cpp 2
-                To combine the sets and categories to a chart, we need to create QBarSeries instance. When creating
+                Then we create a chart and add the series to it.
-            	the QBarSeries, the categories must be known. Sets can be added later. For example purposes the sets
-            	are added to series here.
                 \snippet ../examples/groupedbarchart/main.cpp 3
-                Then we create a chart and add the series to it.
+            	We define the categories here and add them to the x-axis.
                 \snippet ../examples/groupedbarchart/main.cpp 4
                 And we also want to show the legend, so that the data is easier to read.
                 \snippet ../examples/groupedbarchart/main.cpp 5
                 Finally we add the chart onto a view.
                 \snippet ../examples/groupedbarchart/main.cpp 6
                 And it is ready to be shown in a window.
                 \snippet ../examples/groupedbarchart/main.cpp 7
             */

examples/barchart/main.cpp +1 -1

             /****************************************************************************
             **
             ** 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 <QApplication>
             #include <QMainWindow>
             #include <QChartView>
             #include <QBarSeries>
             #include <QBarSet>
             #include <QLegend>
             QTCOMMERCIALCHART_USE_NAMESPACE
             int main(int argc, char *argv[])
             {
                 QApplication a(argc, argv);
             //![1]
                 QBarSet *set0 = new QBarSet("Jane");
                 QBarSet *set1 = new QBarSet("John");
                 QBarSet *set2 = new QBarSet("Axel");
                 QBarSet *set3 = new QBarSet("Mary");
                 *set0 << QPointF(0.0, 1) << QPointF(1.0, 2) << QPointF(2.4, 3) << QPointF(3.0, 4) << QPointF(4.0, 5) << QPointF(5.0, 6);
                 *set1 << QPointF(0.1, 2) << QPointF(1.2, 3) << QPointF(2.45, 4) << QPointF(3.2, 5) << QPointF(4.2, 6) << QPointF(5.2, 7);
                 *set2 << QPointF(0.2, 3) << QPointF(1.4, 4) << QPointF(2.50, 5) << QPointF(3.4, 6) << QPointF(4.4, 7) << QPointF(5.4, 8);
                 *set3 << QPointF(0.3, 4) << QPointF(1.6, 5) << QPointF(2.55, 6) << QPointF(3.6, 7) << QPointF(4.6, 8) << QPointF(5.6, 9);
             //![1]
             //![2]
                 QBarSeries* series = new QBarSeries();
                 series->setBarMargin(0.8);
                 series->append(set0);
                 series->append(set1);
                 series->append(set2);
                 series->append(set3);
             //![2]
             //![3]
                 QChart* chart = new QChart();
                 chart->addSeries(series);
-                chart->setTitle("Simple barchart example");
+                chart->setTitle("Barchart example");
             //![3]
             //![4]
                 chart->legend()->setVisible(true);
                 chart->legend()->setAlignment(Qt::AlignBottom);
                 chart->axisY()->setNiceNumbersEnabled(true);
             //![4]
             //![5]
                 QChartView* chartView = new QChartView(chart);
                 chartView->setRenderHint(QPainter::Antialiasing);
             //![5]
             //![6]
                 QMainWindow window;
                 window.setCentralWidget(chartView);
                 window.resize(400, 300);
                 window.show();
             //![6]
                 return a.exec();
             }

examples/groupedbarchart/main.cpp 0 -1

             /****************************************************************************
             **
             ** 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 <QApplication>
             #include <QMainWindow>
             #include <QChartView>
             #include <QGroupedBarSeries>
             #include <QBarSet>
             #include <QLegend>
             QTCOMMERCIALCHART_USE_NAMESPACE
             int main(int argc, char *argv[])
             {
                 QApplication a(argc, argv);
             //![1]
                 QBarSet *set0 = new QBarSet("Jane");
                 QBarSet *set1 = new QBarSet("John");
                 QBarSet *set2 = new QBarSet("Axel");
                 QBarSet *set3 = new QBarSet("Mary");
                 QBarSet *set4 = new QBarSet("Samantha");
                 *set0 << 1 << 2 << 3 << 4 << 5 << 6;
                 *set1 << 5 << 0 << 0 << 4 << 0 << 7;
                 *set2 << 3 << 5 << 8 << 13 << 8 << 5;
                 *set3 << 5 << 6 << 7 << 3 << 4 << 5;
                 *set4 << 9 << 7 << 5 << 3 << 1 << 2;
             //![1]
             //![2]
                 QGroupedBarSeries* series = new QGroupedBarSeries();
-            //    series->setCategories(categories);
                 series->append(set0);
                 series->append(set1);
                 series->append(set2);
                 series->append(set3);
                 series->append(set4);
             //![2]
             //![3]
                 QChart* chart = new QChart();
                 chart->addSeries(series);
                 chart->setTitle("Simple grouped barchart example");
             //![3]
             //![4]
                 QStringList categories;
                 categories << "Jan" << "Feb" << "Mar" << "Apr" << "May" << "Jun";
                 chart->axisX()->categories()->insert(categories);
             //![4]
             //![5]
                 chart->legend()->setVisible(true);
                 chart->legend()->setAlignment(Qt::AlignBottom);
                 chart->axisY()->setNiceNumbersEnabled(true);
             //![5]
             //![6]
                 QChartView* chartView = new QChartView(chart);
                 chartView->setRenderHint(QPainter::Antialiasing);
             //![6]
             //![7]
                 QMainWindow window;
                 window.setCentralWidget(chartView);
                 window.resize(400, 300);
                 window.show();
             //![7]
                 return a.exec();
             }

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