|
|
/*!
|
|
|
\example examples/horizontalpercentbarchart
|
|
|
\title HorizontalPercentBarChart Example
|
|
|
\subtitle
|
|
|
|
|
|
The example shows how to create a simple horizontal percent bar chart. The horizontal percent bar chart shows the data in a set as a percentage of
|
|
|
all sets per category.
|
|
|
|
|
|
Creating a horizontal percent bar chart is just like creating a regular \l {BarChart Example} {bar chart}, except that for a
|
|
|
horizontal percent bar chart, we use the QHorizontalPercentBarSeries api instead of QBarSeries. Also, in the
|
|
|
\l {BarChart Example} {bar chart}, we used a nice numbers algorithm to make the y-axis numbering look better. With
|
|
|
the percent bar chart there is no need for that, because the maximum y-axis value is always 100.
|
|
|
|
|
|
\image examples_horizontalpercentbarchart.png
|
|
|
|
|
|
The barsets are used in same way in all barcharts.
|
|
|
To illustrate the difference between various barcharts, we use same data in examples.
|
|
|
The data which the bar chart visualizes is defined by QBarSet instances. Here we create the sets and append data
|
|
|
to them. The data is appended here with << operator. Alternatively the append method could be used.
|
|
|
|
|
|
\snippet ../examples/horizontalpercentbarchart/main.cpp 1
|
|
|
|
|
|
We create the series and append the bar sets to it. The series takes ownership of the barsets. The series groups the data from sets to categories.
|
|
|
The first values of each set are grouped together in the first category, the second value in the second category etc.
|
|
|
|
|
|
\snippet ../examples/horizontalpercentbarchart/main.cpp 2
|
|
|
|
|
|
Here we create the chart object and add the series to it. We set the title for chart with setTitle and then turn on animations of the series by calling
|
|
|
setAnimationOptions(QChart::SeriesAnimations)
|
|
|
|
|
|
\snippet ../examples/horizontalpercentbarchart/main.cpp 3
|
|
|
|
|
|
To have the categories displayed on an axis, we need to create a QBarCategoryAxis first. Here we create a category axis with a list of categories and
|
|
|
set it to be the y-axis of the chart. The chart takes ownership of the axis. For the x-axis we use the default axis, which is created and scaled to series data
|
|
|
by calling createDefaultAxes of the chart. Note that createDefaultAxes must be called before we set the category axis. Otherwise the default axis will
|
|
|
override the category axis.
|
|
|
|
|
|
\snippet ../examples/horizontalpercentbarchart/main.cpp 4
|
|
|
|
|
|
We also want to show the legend. To do that, we get the legend pointer from the chart
|
|
|
and set it to visible. We also place the legend to bottom of the chart by setting its
|
|
|
alignment to Qt::AlignBottom.
|
|
|
|
|
|
\snippet ../examples/horizontalpercentbarchart/main.cpp 5
|
|
|
|
|
|
Finally, we add the chart onto a view. We also turn on the antialiasing for the chartView.
|
|
|
|
|
|
\snippet ../examples/horizontalpercentbarchart/main.cpp 6
|
|
|
|
|
|
The chart is ready to be shown. We set the chart to be the central widget of the window.
|
|
|
We also set the size for the chart window and show it.
|
|
|
|
|
|
\snippet ../examples/horizontalpercentbarchart/main.cpp 7
|
|
|
*/
|
|
|
|
