qpieseries.cpp
878 lines
| 20.8 KiB
| text/x-c
|
CppLexer
Jani Honkonen
|
r794 | /**************************************************************************** | ||
** | ||||
** Copyright (C) 2012 Digia Plc | ||||
** All rights reserved. | ||||
** For any questions to Digia, please use contact form at http://qt.digia.com | ||||
** | ||||
** This file is part of the Qt Commercial Charts Add-on. | ||||
** | ||||
** $QT_BEGIN_LICENSE$ | ||||
** Licensees holding valid Qt Commercial licenses may use this file in | ||||
** accordance with the Qt Commercial License Agreement provided with the | ||||
** Software or, alternatively, in accordance with the terms contained in | ||||
** a written agreement between you and Digia. | ||||
** | ||||
** If you have questions regarding the use of this file, please use | ||||
** contact form at http://qt.digia.com | ||||
** $QT_END_LICENSE$ | ||||
** | ||||
****************************************************************************/ | ||||
Jani Honkonen
|
r142 | #include "qpieseries.h" | ||
Michal Klocek
|
r938 | #include "qpieseries_p.h" | ||
Jani Honkonen
|
r818 | #include "qpieslice.h" | ||
Jani Honkonen
|
r1274 | #include "qpieslice_p.h" | ||
Jani Honkonen
|
r818 | #include "pieslicedata_p.h" | ||
Michal Klocek
|
r943 | #include "chartdataset_p.h" | ||
#include "charttheme_p.h" | ||||
Michal Klocek
|
r950 | #include "legendmarker_p.h" | ||
sauimone
|
r1545 | #include "qabstractaxis.h" | ||
Michal Klocek
|
r1735 | #include "pieanimation_p.h" | ||
Jani Honkonen
|
r142 | |||
QTCOMMERCIALCHART_BEGIN_NAMESPACE | ||||
Jani Honkonen
|
r320 | /*! | ||
\class QPieSeries | ||||
\brief Pie series API for QtCommercial Charts | ||||
Jani Honkonen
|
r952 | The pie series defines a pie chart which consists of pie slices which are defined as QPieSlice objects. | ||
Jani Honkonen
|
r320 | The slices can have any values as the QPieSeries will calculate its relative value to the sum of all slices. | ||
Jani Honkonen
|
r386 | The actual slice size is determined by that relative value. | ||
Jani Honkonen
|
r320 | |||
Jani Honkonen
|
r952 | Pie size and position on the chart is controlled by using relative values which range from 0.0 to 1.0 | ||
These relate to the actual chart rectangle. | ||||
By default the pie is defined as a full pie but it can also be a partial pie. | ||||
Jani Honkonen
|
r320 | This can be done by setting a starting angle and angle span to the series. | ||
Jani Honkonen
|
r952 | Full pie is 360 degrees where 0 is at 12 a'clock. | ||
Tero Ahola
|
r995 | |||
Marek Rosa
|
r1842 | See the \l {PieChart Example} {pie chart example} or \l {DonutChart Example} {donut chart example} to learn how to use QPieSeries. | ||
\table 100% | ||||
\row | ||||
\o \image examples_piechart.png | ||||
\o \image examples_donut.png | ||||
\endtable | ||||
Jani Honkonen
|
r320 | */ | ||
Tero Ahola
|
r1491 | /*! | ||
\qmlclass PieSeries QPieSeries | ||||
Tero Ahola
|
r1521 | \inherits AbstractSeries | ||
Tero Ahola
|
r1491 | |||
The following QML shows how to create a simple pie chart. | ||||
Jani Honkonen
|
r1504 | |||
Tero Ahola
|
r1491 | \snippet ../demos/qmlchart/qml/qmlchart/View1.qml 1 | ||
Jani Honkonen
|
r1504 | |||
Tero Ahola
|
r1491 | \beginfloatleft | ||
\image demos_qmlchart1.png | ||||
\endfloat | ||||
\clearfloat | ||||
*/ | ||||
Jani Honkonen
|
r320 | |||
Marek Rosa
|
r924 | /*! | ||
Jani Honkonen
|
r928 | \property QPieSeries::horizontalPosition | ||
Jani Honkonen
|
r932 | \brief Defines the horizontal position of the pie. | ||
Jani Honkonen
|
r1504 | |||
Jani Honkonen
|
r932 | The value is a relative value to the chart rectangle where: | ||
Jani Honkonen
|
r1504 | |||
Jani Honkonen
|
r932 | \list | ||
\o 0.0 is the absolute left. | ||||
\o 1.0 is the absolute right. | ||||
\endlist | ||||
Default value is 0.5 (center). | ||||
Tero Ahola
|
r1491 | \sa verticalPosition | ||
*/ | ||||
Jani Honkonen
|
r1504 | |||
Tero Ahola
|
r1491 | /*! | ||
\qmlproperty real PieSeries::horizontalPosition | ||||
Jani Honkonen
|
r1504 | |||
Defines the horizontal position of the pie. | ||||
The value is a relative value to the chart rectangle where: | ||||
Tero Ahola
|
r1491 | \list | ||
\o 0.0 is the absolute left. | ||||
\o 1.0 is the absolute right. | ||||
\endlist | ||||
Default value is 0.5 (center). | ||||
Jani Honkonen
|
r1279 | \sa verticalPosition | ||
*/ | ||||
Jani Honkonen
|
r928 | /*! | ||
\property QPieSeries::verticalPosition | ||||
Jani Honkonen
|
r932 | \brief Defines the vertical position of the pie. | ||
Jani Honkonen
|
r1504 | |||
Jani Honkonen
|
r932 | The value is a relative value to the chart rectangle where: | ||
Jani Honkonen
|
r1504 | |||
Jani Honkonen
|
r932 | \list | ||
\o 0.0 is the absolute top. | ||||
\o 1.0 is the absolute bottom. | ||||
\endlist | ||||
Default value is 0.5 (center). | ||||
Tero Ahola
|
r1491 | \sa horizontalPosition | ||
*/ | ||||
Jani Honkonen
|
r1504 | |||
Tero Ahola
|
r1491 | /*! | ||
\qmlproperty real PieSeries::verticalPosition | ||||
Jani Honkonen
|
r1504 | |||
Defines the vertical position of the pie. | ||||
The value is a relative value to the chart rectangle where: | ||||
Tero Ahola
|
r1491 | \list | ||
\o 0.0 is the absolute top. | ||||
\o 1.0 is the absolute bottom. | ||||
\endlist | ||||
Default value is 0.5 (center). | ||||
Jani Honkonen
|
r1279 | \sa horizontalPosition | ||
*/ | ||||
Jani Honkonen
|
r928 | /*! | ||
\property QPieSeries::size | ||||
Jani Honkonen
|
r932 | \brief Defines the pie size. | ||
Jani Honkonen
|
r928 | |||
Jani Honkonen
|
r932 | The value is a relative value to the chart rectangle where: | ||
\list | ||||
Michal Klocek
|
r974 | \o 0.0 is the minimum size (pie not drawn). | ||
Jani Honkonen
|
r932 | \o 1.0 is the maximum size that can fit the chart. | ||
\endlist | ||||
Marek Rosa
|
r1838 | When setting this property the holeSize property is adjusted if necessary, to ensure that the hole size is not greater than the outer size. | ||
Marek Rosa
|
r1741 | |||
Jani Honkonen
|
r932 | Default value is 0.7. | ||
Jani Honkonen
|
r928 | */ | ||
Jani Honkonen
|
r1504 | /*! | ||
\qmlproperty real PieSeries::size | ||||
Defines the pie size. | ||||
The value is a relative value to the chart rectangle where: | ||||
\list | ||||
\o 0.0 is the minimum size (pie not drawn). | ||||
\o 1.0 is the maximum size that can fit the chart. | ||||
\endlist | ||||
Default value is 0.7. | ||||
*/ | ||||
Marek Rosa
|
r1731 | /*! | ||
Marek Rosa
|
r1838 | \property QPieSeries::holeSize | ||
\brief Defines the donut hole size. | ||||
Marek Rosa
|
r1731 | |||
The value is a relative value to the chart rectangle where: | ||||
\list | ||||
Marek Rosa
|
r1838 | \o 0.0 is the minimum size (full pie drawn, without any hole inside). | ||
Marek Rosa
|
r1731 | \o 1.0 is the maximum size that can fit the chart. (donut has no width) | ||
\endlist | ||||
The value is never greater then size property. | ||||
Marek Rosa
|
r1838 | Default value is 0.0. | ||
Marek Rosa
|
r1731 | */ | ||
/*! | ||||
Marek Rosa
|
r1838 | \qmlproperty real PieSeries::holeSize | ||
Marek Rosa
|
r1731 | |||
Marek Rosa
|
r1838 | Defines the donut hole size. | ||
Marek Rosa
|
r1731 | |||
The value is a relative value to the chart rectangle where: | ||||
\list | ||||
Marek Rosa
|
r1838 | \o 0.0 is the minimum size (full pie drawn, without any hole inside). | ||
Marek Rosa
|
r1731 | \o 1.0 is the maximum size that can fit the chart. (donut has no width) | ||
\endlist | ||||
Marek Rosa
|
r1741 | When setting this property the size property is adjusted if necessary, to ensure that the inner size is not greater than the outer size. | ||
Marek Rosa
|
r1838 | Default value is 0.0. | ||
Marek Rosa
|
r1731 | */ | ||
Jani Honkonen
|
r928 | /*! | ||
\property QPieSeries::startAngle | ||||
Jani Honkonen
|
r932 | \brief Defines the starting angle of the pie. | ||
Jani Honkonen
|
r928 | |||
Jani Honkonen
|
r932 | Full pie is 360 degrees where 0 degrees is at 12 a'clock. | ||
Jani Honkonen
|
r928 | |||
Jani Honkonen
|
r932 | Default is value is 0. | ||
*/ | ||||
Jani Honkonen
|
r928 | |||
Jani Honkonen
|
r1504 | /*! | ||
\qmlproperty real PieSeries::startAngle | ||||
Defines the starting angle of the pie. | ||||
Full pie is 360 degrees where 0 degrees is at 12 a'clock. | ||||
Default is value is 0. | ||||
*/ | ||||
Jani Honkonen
|
r928 | /*! | ||
\property QPieSeries::endAngle | ||||
Jani Honkonen
|
r932 | \brief Defines the ending angle of the pie. | ||
Jani Honkonen
|
r928 | |||
Jani Honkonen
|
r932 | Full pie is 360 degrees where 0 degrees is at 12 a'clock. | ||
Jani Honkonen
|
r928 | |||
Jani Honkonen
|
r932 | Default is value is 360. | ||
*/ | ||||
Jani Honkonen
|
r928 | |||
Jani Honkonen
|
r1504 | /*! | ||
\qmlproperty real PieSeries::endAngle | ||||
Defines the ending angle of the pie. | ||||
Full pie is 360 degrees where 0 degrees is at 12 a'clock. | ||||
Default is value is 360. | ||||
*/ | ||||
Jani Honkonen
|
r1224 | /*! | ||
\property QPieSeries::count | ||||
Jani Honkonen
|
r1279 | Number of slices in the series. | ||
*/ | ||||
Jani Honkonen
|
r1504 | /*! | ||
\qmlproperty int PieSeries::count | ||||
Number of slices in the series. | ||||
*/ | ||||
Jani Honkonen
|
r1279 | /*! | ||
\fn void QPieSeries::countChanged() | ||||
Emitted when the slice count has changed. | ||||
\sa count | ||||
Jani Honkonen
|
r1224 | */ | ||
Tero Ahola
|
r1531 | /*! | ||
\qmlsignal PieSeries::onCountChanged() | ||||
Emitted when the slice count has changed. | ||||
*/ | ||||
Jani Honkonen
|
r1224 | |||
/*! | ||||
\property QPieSeries::sum | ||||
Jani Honkonen
|
r1279 | |||
Sum of all slices. | ||||
Jani Honkonen
|
r1224 | |||
The series keeps track of the sum of all slices it holds. | ||||
*/ | ||||
Jani Honkonen
|
r1504 | /*! | ||
\qmlproperty real PieSeries::sum | ||||
Sum of all slices. | ||||
The series keeps track of the sum of all slices it holds. | ||||
*/ | ||||
Jani Honkonen
|
r1279 | /*! | ||
\fn void QPieSeries::sumChanged() | ||||
Emitted when the sum of all slices has changed. | ||||
\sa sum | ||||
*/ | ||||
Tero Ahola
|
r1531 | /*! | ||
\qmlsignal PieSeries::onSumChanged() | ||||
Emitted when the sum of all slices has changed. This may happen for example if you add or remove slices, or if you | ||||
change value of a slice. | ||||
*/ | ||||
Jani Honkonen
|
r1279 | |||
/*! | ||||
\fn void QPieSeries::added(QList<QPieSlice*> slices) | ||||
This signal is emitted when \a slices have been added to the series. | ||||
\sa append(), insert() | ||||
*/ | ||||
Tero Ahola
|
r1503 | /*! | ||
Tero Ahola
|
r1531 | \qmlsignal PieSeries::onAdded(PieSlice slice) | ||
Tero Ahola
|
r1503 | Emitted when \a slice has been added to the series. | ||
*/ | ||||
Jani Honkonen
|
r1279 | |||
/*! | ||||
\fn void QPieSeries::removed(QList<QPieSlice*> slices) | ||||
This signal is emitted when \a slices have been removed from the series. | ||||
\sa remove() | ||||
*/ | ||||
Tero Ahola
|
r1503 | /*! | ||
Tero Ahola
|
r1531 | \qmlsignal PieSeries::onRemoved(PieSlice slice) | ||
Tero Ahola
|
r1503 | Emitted when \a slice has been removed from the series. | ||
*/ | ||||
Jani Honkonen
|
r1279 | |||
/*! | ||||
\fn void QPieSeries::clicked(QPieSlice* slice) | ||||
This signal is emitted when a \a slice has been clicked. | ||||
\sa QPieSlice::clicked() | ||||
*/ | ||||
Tero Ahola
|
r1531 | /*! | ||
\qmlsignal PieSeries::onClicked(PieSlice slice) | ||||
This signal is emitted when a \a slice has been clicked. | ||||
*/ | ||||
Jani Honkonen
|
r1279 | |||
/*! | ||||
\fn void QPieSeries::hovered(QPieSlice* slice, bool state) | ||||
This signal is emitted when user has hovered over or away from the \a slice. | ||||
\a state is true when user has hovered over the slice and false when hover has moved away from the slice. | ||||
\sa QPieSlice::hovered() | ||||
*/ | ||||
Tero Ahola
|
r1531 | /*! | ||
\qmlsignal PieSeries::onHovered(PieSlice slice, bool state) | ||||
This signal is emitted when user has hovered over or away from the \a slice. \a state is true when user has hovered | ||||
over the slice and false when hover has moved away from the slice. | ||||
*/ | ||||
Marek Rosa
|
r924 | |||
Tero Ahola
|
r1521 | /*! | ||
\qmlmethod PieSlice PieSeries::at(int index) | ||||
Returns slice at \a index. Returns null if the index is not valid. | ||||
*/ | ||||
/*! | ||||
\qmlmethod PieSlice PieSeries::find(string label) | ||||
Returns the first slice with \a label. Returns null if the index is not valid. | ||||
*/ | ||||
/*! | ||||
\qmlmethod PieSlice PieSeries::append(string label, real value) | ||||
Adds a new slice with \a label and \a value to the pie. | ||||
*/ | ||||
/*! | ||||
\qmlmethod bool PieSeries::remove(PieSlice slice) | ||||
Jani Honkonen
|
r1932 | Removes the \a slice from the pie. Returns true if the removal was successful, false otherwise. | ||
Tero Ahola
|
r1521 | */ | ||
/*! | ||||
\qmlmethod PieSeries::clear() | ||||
Removes all slices from the pie. | ||||
*/ | ||||
Jani Honkonen
|
r314 | /*! | ||
Constructs a series object which is a child of \a parent. | ||||
*/ | ||||
Jani Honkonen
|
r2097 | QPieSeries::QPieSeries(QObject *parent) | ||
: QAbstractSeries(*new QPieSeriesPrivate(this), parent) | ||||
Jani Honkonen
|
r203 | { | ||
Michal Klocek
|
r2085 | Q_D(QPieSeries); | ||
Jani Honkonen
|
r2097 | QObject::connect(this, SIGNAL(countChanged()), d, SIGNAL(countChanged())); | ||
Jani Honkonen
|
r203 | } | ||
Jani Honkonen
|
r174 | |||
Jani Honkonen
|
r314 | /*! | ||
Jani Honkonen
|
r933 | Destroys the series and its slices. | ||
Jani Honkonen
|
r314 | */ | ||
Jani Honkonen
|
r203 | QPieSeries::~QPieSeries() | ||
{ | ||||
Jani Honkonen
|
r669 | // NOTE: d_prt destroyed by QObject | ||
Jani Honkonen
|
r203 | } | ||
Jani Honkonen
|
r314 | /*! | ||
Jani Honkonen
|
r320 | Returns QChartSeries::SeriesTypePie. | ||
Jani Honkonen
|
r314 | */ | ||
Michal Klocek
|
r1107 | QAbstractSeries::SeriesType QPieSeries::type() const | ||
Jani Honkonen
|
r314 | { | ||
Tero Ahola
|
r988 | return QAbstractSeries::SeriesTypePie; | ||
Jani Honkonen
|
r314 | } | ||
Jani Honkonen
|
r1279 | /*! | ||
Appends a single \a slice to the series. | ||||
Slice ownership is passed to the series. | ||||
Returns true if append was succesfull. | ||||
*/ | ||||
Jani Honkonen
|
r2104 | bool QPieSeries::append(QPieSlice *slice) | ||
Jani Honkonen
|
r1279 | { | ||
Jani Honkonen
|
r2104 | return append(QList<QPieSlice *>() << slice); | ||
Jani Honkonen
|
r1279 | } | ||
Jani Honkonen
|
r314 | /*! | ||
Jani Honkonen
|
r933 | Appends an array of \a slices to the series. | ||
Jani Honkonen
|
r314 | Slice ownership is passed to the series. | ||
Jani Honkonen
|
r1224 | |||
Jani Honkonen
|
r1932 | Returns true if append was successful. | ||
Jani Honkonen
|
r314 | */ | ||
Jani Honkonen
|
r2104 | bool QPieSeries::append(QList<QPieSlice *> slices) | ||
Jani Honkonen
|
r203 | { | ||
Jani Honkonen
|
r669 | Q_D(QPieSeries); | ||
Jani Honkonen
|
r1104 | if (slices.count() == 0) | ||
return false; | ||||
Jani Honkonen
|
r2097 | foreach (QPieSlice *s, slices) { | ||
Jani Honkonen
|
r1104 | if (!s || d->m_slices.contains(s)) | ||
return false; | ||||
Jani Honkonen
|
r1324 | if (s->series()) // already added to some series | ||
return false; | ||||
Jani Honkonen
|
r1104 | } | ||
Jani Honkonen
|
r2097 | foreach (QPieSlice *s, slices) { | ||
Jani Honkonen
|
r203 | s->setParent(this); | ||
Jani Honkonen
|
r1323 | QPieSlicePrivate::fromSlice(s)->m_series = this; | ||
Jani Honkonen
|
r669 | d->m_slices << s; | ||
Jani Honkonen
|
r174 | } | ||
Jani Honkonen
|
r157 | |||
Jani Honkonen
|
r669 | d->updateDerivativeData(); | ||
Jani Honkonen
|
r174 | |||
Jani Honkonen
|
r2097 | foreach (QPieSlice *s, slices) { | ||
Jani Honkonen
|
r1274 | connect(s, SIGNAL(valueChanged()), d, SLOT(sliceValueChanged())); | ||
Jani Honkonen
|
r1009 | connect(s, SIGNAL(clicked()), d, SLOT(sliceClicked())); | ||
connect(s, SIGNAL(hovered(bool)), d, SLOT(sliceHovered(bool))); | ||||
Jani Honkonen
|
r203 | } | ||
Jani Honkonen
|
r1213 | emit added(slices); | ||
Jani Honkonen
|
r1255 | emit countChanged(); | ||
Jani Honkonen
|
r1104 | |||
return true; | ||||
Jani Honkonen
|
r142 | } | ||
Jani Honkonen
|
r415 | /*! | ||
Jani Honkonen
|
r933 | Appends a single \a slice to the series and returns a reference to the series. | ||
Jani Honkonen
|
r415 | Slice ownership is passed to the series. | ||
*/ | ||||
Jani Honkonen
|
r2104 | QPieSeries &QPieSeries::operator << (QPieSlice *slice) | ||
Jani Honkonen
|
r406 | { | ||
Jani Honkonen
|
r796 | append(slice); | ||
Jani Honkonen
|
r406 | return *this; | ||
} | ||||
Jani Honkonen
|
r314 | |||
/*! | ||||
Jani Honkonen
|
r1206 | Appends a single slice to the series with give \a value and \a label. | ||
Jani Honkonen
|
r314 | Slice ownership is passed to the series. | ||
*/ | ||||
Jani Honkonen
|
r2104 | QPieSlice *QPieSeries::append(QString label, qreal value) | ||
Jani Honkonen
|
r142 | { | ||
Jani Honkonen
|
r2104 | QPieSlice *slice = new QPieSlice(label, value); | ||
Jani Honkonen
|
r796 | append(slice); | ||
Jani Honkonen
|
r203 | return slice; | ||
} | ||||
Jani Honkonen
|
r174 | |||
Jani Honkonen
|
r809 | /*! | ||
Inserts a single \a slice to the series before the slice at \a index position. | ||||
Slice ownership is passed to the series. | ||||
Jani Honkonen
|
r1224 | |||
Jani Honkonen
|
r1932 | Returns true if insert was successful. | ||
Jani Honkonen
|
r809 | */ | ||
Jani Honkonen
|
r2104 | bool QPieSeries::insert(int index, QPieSlice *slice) | ||
Marek Rosa
|
r604 | { | ||
Jani Honkonen
|
r669 | Q_D(QPieSeries); | ||
Jani Honkonen
|
r1104 | |||
if (index < 0 || index > d->m_slices.count()) | ||||
return false; | ||||
if (!slice || d->m_slices.contains(slice)) | ||||
return false; | ||||
Jani Honkonen
|
r1324 | if (slice->series()) // already added to some series | ||
return false; | ||||
Marek Rosa
|
r1204 | slice->setParent(this); | ||
Jani Honkonen
|
r1323 | QPieSlicePrivate::fromSlice(slice)->m_series = this; | ||
Marek Rosa
|
r1204 | d->m_slices.insert(index, slice); | ||
Marek Rosa
|
r1195 | |||
Marek Rosa
|
r1204 | d->updateDerivativeData(); | ||
Marek Rosa
|
r604 | |||
Jani Honkonen
|
r1274 | connect(slice, SIGNAL(valueChanged()), d, SLOT(sliceValueChanged())); | ||
Marek Rosa
|
r1204 | connect(slice, SIGNAL(clicked()), d, SLOT(sliceClicked())); | ||
connect(slice, SIGNAL(hovered(bool)), d, SLOT(sliceHovered(bool))); | ||||
Marek Rosa
|
r604 | |||
sauimone
|
r2081 | |||
Jani Honkonen
|
r2104 | emit added(QList<QPieSlice *>() << slice); | ||
Jani Honkonen
|
r1255 | emit countChanged(); | ||
Jani Honkonen
|
r1104 | |||
return true; | ||||
Marek Rosa
|
r604 | } | ||
Jani Honkonen
|
r314 | /*! | ||
Removes a single \a slice from the series and deletes the slice. | ||||
Jani Honkonen
|
r320 | |||
Jani Honkonen
|
r952 | Do not reference the pointer after this call. | ||
Jani Honkonen
|
r1224 | |||
Jani Honkonen
|
r1932 | Returns true if remove was successful. | ||
Jani Honkonen
|
r314 | */ | ||
Jani Honkonen
|
r2104 | bool QPieSeries::remove(QPieSlice *slice) | ||
Jani Honkonen
|
r203 | { | ||
Jani Honkonen
|
r669 | Q_D(QPieSeries); | ||
Jani Honkonen
|
r1104 | |||
if (!d->m_slices.removeOne(slice)) | ||||
return false; | ||||
Jani Honkonen
|
r174 | |||
Jani Honkonen
|
r669 | d->updateDerivativeData(); | ||
Jani Honkonen
|
r174 | |||
Jani Honkonen
|
r2104 | emit removed(QList<QPieSlice *>() << slice); | ||
Jani Honkonen
|
r1255 | emit countChanged(); | ||
Jani Honkonen
|
r621 | |||
Jani Honkonen
|
r203 | delete slice; | ||
Jani Honkonen
|
r823 | slice = 0; | ||
Jani Honkonen
|
r1104 | |||
return true; | ||||
Jani Honkonen
|
r142 | } | ||
Jani Honkonen
|
r1798 | /*! | ||
Takes a single \a slice from the series. Does not destroy the slice object. | ||||
NOTE: The series remains as the slice's parent object. You must set the | ||||
parent object to take full ownership. | ||||
Jani Honkonen
|
r1932 | Returns true if take was successful. | ||
Jani Honkonen
|
r1798 | */ | ||
Jani Honkonen
|
r2104 | bool QPieSeries::take(QPieSlice *slice) | ||
Jani Honkonen
|
r1798 | { | ||
Q_D(QPieSeries); | ||||
if (!d->m_slices.removeOne(slice)) | ||||
return false; | ||||
QPieSlicePrivate::fromSlice(slice)->m_series = 0; | ||||
Jani Honkonen
|
r2084 | slice->disconnect(d); | ||
Jani Honkonen
|
r1798 | |||
d->updateDerivativeData(); | ||||
Jani Honkonen
|
r2104 | emit removed(QList<QPieSlice *>() << slice); | ||
Jani Honkonen
|
r1798 | emit countChanged(); | ||
return true; | ||||
} | ||||
Jani Honkonen
|
r314 | /*! | ||
Clears all slices from the series. | ||||
*/ | ||||
Jani Honkonen
|
r203 | void QPieSeries::clear() | ||
Jani Honkonen
|
r142 | { | ||
Jani Honkonen
|
r669 | Q_D(QPieSeries); | ||
Marek Rosa
|
r1204 | if (d->m_slices.count() == 0) | ||
Jani Honkonen
|
r203 | return; | ||
Jani Honkonen
|
r174 | |||
Jani Honkonen
|
r2104 | QList<QPieSlice *> slices = d->m_slices; | ||
Jani Honkonen
|
r2097 | foreach (QPieSlice *s, d->m_slices) | ||
Marek Rosa
|
r1204 | d->m_slices.removeOne(s); | ||
Jani Honkonen
|
r566 | |||
Marek Rosa
|
r1204 | d->updateDerivativeData(); | ||
Jani Honkonen
|
r621 | |||
Jani Honkonen
|
r1213 | emit removed(slices); | ||
Jani Honkonen
|
r1255 | emit countChanged(); | ||
Jani Honkonen
|
r2084 | |||
Jani Honkonen
|
r2097 | foreach (QPieSlice *s, slices) | ||
Jani Honkonen
|
r2084 | delete s; | ||
Jani Honkonen
|
r142 | } | ||
Jani Honkonen
|
r1279 | /*! | ||
Returns a list of slices that belong to this series. | ||||
*/ | ||||
Jani Honkonen
|
r2104 | QList<QPieSlice *> QPieSeries::slices() const | ||
Jani Honkonen
|
r1279 | { | ||
Q_D(const QPieSeries); | ||||
return d->m_slices; | ||||
} | ||||
Jani Honkonen
|
r314 | /*! | ||
Jani Honkonen
|
r933 | returns the number of the slices in this series. | ||
Jani Honkonen
|
r314 | */ | ||
int QPieSeries::count() const | ||||
{ | ||||
Jani Honkonen
|
r669 | Q_D(const QPieSeries); | ||
Marek Rosa
|
r1204 | return d->m_slices.count(); | ||
Jani Honkonen
|
r314 | } | ||
Jani Honkonen
|
r621 | /*! | ||
Returns true is the series is empty. | ||||
*/ | ||||
bool QPieSeries::isEmpty() const | ||||
{ | ||||
Jani Honkonen
|
r669 | Q_D(const QPieSeries); | ||
return d->m_slices.isEmpty(); | ||||
Jani Honkonen
|
r621 | } | ||
Jani Honkonen
|
r314 | /*! | ||
Jani Honkonen
|
r1279 | Returns the sum of all slice values in this series. | ||
\sa QPieSlice::value(), QPieSlice::setValue(), QPieSlice::percentage() | ||||
Jani Honkonen
|
r314 | */ | ||
Jani Honkonen
|
r1279 | qreal QPieSeries::sum() const | ||
Jani Honkonen
|
r314 | { | ||
Jani Honkonen
|
r669 | Q_D(const QPieSeries); | ||
Jani Honkonen
|
r1279 | return d->m_sum; | ||
Jani Honkonen
|
r314 | } | ||
Marek Rosa
|
r1838 | void QPieSeries::setHoleSize(qreal holeSize) | ||
Marek Rosa
|
r1671 | { | ||
Q_D(QPieSeries); | ||||
Marek Rosa
|
r1838 | holeSize = qBound((qreal)0.0, holeSize, (qreal)1.0); | ||
d->setSizes(holeSize, qMax(d->m_pieRelativeSize, holeSize)); | ||||
Marek Rosa
|
r1671 | } | ||
Marek Rosa
|
r1838 | qreal QPieSeries::holeSize() const | ||
Marek Rosa
|
r1671 | { | ||
Q_D(const QPieSeries); | ||||
Marek Rosa
|
r1838 | return d->m_holeRelativeSize; | ||
Marek Rosa
|
r1671 | } | ||
Tero Ahola
|
r884 | void QPieSeries::setHorizontalPosition(qreal relativePosition) | ||
{ | ||||
Q_D(QPieSeries); | ||||
Jani Honkonen
|
r1255 | |||
if (relativePosition < 0.0) | ||||
relativePosition = 0.0; | ||||
if (relativePosition > 1.0) | ||||
relativePosition = 1.0; | ||||
if (!qFuzzyIsNull(d->m_pieRelativeHorPos - relativePosition)) { | ||||
d->m_pieRelativeHorPos = relativePosition; | ||||
Tero Ahola
|
r1482 | emit d->horizontalPositionChanged(); | ||
Jani Honkonen
|
r1255 | } | ||
Tero Ahola
|
r884 | } | ||
Jani Honkonen
|
r454 | |||
Jani Honkonen
|
r1279 | qreal QPieSeries::horizontalPosition() const | ||
{ | ||||
Q_D(const QPieSeries); | ||||
return d->m_pieRelativeHorPos; | ||||
} | ||||
Tero Ahola
|
r884 | void QPieSeries::setVerticalPosition(qreal relativePosition) | ||
Jani Honkonen
|
r142 | { | ||
Jani Honkonen
|
r669 | Q_D(QPieSeries); | ||
Jani Honkonen
|
r1255 | |||
if (relativePosition < 0.0) | ||||
relativePosition = 0.0; | ||||
if (relativePosition > 1.0) | ||||
relativePosition = 1.0; | ||||
if (!qFuzzyIsNull(d->m_pieRelativeVerPos - relativePosition)) { | ||||
d->m_pieRelativeVerPos = relativePosition; | ||||
Tero Ahola
|
r1482 | emit d->verticalPositionChanged(); | ||
Jani Honkonen
|
r1255 | } | ||
Jani Honkonen
|
r142 | } | ||
Tero Ahola
|
r884 | qreal QPieSeries::verticalPosition() const | ||
Jani Honkonen
|
r314 | { | ||
Jani Honkonen
|
r669 | Q_D(const QPieSeries); | ||
return d->m_pieRelativeVerPos; | ||||
Jani Honkonen
|
r314 | } | ||
Jani Honkonen
|
r498 | void QPieSeries::setPieSize(qreal relativeSize) | ||
Jani Honkonen
|
r437 | { | ||
Jani Honkonen
|
r669 | Q_D(QPieSeries); | ||
Marek Rosa
|
r1779 | relativeSize = qBound((qreal)0.0, relativeSize, (qreal)1.0); | ||
Marek Rosa
|
r1838 | d->setSizes(qMin(d->m_holeRelativeSize, relativeSize), relativeSize); | ||
Jani Honkonen
|
r1255 | |||
Jani Honkonen
|
r437 | } | ||
Jani Honkonen
|
r314 | |||
Jani Honkonen
|
r498 | qreal QPieSeries::pieSize() const | ||
Jani Honkonen
|
r203 | { | ||
Jani Honkonen
|
r669 | Q_D(const QPieSeries); | ||
return d->m_pieRelativeSize; | ||||
Jani Honkonen
|
r437 | } | ||
Jani Honkonen
|
r498 | void QPieSeries::setPieStartAngle(qreal angle) | ||
Jani Honkonen
|
r437 | { | ||
Jani Honkonen
|
r669 | Q_D(QPieSeries); | ||
Jani Honkonen
|
r1207 | if (qFuzzyIsNull(d->m_pieStartAngle - angle)) | ||
return; | ||||
d->m_pieStartAngle = angle; | ||||
d->updateDerivativeData(); | ||||
Tero Ahola
|
r1482 | emit d->pieStartAngleChanged(); | ||
Jani Honkonen
|
r203 | } | ||
Jani Honkonen
|
r498 | qreal QPieSeries::pieStartAngle() const | ||
Jani Honkonen
|
r437 | { | ||
Jani Honkonen
|
r669 | Q_D(const QPieSeries); | ||
return d->m_pieStartAngle; | ||||
Jani Honkonen
|
r437 | } | ||
Jani Honkonen
|
r454 | /*! | ||
Sets the end angle of the pie. | ||||
Full pie is 360 degrees where 0 degrees is at 12 a'clock. | ||||
Jani Honkonen
|
r498 | \a angle must be greater than start angle. | ||
Jani Honkonen
|
r454 | |||
Jani Honkonen
|
r498 | \sa pieEndAngle(), pieStartAngle(), setPieStartAngle() | ||
Jani Honkonen
|
r454 | */ | ||
Jani Honkonen
|
r498 | void QPieSeries::setPieEndAngle(qreal angle) | ||
Jani Honkonen
|
r437 | { | ||
Jani Honkonen
|
r669 | Q_D(QPieSeries); | ||
Jani Honkonen
|
r1207 | if (qFuzzyIsNull(d->m_pieEndAngle - angle)) | ||
return; | ||||
d->m_pieEndAngle = angle; | ||||
d->updateDerivativeData(); | ||||
Tero Ahola
|
r1482 | emit d->pieEndAngleChanged(); | ||
Jani Honkonen
|
r437 | } | ||
Jani Honkonen
|
r454 | /*! | ||
Returns the end angle of the pie. | ||||
Full pie is 360 degrees where 0 degrees is at 12 a'clock. | ||||
Jani Honkonen
|
r498 | \sa setPieEndAngle(), pieStartAngle(), setPieStartAngle() | ||
Jani Honkonen
|
r454 | */ | ||
Jani Honkonen
|
r498 | qreal QPieSeries::pieEndAngle() const | ||
Jani Honkonen
|
r437 | { | ||
Jani Honkonen
|
r669 | Q_D(const QPieSeries); | ||
return d->m_pieEndAngle; | ||||
Jani Honkonen
|
r437 | } | ||
Jani Honkonen
|
r314 | /*! | ||
Sets the all the slice labels \a visible or invisible. | ||||
Jani Honkonen
|
r1279 | Note that this affects only the current slices in the series. | ||
If user adds a new slice the default label visibility is false. | ||||
Jani Honkonen
|
r314 | \sa QPieSlice::isLabelVisible(), QPieSlice::setLabelVisible() | ||
*/ | ||||
Jani Honkonen
|
r203 | void QPieSeries::setLabelsVisible(bool visible) | ||
{ | ||||
Jani Honkonen
|
r669 | Q_D(QPieSeries); | ||
Jani Honkonen
|
r2097 | foreach (QPieSlice *s, d->m_slices) | ||
Jani Honkonen
|
r203 | s->setLabelVisible(visible); | ||
} | ||||
Marek Rosa
|
r1743 | /*! | ||
Sets the all the slice labels \a position | ||||
Note that this affects only the current slices in the series. | ||||
If user adds a new slice the default label position is LabelOutside | ||||
\sa QPieSlice::labelPosition(), QPieSlice::setLabelPosition() | ||||
*/ | ||||
Marek Rosa
|
r1712 | void QPieSeries::setLabelsPosition(QPieSlice::LabelPosition position) | ||
{ | ||||
Q_D(QPieSeries); | ||||
Jani Honkonen
|
r2097 | foreach (QPieSlice *s, d->m_slices) | ||
Marek Rosa
|
r1712 | s->setLabelPosition(position); | ||
} | ||||
Michal Klocek
|
r938 | /////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////// | ||
Tero Ahola
|
r988 | QPieSeriesPrivate::QPieSeriesPrivate(QPieSeries *parent) : | ||
QAbstractSeriesPrivate(parent), | ||||
Michal Klocek
|
r938 | m_pieRelativeHorPos(0.5), | ||
m_pieRelativeVerPos(0.5), | ||||
m_pieRelativeSize(0.7), | ||||
m_pieStartAngle(0), | ||||
m_pieEndAngle(360), | ||||
Marek Rosa
|
r1670 | m_sum(0), | ||
Marek Rosa
|
r1838 | m_holeRelativeSize(0.0) | ||
Michal Klocek
|
r938 | { | ||
} | ||||
QPieSeriesPrivate::~QPieSeriesPrivate() | ||||
{ | ||||
} | ||||
void QPieSeriesPrivate::updateDerivativeData() | ||||
{ | ||||
Jani Honkonen
|
r939 | // calculate sum of all slices | ||
Jani Honkonen
|
r1255 | qreal sum = 0; | ||
Jani Honkonen
|
r2097 | foreach (QPieSlice *s, m_slices) | ||
Jani Honkonen
|
r1255 | sum += s->value(); | ||
if (!qFuzzyIsNull(m_sum - sum)) { | ||||
m_sum = sum; | ||||
emit q_func()->sumChanged(); | ||||
} | ||||
Michal Klocek
|
r938 | |||
// nothing to show.. | ||||
Jani Honkonen
|
r939 | if (qFuzzyIsNull(m_sum)) | ||
Michal Klocek
|
r938 | return; | ||
// update slice attributes | ||||
qreal sliceAngle = m_pieStartAngle; | ||||
qreal pieSpan = m_pieEndAngle - m_pieStartAngle; | ||||
Jani Honkonen
|
r2104 | QVector<QPieSlice *> changed; | ||
Jani Honkonen
|
r2097 | foreach (QPieSlice *s, m_slices) { | ||
Jani Honkonen
|
r1274 | QPieSlicePrivate *d = QPieSlicePrivate::fromSlice(s); | ||
d->setPercentage(s->value() / m_sum); | ||||
d->setStartAngle(sliceAngle); | ||||
d->setAngleSpan(pieSpan * s->percentage()); | ||||
sliceAngle += s->angleSpan(); | ||||
Michal Klocek
|
r938 | } | ||
Jani Honkonen
|
r1274 | |||
emit calculatedDataChanged(); | ||||
Michal Klocek
|
r938 | } | ||
Marek Rosa
|
r1741 | void QPieSeriesPrivate::setSizes(qreal innerSize, qreal outerSize) | ||
{ | ||||
bool changed = false; | ||||
Marek Rosa
|
r1838 | if (!qFuzzyIsNull(m_holeRelativeSize - innerSize)) { | ||
m_holeRelativeSize = innerSize; | ||||
Marek Rosa
|
r1741 | changed = true; | ||
} | ||||
if (!qFuzzyIsNull(m_pieRelativeSize - outerSize)) { | ||||
m_pieRelativeSize = outerSize; | ||||
changed = true; | ||||
} | ||||
if (changed) | ||||
emit pieSizeChanged(); | ||||
} | ||||
Jani Honkonen
|
r2104 | QPieSeriesPrivate *QPieSeriesPrivate::fromSeries(QPieSeries *series) | ||
Michal Klocek
|
r938 | { | ||
Jani Honkonen
|
r1274 | return series->d_func(); | ||
Michal Klocek
|
r938 | } | ||
Jani Honkonen
|
r1274 | void QPieSeriesPrivate::sliceValueChanged() | ||
Michal Klocek
|
r938 | { | ||
Jani Honkonen
|
r1009 | Q_ASSERT(m_slices.contains(qobject_cast<QPieSlice *>(sender()))); | ||
updateDerivativeData(); | ||||
Michal Klocek
|
r938 | } | ||
Jani Honkonen
|
r1009 | void QPieSeriesPrivate::sliceClicked() | ||
Michal Klocek
|
r938 | { | ||
Jani Honkonen
|
r2104 | QPieSlice *slice = qobject_cast<QPieSlice *>(sender()); | ||
Michal Klocek
|
r938 | Q_ASSERT(m_slices.contains(slice)); | ||
Q_Q(QPieSeries); | ||||
Jani Honkonen
|
r1009 | emit q->clicked(slice); | ||
Michal Klocek
|
r938 | } | ||
Jani Honkonen
|
r1009 | void QPieSeriesPrivate::sliceHovered(bool state) | ||
Michal Klocek
|
r938 | { | ||
Jani Honkonen
|
r2104 | QPieSlice *slice = qobject_cast<QPieSlice *>(sender()); | ||
Michal Klocek
|
r938 | Q_ASSERT(m_slices.contains(slice)); | ||
Q_Q(QPieSeries); | ||||
Jani Honkonen
|
r1009 | emit q->hovered(slice, state); | ||
Michal Klocek
|
r938 | } | ||
Jani Honkonen
|
r2104 | void QPieSeriesPrivate::scaleDomain(Domain &domain) | ||
Michal Klocek
|
r943 | { | ||
Q_UNUSED(domain); | ||||
Jani Honkonen
|
r1191 | // does not apply to pie | ||
Michal Klocek
|
r943 | } | ||
Jani Honkonen
|
r2104 | ChartElement *QPieSeriesPrivate::createGraphics(ChartPresenter *presenter) | ||
Michal Klocek
|
r943 | { | ||
Q_Q(QPieSeries); | ||||
Jani Honkonen
|
r2104 | PieChartItem *pie = new PieChartItem(q, presenter); | ||
Jani Honkonen
|
r2097 | if (presenter->animationOptions().testFlag(QChart::SeriesAnimations)) | ||
Michal Klocek
|
r1735 | pie->setAnimation(new PieAnimation(pie)); | ||
Michal Klocek
|
r943 | presenter->chartTheme()->decorate(q, presenter->dataSet()->seriesIndex(q)); | ||
return pie; | ||||
} | ||||
Michal Klocek
|
r938 | |||
Jani Honkonen
|
r2104 | QList<LegendMarker *> QPieSeriesPrivate::createLegendMarker(QLegend *legend) | ||
Michal Klocek
|
r950 | { | ||
Q_Q(QPieSeries); | ||||
Jani Honkonen
|
r2104 | QList<LegendMarker *> markers; | ||
Jani Honkonen
|
r2097 | foreach (QPieSlice *slice, q->slices()) { | ||
PieLegendMarker* marker = new PieLegendMarker(q, slice, legend); | ||||
Michal Klocek
|
r950 | markers << marker; | ||
} | ||||
return markers; | ||||
} | ||||
Jani Honkonen
|
r2104 | void QPieSeriesPrivate::initializeAxis(QAbstractAxis *axis) | ||
sauimone
|
r1545 | { | ||
Michal Klocek
|
r1588 | Q_UNUSED(axis); | ||
sauimone
|
r1545 | } | ||
Michal Klocek
|
r1695 | QAbstractAxis::AxisType QPieSeriesPrivate::defaultAxisType(Qt::Orientation orientation) const | ||
Michal Klocek
|
r1588 | { | ||
Michal Klocek
|
r1695 | Q_UNUSED(orientation); | ||
Michal Klocek
|
r1588 | return QAbstractAxis::AxisTypeNoAxis; | ||
sauimone
|
r1545 | } | ||
Jani Honkonen
|
r142 | #include "moc_qpieseries.cpp" | ||
Michal Klocek
|
r938 | #include "moc_qpieseries_p.cpp" | ||
Jani Honkonen
|
r142 | |||
QTCOMMERCIALCHART_END_NAMESPACE | ||||