diff options
Diffstat (limited to 'src/charts/doc/src/examples-donutbreakdown.qdoc')
-rw-r--r-- | src/charts/doc/src/examples-donutbreakdown.qdoc | 45 |
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 + +*/ |