HG_REPOSITORIES/LPP/INSTRUMENTATION/USERS/JEANDET/qtcharts Commit - r1713:428dd7229243

Documented the donut example

Marek Rosa -

r1713:428dd7229243

parent child

Context file:

r1713:428dd7229243

Collapse all files

doc/src/examples-donut.qdoc created 644 +48 0

@@ -0,0 +1,48
	1	/*!
	2	\example examples/donut
	3	\title Donut example
	4	\subtitle
	5
	6	This example shows how to use create a nested donuts 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/donut/widget.cpp 1
	11
	12	Three variables are defined that will be used to define the donut chart. Min and max size define the relative size of the whole donut.
	13	minSize is the relative inner size of the smallest donut. maxSize is the relative outer size of the biggest donut.
	14
	15	\snippet ../examples/donut/widget.cpp 2
	16
	17	Following block of code defines the individual donuts and their slices. First new QPieSeries object is created.
	18	Callign setDonut() changes pie into a donut. The number of slices in each donut is randomized.
	19	The internal for loop creates the slices with a random value and label same as the value.
	20	Next the label of the slice is set to be visible and its color is set to white.
	21	To make the example more interesting the hovered signal of the slice is connected to widget's slot which inner workings are explained later.
	22	Finally the slice is added to the donut. The donut's size is adjusted to achive the nesting of the donuts.
	23	Then the donut is added to the widget's list of donuts and to the chart.
	24
	25	\snippet ../examples/donut/widget.cpp 3
	26
	27	Finally the widget is placed in a layout used by the application.
	28
	29	\snippet ../examples/donut/widget.cpp 4
	30
	31	To make the example more interesting the donuts are rotated randomly every 1.25 sec.
	32
	33	\snippet ../examples/donut/widget.cpp 5
	34
	35	The widget's updatedRotation slot is defined below.
	36	It goes through all of the donuts and modifies thier current rotation by a random value.
	37
	38	\snippet ../examples/donut/widget.cpp 6
	39
	40	The earlier mentioned explodeSlice slot code is provided below.
	41	If the slice is set to exploded then stop the timer that controls the donuts rotation.
	42	Then the slice's start and end agles are obtained from the slice.
	43	To highlight the selected slice all the other donuts that lie outward from the one that contains the selected slice
	44	have their start and end angles modified so that they wouldn't "block" the way for the hightlighted slice.
	45	If the slice is no longer selected return to the original state.
	46
	47	\snippet ../examples/donut/widget.cpp 7
	48	*/

doc/src/examples.qdoc +2 0

                         <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-donut.html">Donut chart</a></li>
+                        <li><a href="examples-donutdrilldown.html">Donut 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>

examples/donut/widget.cpp +20 -11

                 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]
                 qreal minSize = 0.1;
                 qreal maxSize = 0.9;
                 int donutsCount = 5;
+                //! [2]
+                //! [3]
                 for (int i = 0; i < donutsCount; i++) {
                     QPieSeries *donut = new QPieSeries;
                     donut->setDonut();
-                    donut->setLabelsVisible();
                     int sliceCount =  3 + qrand() % 3;
                     for (int j = 0; j < sliceCount; j++) {
                         qreal value = 100 + qrand() % 100;
                         QPieSlice *slice = new QPieSlice(QString("%1").arg(value), value);
+                        slice->setLabelVisible(true);
+                        slice->setLabelColor(Qt::white);
+                        slice->setLabelPosition(QPieSlice::LabelInsideTangential);
                         connect(slice, SIGNAL(hovered(bool)), this, SLOT(explodeSlice(bool)));
                         donut->append(slice);
-                        donut->slices().last()->setLabelVisible(true);
-                        donut->slices().last()->setLabelColor(Qt::white);
                         donut->setDonutInnerSize(minSize + i * (maxSize - minSize) / donutsCount);
                         donut->setPieSize(minSize + (i + 1) * (maxSize - minSize) / donutsCount);
                     }
                     m_donuts.append(donut);
-                    qreal phase = qrand() % 180;
-                    donut->setLabelsPosition(QPieSlice::LabelInsideTangential);
-                    donut->setPieStartAngle(phase);
-                    donut->setPieEndAngle(360 + phase);
                     chartView->chart()->addSeries(donut);
                 }
+                //! [3]
                 // create main layout
+                //! [4]
                 QGridLayout* mainLayout = new QGridLayout;
                 mainLayout->addWidget(chartView, 1, 1);
                 setLayout(mainLayout);
+                //! [4]
-                chartView->chart()->setAnimationOptions(QChart::AllAnimations);
+                //! [5]
                 updateTimer = new QTimer(this);
                 connect(updateTimer, SIGNAL(timeout()), this, SLOT(updateRotation()));
-                updateTimer->start(1500);
+                updateTimer->start(1250);
+                //! [5]
             }
             Widget::~Widget()
             }
+                //! [6]
             void Widget::updateRotation()
             {
-                //    int tobeupdated = qrand() % m_donutsGroup.count();
                 for (int i = 0; i < m_donuts.count(); i++) {
                     QPieSeries *donut = m_donuts.at(i);
                     qreal phaseShift =  -50 + qrand() % 100;
                     donut->setPieEndAngle(donut->pieEndAngle() + phaseShift);
                 }
             }
+                //! [6]
+                //! [7]
             void Widget::explodeSlice(bool exploded)
             {
                 QPieSlice *slice = qobject_cast<QPieSlice *>(sender());
                 }
                 slice->setExploded(exploded);
             }
+                //! [7]

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