summaryrefslogtreecommitdiffstats
path: root/src/charts/doc/src/examples-donutbreakdown.qdoc
diff options
context:
space:
mode:
authorTitta Heikkala <titta.heikkala@digia.com>2014-07-01 07:10:00 +0300
committerTitta Heikkala <titta.heikkala@theqtcompany.com>2014-10-14 13:04:52 +0300
commitc544258484ff4fd5d2b88402fbaa5d154b89a3a2 (patch)
tree7659625abb566dec55d3783ed820b928542d9b2b /src/charts/doc/src/examples-donutbreakdown.qdoc
parent76339f714f088645e911cee65bdb66055fe029aa (diff)
Qt Charts project file structure change
Charts repository structure is changed to follow the structure of a Qt Add-On module. The task includes following changes: - All macros and definitions named 'commercial' have been renamed. - Compile errors related to QString and qSort usage have been fixed. - Old demos are moved under examples. The QML examples now support only Qt Quick 2.0, the support for Qt Quick 1 is removed. - The QML examples with multiple views are updated so that they are usable also with touch devices. - Unnecessary version checks are removed from examples. - The build stamp has been removed as it was only meant for Charts development purposes and it's no longer needed. Also development build related debug prints are removed as __DATE__ can't be used for all OS thus it doesn't make much sense. - Documentation structure has been updated based on the new module structure. The raw HTML files have been removed. Demos are combined to examples. - Unnecessary .qdocinc files are no longer needed. The content is moved to the corresponding .cpp files. - The Charts widget designer plugin is updated according to the module change. - The test cases updated according to the project structure change. Tests are added also for version 2.0. - cmake modules generation is not needed with Qt 5.4 and Qt Charts so it's disabled. - The new module name and version are updated to the plugin.qmltypes file. Task-number: QTRD-2844, QTRD-3217, QTRD-3218, QTRD-3277, QTRD-3228, QTRD-2526, QTRD-3233, QTRD-3222 Change-Id: Ib7fb26057cde710ffaf6bc780c8bf52a16f45160 Reviewed-by: Miikka Heikkinen <miikka.heikkinen@theqtcompany.com>
Diffstat (limited to 'src/charts/doc/src/examples-donutbreakdown.qdoc')
-rw-r--r--src/charts/doc/src/examples-donutbreakdown.qdoc45
1 files changed, 45 insertions, 0 deletions
diff --git a/src/charts/doc/src/examples-donutbreakdown.qdoc b/src/charts/doc/src/examples-donutbreakdown.qdoc
new file mode 100644
index 00000000..5586a81c
--- /dev/null
+++ b/src/charts/doc/src/examples-donutbreakdown.qdoc
@@ -0,0 +1,45 @@
+/*!
+ \example donutbreakdown
+ \title Donut chart breakdown example
+ \ingroup qtcharts_examples
+
+ \brief This example shows how to use create a donut breakdown chart using QPieSeries API.
+ \image examples_donutbreakdown.png
+
+ Let's start by defining some data for the chart.
+
+ \snippet donutbreakdown/main.cpp 1
+
+ Then we create a chart where we add the data. Note that this is our own chart derived from QChart.
+
+ \snippet donutbreakdown/main.cpp 2
+
+ Our own chart works in such a way that we create a main series in the constructor we create a main series,
+ which aggregates the data provided by the breakdown series. This is the piechart in the center.
+
+ \snippet donutbreakdown/donutbreakdownchart.cpp 1
+
+ When a breakdown series is added the data is used to create a slice in the main series and the
+ breakdown series itself is used to create a segment of a donut positioned so that it is aligned
+ with the corresponding slice in the main series.
+
+ \snippet donutbreakdown/donutbreakdownchart.cpp 2
+
+ Here's how the start and end angles for the donut segments are calculated.
+
+ \snippet donutbreakdown/donutbreakdownchart.cpp 3
+
+ The legend markers are customized to show the breakdown percentage. The markers for the main level slices are hidden.
+
+ \snippet donutbreakdown/donutbreakdownchart.cpp 4
+
+ Instead the main level slices show the percentage on the label.
+
+ \snippet donutbreakdown/mainslice.cpp 1
+ \snippet donutbreakdown/mainslice.cpp 2
+
+ Now that we have our chart defined, we can finally create a QChartView and show the chart.
+
+ \snippet donutbreakdown/main.cpp 3
+
+*/