HG_REPOSITORIES/LPP/INSTRUMENTATION/USERS/JEANDET/qtcharts Commit - r1714:d63ddbb6caa3

Documented the donutdrilldown chart example

Marek Rosa -

r1714:d63ddbb6caa3

parent child

Context file:

r1714:d63ddbb6caa3

Collapse all files

doc/src/examples-donutdrilldown.qdoc created 644 +52 0

@@ -0,0 +1,52
	1	/*!
	2	\example examples/donutdrilldown
	3	\title Donut chart drilldown example
	4	\subtitle
	5
	6	This example shows how to use create a donut drilldown chart using QPieSeries API.
	7
	8	Let's start by creating a QChartView instance and enabling the Antialiasing on it. Last line enables the animations of the chart.
	9
	10	\snippet ../examples/donutdrilldown/widget.cpp 1
	11
	12	PieSeries is used to present the general data.
	13
	14	\snippet ../examples/donutdrilldown/widget.cpp 2
	15
	16	Following block of code creates the slices for the mainData QPieSeries.
	17	Then for every created slice a new series is created that stores the detailed data.
	18	The details series is set to be a donut. Its size is adjusted so that it wraps around the mainData pie.
	19	Next two signals from the mainData pie's slices are connected. This is used to keep the mainData slices agligned with their respective details series.
	20
	21	\snippet ../examples/donutdrilldown/widget.cpp 3
	22
	23	Set the labels of the mainData to enabled and their postion to Outside.
	24	Then add the mainData and detailedData series to the chart.
	25
	26	\snippet ../examples/donutdrilldown/widget.cpp 4
	27
	28	Finally the widget is placed in a layout used by the application.
	29
	30	\snippet ../examples/donutdrilldown/widget.cpp 5
	31
	32	To show that the detailed data stays aligned with the main data every 2.5 sec. one of the slices is modified.
	33	It should be noted that int this example the mainData slices should not be modified directly as the change
	34	cannot be applied to the detailed slices without the extra knowledge on how the split looks like.
	35
	36	\snippet ../examples/donutdrilldown/widget.cpp 6
	37
	38	When the mainData slice layout is changed the detailed data layout has to be modified accordingly.
	39	This is achived by setting the start and end angle of the detailed series.
	40
	41	\snippet ../examples/donutdrilldown/widget.cpp 7
	42
	43	Highlight slot selects a random slice for the modification.
	44	The slice is set to exploded to notify the user that its going to be changed.
	45	The actual data modification is delayed by 1 sec to give a user a chance to focus on the slice.
	46
	47	Then the slice is modified. Respective mainData slice is modified as well to contain as the value the sum of the detailed series slices values.
	48	Finally the slice exploded state is set to false.
	49
	50	\snippet ../examples/donutdrilldown/widget.cpp 8
	51
	52	*/

examples/donutdrilldown/widget.cpp +30 -13

                 setMinimumSize(800, 600);
                 qsrand(QTime(0,0,0).secsTo(QTime::currentTime()));
+                //! [1]
                 QChartView *chartView = new QChartView;
                 chartView->setRenderHint(QPainter::Antialiasing);
                 chartView->chart()->setAnimationOptions(QChart::AllAnimations);
+                //! [1]
+                //! [2]
                 mainData = new QPieSeries;
                 mainData->setPieSize(0.6);
+                //! [2]
+                //! [3]
                 for (int j = 0; j < 4; j++) {
                     // create new slice for the mainData
                     QPieSlice *slice = new QPieSlice;
                     slice->setValue(donut->sum());
                     slice->setLabel(QString("%1").arg(donut->sum()));
                 }
+                //! [3]
+                //! [4]
                 mainData->setLabelsVisible();
                 mainData->setLabelsPosition(QPieSlice::LabelInside);
                 chartView->chart()->addSeries(mainData);
                 for (int i = 0; i < detailedData.count(); i++)
                     chartView->chart()->addSeries(detailedData.at(i));
+                //! [4]
+                //! [5]
                 // create main layout
                 QGridLayout* mainLayout = new QGridLayout;
                 mainLayout->addWidget(chartView, 1, 1);
                 setLayout(mainLayout);
+                //! [5]
+                //! [6]
                 // modify the value of one detailed slice every 2.5 sec
                 QTimer *updateTimer = new QTimer(this);
                 connect(updateTimer, SIGNAL(timeout()), this, SLOT(highlight()));
                 updateTimer->start(2500);
+                //! [6]
             }
             Widget::~Widget()
             }
+                //! [7]
             void Widget::updatedStartAngle()
             {
                 // when the mainData slice has been updated the detailed data QPieSeries object as well
                 QPieSeries *detailsDonut = detailedData.at(slice->series()->slices().indexOf(slice));
                 detailsDonut->setPieEndAngle(slice->startAngle() + slice->angleSpan());
             }
+                //! [7]
+                //! [8]
+            void Widget::highlight()
+            {
+                // choose one random detailed data slice to be updated.
+                detailIndex = qrand() % mainData->count();
+                sliceIndex = qrand() % detailedData.at(detailIndex)->count();
+                // set the slice to exploded to make the change easier to observe
+                detailedData.at(detailIndex)->slices().at(sliceIndex)->setExploded();
+                // give the user time to focus on the slice that will be changed
+                QTimer::singleShot(1000, this, SLOT(updateRotation()));
+            }
             void Widget::updateRotation()
             {
                 // change the explode state of the selected slice back to normal
                 detailedData.at(detailIndex)->slices().at(sliceIndex)->setExploded(false);
             }
+                //! [8]
-            void Widget::highlight()
-                // choose one random detailed data slice to be updated.
-                detailIndex = qrand() % mainData->count();
-                sliceIndex = qrand() % detailedData.at(detailIndex)->count();
-                // set the slice to exploded to make the change easier to observe
-                detailedData.at(detailIndex)->slices().at(sliceIndex)->setExploded();
-                // give the user time to focus on the slice that will be changed
-                QTimer::singleShot(1000, this, SLOT(updateRotation()));

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