#include "qpieseries.h" #include "qpieslice.h" #include "piepresenter.h" #include "pieslice.h" #include #include QTCOMMERCIALCHART_BEGIN_NAMESPACE /*! \enum QPieSeries::PiePosition This enum describes pie position within its bounding rectangle \value PiePositionMaximized \value PiePositionTopLeft \value PiePositionTopRight \value PiePositionBottomLeft \value PiePositionBottomRight */ /*! \class QPieSeries \brief QtCommercial charts pie series API. */ void QPieSeries::ChangeSet::appendAdded(QPieSlice* slice) { if (!m_added.contains(slice)) m_added << slice; } void QPieSeries::ChangeSet::appendAdded(QList slices) { foreach (QPieSlice* s, slices) appendAdded(s); } void QPieSeries::ChangeSet::appendChanged(QPieSlice* slice) { if (!m_changed.contains(slice)) m_changed << slice; } void QPieSeries::ChangeSet::appendRemoved(QPieSlice* slice) { if (!m_removed.contains(slice)) m_removed << slice; } /*! Returns a list of slices that have been added to the series. \sa QPieSeries::changed() */ QList QPieSeries::ChangeSet::added() const { return m_added; } /*! Returns a list of slices that have been changed in the series. \sa QPieSeries::changed() */ QList QPieSeries::ChangeSet::changed() const { return m_changed; } /*! Returns a list of slices that have been removed from the series. \sa QPieSeries::changed() */ QList QPieSeries::ChangeSet::removed() const { return m_removed; } /*! Returns true if there are no added/changed or removed slices in the change set. */ bool QPieSeries::ChangeSet::isEmpty() const { if (m_added.count() || m_changed.count() || m_removed.count()) return false; return true; } /*! Constructs a series object which is a child of \a parent. */ QPieSeries::QPieSeries(QObject *parent) : QChartSeries(parent), m_sizeFactor(1.0), m_position(PiePositionMaximized), m_pieStartAngle(0), m_pieAngleSpan(360) { } /*! Destroys the object. Note that adding series to QChart transfers the ownership to the chart. */ QPieSeries::~QPieSeries() { } /*! Returns the type of the series which is always QChartSeries::SeriesTypePie. */ QChartSeries::QChartSeriesType QPieSeries::type() const { return QChartSeries::SeriesTypePie; } /*! Sets an array of values to the series. TO BE REMOVED */ bool QPieSeries::setData(QList data) { // TODO: remove this function QList slices; foreach (qreal value, data) slices << new QPieSlice(value, QString::number(value)); set(slices); return true; } /*! Sets an array of \a slices to the series. Slice ownership is passed to the series. */ void QPieSeries::set(QList slices) { clear(); add(slices); } /*! Adds an array of slices to the series. Slice ownership is passed to the series. */ void QPieSeries::add(QList slices) { ChangeSet changeSet; foreach (QPieSlice* s, slices) { s->setParent(this); m_slices << s; changeSet.appendAdded(s); } updateDerivativeData(); foreach (QPieSlice* s, slices) { connect(s, SIGNAL(changed()), this, SLOT(sliceChanged())); connect(s, SIGNAL(clicked()), this, SLOT(sliceClicked())); connect(s, SIGNAL(hoverEnter()), this, SLOT(sliceHoverEnter())); connect(s, SIGNAL(hoverLeave()), this, SLOT(sliceHoverLeave())); } emit changed(changeSet); } /*! Adds a single \a slice to the series. Slice ownership is passed to the series. */ void QPieSeries::add(QPieSlice* slice) { add(QList() << slice); } /*! Adds a single slice to the series with give \a value and \a name. Slice ownership is passed to the series. */ QPieSlice* QPieSeries::add(qreal value, QString name) { QPieSlice* slice = new QPieSlice(value, name); add(slice); return slice; } /*! Removes a single \a slice from the series and deletes the slice. Do not reference this pointer after this call. */ void QPieSeries::remove(QPieSlice* slice) { if (!m_slices.removeOne(slice)) { Q_ASSERT(0); // TODO: how should this be reported? return; } ChangeSet changeSet; changeSet.appendRemoved(slice); emit changed(changeSet); delete slice; slice = NULL; updateDerivativeData(); } /*! Clears all slices from the series. */ void QPieSeries::clear() { if (m_slices.count() == 0) return; ChangeSet changeSet; foreach (QPieSlice* s, m_slices) { changeSet.appendRemoved(s); m_slices.removeOne(s); delete s; } emit changed(changeSet); updateDerivativeData(); } /*! Counts the number of the slices in this series. */ int QPieSeries::count() const { return m_slices.count(); } /*! Returns a list of slices that belong to this series. */ QList QPieSeries::slices() const { return m_slices; } /*! Sets the size \a factor of the pie. 1.0 is the default value. Note that the pie will not grow beyond its absolute maximum size. In practice its use is to make the pie appear smaller. \sa sizeFactor() */ void QPieSeries::setSizeFactor(qreal factor) { if (factor < 0.0) return; if (m_sizeFactor != factor) { m_sizeFactor = factor; emit sizeFactorChanged(); } } /*! Gets the size factor of the pie. \sa setSizeFactor() */ qreal QPieSeries::sizeFactor() const { return m_sizeFactor; } /*! Sets the \a position of the pie within its bounding rectangle. \sa PiePosition, position() */ void QPieSeries::setPosition(PiePosition position) { if (m_position != position) { m_position = position; emit positionChanged(); } } /*! Gets the position of the pie within its bounding rectangle. \sa PiePosition, setPosition() */ QPieSeries::PiePosition QPieSeries::position() const { return m_position; } /*! Sets the \a startAngle and \a angleSpan of this series. \sa */ void QPieSeries::setSpan(qreal startAngle, qreal angleSpan) { if (startAngle >= 0 && startAngle < 360 && angleSpan > 0 && angleSpan <= 360) { m_pieStartAngle = startAngle; m_pieAngleSpan = angleSpan; updateDerivativeData(); } } /*! Sets the all the slice labels \a visible or invisible. \sa QPieSlice::isLabelVisible(), QPieSlice::setLabelVisible() */ void QPieSeries::setLabelsVisible(bool visible) { foreach (QPieSlice* s, m_slices) s->setLabelVisible(visible); } /*! Convenience method for exploding a slice when user clicks the pie. \sa QPieSlice::isExploded(), QPieSlice::setExploded() */ void QPieSeries::enableClickExplodes(bool enable) { if (enable) connect(this, SIGNAL(clicked(QPieSlice*)), this, SLOT(toggleExploded(QPieSlice*))); else disconnect(this, SLOT(toggleExploded(QPieSlice*))); } /*! Convenience method for highlighting a slice when user hovers over the slice. It changes the slice color to be lighter and shows the label of the slice. \sa QPieSlice::isExploded(), QPieSlice::setExploded() */ void QPieSeries::enableHoverHighlight(bool enable) { if (enable) { connect(this, SIGNAL(hoverEnter(QPieSlice*)), this, SLOT(highlightOn(QPieSlice*))); connect(this, SIGNAL(hoverLeave(QPieSlice*)), this, SLOT(highlightOff(QPieSlice*))); } else { disconnect(this, SLOT(hoverEnter(QPieSlice*))); disconnect(this, SLOT(hoverLeave(QPieSlice*))); } } /*! \fn void QPieSeries::changed(const QPieSeries::ChangeSet& changeSet) This signal emitted when something has changed in the series. The \a changeSet contains the details of which slices have been added, changed or removed. \sa QPieSeries::ChangeSet, QPieSlice::changed() */ /*! \fn void QPieSeries::clicked(QPieSlice* slice) This signal is emitted when a \a slice has been clicked. \sa QPieSlice::clicked() */ /*! \fn void QPieSeries::hoverEnter(QPieSlice* slice) This signal is emitted when user has hovered over a \a slice. \sa QPieSlice::hoverEnter() */ /*! \fn void QPieSeries::hoverLeave(QPieSlice* slice) This signal is emitted when user has hovered away from a \a slice. \sa QPieSlice::hoverLeave() */ /*! \fn void QPieSeries::sizeFactorChanged() This signal is emitted when size factor has been changed. \sa sizeFactor(), setSizeFactor() */ /*! \fn void QPieSeries::positionChanged() This signal is emitted when position of the pie has been changed. \sa position(), setPosition() */ void QPieSeries::sliceChanged() { QPieSlice* slice = qobject_cast(sender()); Q_ASSERT(m_slices.contains(slice)); ChangeSet changeSet; changeSet.appendChanged(slice); emit changed(changeSet); updateDerivativeData(); } void QPieSeries::sliceClicked() { QPieSlice* slice = qobject_cast(sender()); Q_ASSERT(m_slices.contains(slice)); emit clicked(slice); } void QPieSeries::sliceHoverEnter() { QPieSlice* slice = qobject_cast(sender()); Q_ASSERT(m_slices.contains(slice)); emit hoverEnter(slice); } void QPieSeries::sliceHoverLeave() { QPieSlice* slice = qobject_cast(sender()); Q_ASSERT(m_slices.contains(slice)); emit hoverLeave(slice); } void QPieSeries::toggleExploded(QPieSlice* slice) { Q_ASSERT(slice); slice->setExploded(!slice->isExploded()); } void QPieSeries::highlightOn(QPieSlice* slice) { Q_ASSERT(slice); QColor c = slice->brush().color().lighter(); slice->setBrush(c); slice->setLabelVisible(true); } void QPieSeries::highlightOff(QPieSlice* slice) { Q_ASSERT(slice); QColor c = slice->brush().color().darker(150); slice->setBrush(c); slice->setLabelVisible(false); } void QPieSeries::updateDerivativeData() { m_total = 0; // nothing to do? if (m_slices.count() == 0) return; // calculate total foreach (QPieSlice* s, m_slices) m_total += s->value(); // we must have some values Q_ASSERT(m_total > 0); // TODO: is this the correct way to handle this? // update slice attributes qreal sliceAngle = m_pieStartAngle; foreach (QPieSlice* s, m_slices) { bool changed = false; qreal percentage = s->value() / m_total; if (s->m_percentage != percentage) { s->m_percentage = percentage; changed = true; } qreal sliceSpan = m_pieAngleSpan * percentage; if (s->m_angleSpan != sliceSpan) { s->m_angleSpan = sliceSpan; changed = true; } if (s->m_angle != sliceAngle) { s->m_angle = sliceAngle; changed = true; } sliceAngle += sliceSpan; if (changed) emit s->changed(); } } #include "moc_qpieseries.cpp" QTCOMMERCIALCHART_END_NAMESPACE