HG_REPOSITORIES/LPP/INSTRUMENTATION/USERS/JEANDET/qtcharts Commit - r1969:ea1f56016da9

datetimeaxis example documented

Marek Rosa -

r1969:ea1f56016da9

parent child

Context file:

r1969:ea1f56016da9

Collapse all files

doc/src/examples-datetimeaxis.qdoc created 644 +37 0

@@ -0,0 +1,37
	1	/*!
	2	\example examples/datetimeaxis
	3	\title DateTimeAxis Example
	4	\subtitle
	5
	6	The example shows how to use QLineChart with QDateTimeAxis.
	7
	8	\image examples_datetimeaxis.png
	9
	10	To create line chart, QLineSeries instance is needed. Let's create one.
	11
	12	\snippet ../examples/datetimeaxis/main.cpp 1
	13
	14	On the charts we will present how the number of sun spots changes in time. The data (by Space Weather Prediction Center) is read from a text file.
	15	In the snippet below notice how QDateTime::toMSecsSinceEpoch method is used to convert the QDateTime object into a number that can be passed to QLineSeries append method.
	16
	17	\snippet ../examples/datetimeaxis/main.cpp 2
	18
	19	To present the data on the char we need QChart instance. We add the series to it, hide the legend, create the default axes and set the title of the chart.
	20
	21	\snippet ../examples/datetimeaxis/main.cpp 3
	22
	23	Becasue we use QLineSeries calling createDefaultAxes will create QValueAxis both as X and Y axis. To use QDateTimeAxis we need to set it manually to the chart.
	24	First the instance of QDateTimeAxis is created, then the number of ticks that are to be shown is set. The number of sun spots is provided as an average for the month therfore we don't need the axis labels to contain the information about the time and the day. This is achived by setting a custom label format.
	25	Please refer to QDateTime::toString() method documntation to learn about the avaiable format options.
	26
	27	\snippet ../examples/datetimeaxis/main.cpp 4
	28
	29	Then we create a QChartView object with QChart as a parameter. This way we don't need to create QGraphicsView scene ourselves. We also set the Antialiasing on to have the rendered lines look nicer.
	30
	31	\snippet ../examples/datetimeaxis/main.cpp 5
	32
	33	Chart is ready to be shown.
	34
	35	\snippet ../examples/datetimeaxis/main.cpp 6
	36
	37	*/

doc/src/examples.qdoc +1 0

             /*!
                 \page examples.html
                 \title Examples
                 \keyword Examples
                 \raw HTML
                     <table cellpadding="2" cellspacing="1" border="0" width="100%" class="indextable">
                     <tr>
                     <th class="titleheader" width="33%">
                     List of examples
                     </th>
                     </tr>
                     <tr>
                     <td valign="top">
                     <ul>
                         <li><a href="examples-areachart.html">Area chart</a></li>
                         <li><a href="examples-barchart.html">Bar chart</a></li>
                         <li><a href="examples-barmodelmapper.html">Bar chart from model</a></li>
                         <li><a href="examples-customchart.html">Custom chart</a></li>
+                        <li><a href="examples-datetimeaxis.html">DateTimeAxis example</a></li>
                         <li><a href="examples-donutbreakdown.html">Donut breakdown chart</a></li>
                         <li><a href="examples-donutchart.html">Donut chart</a></li>
                         <li><a href="examples-horizontalbarchart.html">Horizontal bar chart</a></li>
                         <li><a href="examples-horizontalpercentbarchart.html">Horizontal percent bar chart</a></li>
                         <li><a href="examples-horizontalstackedbarchart.html">Horizontal stacked bar chart</a></li>
                         <li><a href="examples-legend.html">Legend</a></li>
                         <li><a href="examples-lineandbar.html">Line and barchart</a></li>
                         <li><a href="examples-linechart.html">Line chart</a></li>
                         <li><a href="examples-modeldata.html">Model data</a></li>
                         <li><a href="examples-percentbarchart.html">Percent bar chart</a></li>
                         <li><a href="examples-piechart.html">Pie chart</a></li>
                         <li><a href="examples-piechartdrilldown.html">Pie chart drilldown</a></li>
                         <li><a href="examples-presenterchart.html">Presenter chart</a></li>
                         <li><a href="examples-scatterchart.html">Scatter chart</a></li>
                         <li><a href="examples-scatterinteractions.html">Scatter interactions</a></li>
                         <li><a href="examples-splinechart.html">Spline chart</a></li>
                         <li><a href="examples-stackedbarchart.html">Stacked bar chart</a></li>
                         <li><a href="examples-stackedbarchartdrilldown.html">Stacked bar chart drilldown</a></li>
                         <li><a href="examples-temperaturerecords.html">Temperature records</a></li>
                         <li><a href="examples-zoomlinechart.html">Zoom line</a></li>
                     </ul>
                     </td>
                     </tr>
                     </table>
                 \endraw
             */

examples/datetimeaxis/main.cpp +13 -8

             /****************************************************************************
             **
             ** 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 <QLineSeries>
             #include <QDateTime>
             #include <QDateTimeAxis>
             #include <QFile>
             #include <QTextStream>
             #include <QDebug>
             QTCOMMERCIALCHART_USE_NAMESPACE
             int main(int argc, char *argv[])
             {
                 QApplication a(argc, argv);
                 qsrand(QTime(0,0,0).secsTo(QTime::currentTime()));
                 //![1]
                 QLineSeries* series = new QLineSeries();
                 //![1]
                 //![2]
                 // data from http://www.swpc.noaa.gov/ftpdir/weekly/RecentIndices.txt
+                // http://www.swpc.noaa.gov/ftpdir/weekly/README
+                // http://www.weather.gov/disclaimer
                 QFile sunSpots(":sun");
                 if (!sunSpots.open(QIODevice::ReadOnly | QIODevice::Text)) {
                     return 1;
                 }
                 QTextStream stream(&sunSpots);
                 while (!stream.atEnd()) {
                     QString line = stream.readLine();
                     if (line.startsWith("#") || line.startsWith(":"))
                         continue;
                     QStringList values = line.split(" ", QString::SkipEmptyParts);
                     QDateTime momentInTime;
                     momentInTime.setDate(QDate(values[0].toInt(), values[1].toInt() , 15));
                     series->append(momentInTime.toMSecsSinceEpoch(), values[2].toDouble());
                 }
                 sunSpots.close();
                 //![2]
                 //![3]
                 QChart* chart = new QChart();
-                chart->legend()->hide();
                 chart->addSeries(series);
+                chart->legend()->hide();
                 chart->createDefaultAxes();
+                chart->setTitle("Sunspots count (by Space Weather Prediction Center)");
+                //![3]
+                //![4]
                 QDateTimeAxis *axisX = new QDateTimeAxis;
                 axisX->setTickCount(10);
                 axisX->setFormat("MMM yyyy");
                 chart->setAxisX(axisX, series);
-                chart->setTitle("Sunspots count (by Space Weather Prediction Center)");
-                //![3]
                 //![4]
+                //![5]
                 QChartView* chartView = new QChartView(chart);
                 chartView->setRenderHint(QPainter::Antialiasing);
-                //![4]
                 //![5]
+                //![6]
                 QMainWindow window;
                 window.setCentralWidget(chartView);
                 window.resize(800, 600);
                 window.show();
-                //![5]
+                //![6]
                 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