qlegend.cpp
451 lines
| 10.9 KiB
| text/x-c
|
CppLexer
Jani Honkonen
|
r794 | /**************************************************************************** | ||
Michal Klocek
|
r950 | ** | ||
| ** 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
|
r794 | |||
sauimone
|
r524 | #include "qlegend.h" | ||
|
Michal Klocek
|
r950 | #include "qlegend_p.h" | ||
|
sauimone
|
r524 | #include "qseries.h" | ||
|
Michal Klocek
|
r950 | #include "qseries_p.h" | ||
| #include "qchart_p.h" | ||||
|
sauimone
|
r547 | #include "legendmarker_p.h" | ||
|
sauimone
|
r565 | #include "qxyseries.h" | ||
| #include "qlineseries.h" | ||||
| #include "qareaseries.h" | ||||
| #include "qscatterseries.h" | ||||
| #include "qsplineseries.h" | ||||
| #include "qbarseries.h" | ||||
| #include "qstackedbarseries.h" | ||||
| #include "qpercentbarseries.h" | ||||
| #include "qbarset.h" | ||||
| #include "qpieseries.h" | ||||
| #include "qpieslice.h" | ||||
|
sauimone
|
r626 | #include "chartpresenter_p.h" | ||
|
sauimone
|
r529 | #include <QPainter> | ||
| #include <QPen> | ||||
|
Michal Klocek
|
r855 | #include <QTimer> | ||
|
sauimone
|
r524 | |||
|
sauimone
|
r547 | #include <QGraphicsSceneEvent> | ||
|
sauimone
|
r529 | |||
|
sauimone
|
r547 | QTCOMMERCIALCHART_BEGIN_NAMESPACE | ||
|
sauimone
|
r529 | |||
|
sauimone
|
r728 | /*! | ||
|
Michal Klocek
|
r950 | \class QLegend | ||
| \brief part of QtCommercial chart API. | ||||
|
sauimone
|
r728 | |||
|
Michal Klocek
|
r950 | QLegend is a graphical object, whics displays legend of the chart. Legend state is updated by QChart, when | ||
| series have been changed. By default, legend is drawn by QChart, but user can set a new parent to legend and | ||||
| handle the drawing manually. | ||||
| User isn't supposed to create or delete legend objects, but can reference it via QChart class. | ||||
|
sauimone
|
r728 | |||
|
Michal Klocek
|
r950 | \mainclass | ||
|
sauimone
|
r728 | |||
|
Michal Klocek
|
r950 | \sa QChart, QSeries | ||
| */ | ||||
|
sauimone
|
r728 | |||
|
sauimone
|
r724 | /*! | ||
|
Michal Klocek
|
r950 | \enum QLegend::Alignment | ||
|
sauimone
|
r724 | |||
|
Michal Klocek
|
r950 | This enum describes the possible position for legend inside chart. | ||
|
sauimone
|
r724 | |||
|
Michal Klocek
|
r950 | \value AlignmentTop | ||
| \value AlignmentBottom | ||||
| \value AlignmentLeft | ||||
| \value AlignmentRight | ||||
| */ | ||||
|
sauimone
|
r724 | |||
| /*! | ||||
|
Michal Klocek
|
r950 | \fn qreal QLegend::minWidth() const | ||
| Returns minimum width of the legend | ||||
| */ | ||||
|
sauimone
|
r724 | |||
| /*! | ||||
|
Michal Klocek
|
r950 | \fn qreal QLegend::minHeight() const | ||
| Returns minimum height of the legend | ||||
| */ | ||||
|
sauimone
|
r724 | |||
| /*! | ||||
|
Michal Klocek
|
r950 | Constructs the legend object and sets the parent to \a parent | ||
| */ | ||||
|
Michal Klocek
|
r855 | |||
|
Michal Klocek
|
r791 | QLegend::QLegend(QChart *chart):QGraphicsWidget(chart), | ||
|
Michal Klocek
|
r950 | d_ptr(new QLegendPrivate(chart->d_ptr->m_presenter,this)) | ||
|
sauimone
|
r762 | { | ||
|
sauimone
|
r626 | setZValue(ChartPresenter::LegendZValue); | ||
|
Michal Klocek
|
r855 | setFlags(QGraphicsItem::ItemClipsChildrenToShape); | ||
|
Michal Klocek
|
r950 | setEnabled(false); // By default legend is disabled | ||
|
Michal Klocek
|
r956 | setVisible(false); | ||
|
Michal Klocek
|
r950 | QObject::connect(chart->d_ptr->m_dataset,SIGNAL(seriesAdded(QSeries*,Domain*)),d_ptr.data(),SLOT(handleSeriesAdded(QSeries*,Domain*))); | ||
| QObject::connect(chart->d_ptr->m_dataset,SIGNAL(seriesRemoved(QSeries*)),d_ptr.data(),SLOT(handleSeriesRemoved(QSeries*))); | ||||
| } | ||||
| QLegend::~QLegend() | ||||
| { | ||||
|
sauimone
|
r524 | } | ||
|
sauimone
|
r724 | /*! | ||
|
Michal Klocek
|
r950 | Paints the legend to given \a painter. Paremeters \a option and \a widget arent used. | ||
| */ | ||||
|
Michal Klocek
|
r855 | |||
|
sauimone
|
r524 | void QLegend::paint(QPainter *painter, const QStyleOptionGraphicsItem *option, QWidget *widget) | ||
| { | ||||
|
Michal Klocek
|
r950 | Q_UNUSED(option) | ||
| Q_UNUSED(widget) | ||||
| if(!d_ptr->m_backgroundVisible) return; | ||||
Tero Ahola
|
r611 | |||
|
sauimone
|
r724 | painter->setOpacity(opacity()); | ||
|
Michal Klocek
|
r950 | painter->setPen(d_ptr->m_pen); | ||
| painter->setBrush(d_ptr->m_brush); | ||||
|
Michal Klocek
|
r855 | painter->drawRect(boundingRect()); | ||
|
sauimone
|
r524 | } | ||
|
sauimone
|
r724 | /*! | ||
|
Michal Klocek
|
r950 | Bounding rect of legend. | ||
| */ | ||||
|
Michal Klocek
|
r855 | |||
|
sauimone
|
r524 | QRectF QLegend::boundingRect() const | ||
| { | ||||
|
Michal Klocek
|
r950 | return d_ptr->m_rect; | ||
|
sauimone
|
r524 | } | ||
|
sauimone
|
r724 | /*! | ||
|
Michal Klocek
|
r950 | Sets the \a brush of legend. Brush affects the background of legend. | ||
| */ | ||||
|
Tero Ahola
|
r737 | void QLegend::setBrush(const QBrush &brush) | ||
|
sauimone
|
r540 | { | ||
|
Michal Klocek
|
r950 | if (d_ptr->m_brush != brush) { | ||
| d_ptr->m_brush = brush; | ||||
|
Michal Klocek
|
r645 | update(); | ||
| } | ||||
| } | ||||
|
sauimone
|
r724 | /*! | ||
|
Michal Klocek
|
r950 | Returns the brush used by legend. | ||
| */ | ||||
|
Michal Klocek
|
r645 | QBrush QLegend::brush() const | ||
| { | ||||
|
Michal Klocek
|
r950 | return d_ptr->m_brush; | ||
|
Michal Klocek
|
r645 | } | ||
|
sauimone
|
r724 | /*! | ||
|
Michal Klocek
|
r950 | Sets the \a pen of legend. Pen affects the legend borders. | ||
| */ | ||||
|
Tero Ahola
|
r737 | void QLegend::setPen(const QPen &pen) | ||
|
Michal Klocek
|
r645 | { | ||
|
Michal Klocek
|
r950 | if (d_ptr->m_pen != pen) { | ||
| d_ptr->m_pen = pen; | ||||
|
Michal Klocek
|
r645 | update(); | ||
| } | ||||
|
sauimone
|
r540 | } | ||
|
sauimone
|
r724 | /*! | ||
|
Michal Klocek
|
r950 | Returns the pen used by legend | ||
| */ | ||||
|
sauimone
|
r724 | |||
|
Michal Klocek
|
r645 | QPen QLegend::pen() const | ||
|
sauimone
|
r540 | { | ||
|
Michal Klocek
|
r950 | return d_ptr->m_pen; | ||
|
sauimone
|
r540 | } | ||
|
sauimone
|
r724 | /*! | ||
|
Michal Klocek
|
r950 | Sets the \a alignment for legend. Legend tries to paint itself on the defined position in chart. | ||
| \sa QLegend::Alignment | ||||
| */ | ||||
|
Jani Honkonen
|
r907 | void QLegend::setAlignment(QLegend::Alignments alignment) | ||
|
sauimone
|
r616 | { | ||
|
Michal Klocek
|
r950 | if(d_ptr->m_alignment!=alignment && d_ptr->m_attachedToChart) { | ||
| d_ptr->m_alignment = alignment; | ||||
| d_ptr->updateLayout(); | ||||
|
Michal Klocek
|
r855 | } | ||
|
sauimone
|
r716 | } | ||
|
sauimone
|
r724 | /*! | ||
|
Michal Klocek
|
r950 | Returns the preferred layout for legend | ||
| */ | ||||
|
sauimone
|
r803 | QLegend::Alignments QLegend::alignment() const | ||
|
sauimone
|
r716 | { | ||
|
Michal Klocek
|
r950 | return d_ptr->m_alignment; | ||
|
sauimone
|
r616 | } | ||
|
sauimone
|
r724 | /*! | ||
|
Michal Klocek
|
r950 | Detaches the legend from chart. Chart won't change layout of the legend. | ||
| */ | ||||
| void QLegend::detachFromChart() | ||||
|
sauimone
|
r524 | { | ||
|
Michal Klocek
|
r950 | d_ptr->m_attachedToChart = false; | ||
|
sauimone
|
r586 | } | ||
|
sauimone
|
r724 | /*! | ||
|
Michal Klocek
|
r950 | Attaches the legend to chart. Chart may change layout of the legend. | ||
| */ | ||||
| void QLegend::attachToChart() | ||||
|
sauimone
|
r586 | { | ||
|
Michal Klocek
|
r950 | d_ptr->m_attachedToChart = true; | ||
|
sauimone
|
r586 | } | ||
|
sauimone
|
r724 | /*! | ||
|
Michal Klocek
|
r950 | Returns true, if legend is attached to chart. | ||
| */ | ||||
| bool QLegend::isAttachedToChart() | ||||
|
sauimone
|
r637 | { | ||
|
Michal Klocek
|
r950 | return d_ptr->m_attachedToChart; | ||
|
sauimone
|
r637 | } | ||
|
Michal Klocek
|
r950 | void QLegend::setOffset(const QPointF& point) | ||
|
sauimone
|
r643 | { | ||
|
Michal Klocek
|
r950 | d_ptr->setOffset(point.x(),point.y()); | ||
|
sauimone
|
r643 | } | ||
|
Michal Klocek
|
r950 | QPointF QLegend::offset() const | ||
|
sauimone
|
r799 | { | ||
|
Michal Klocek
|
r950 | return QPointF(d_ptr->m_offsetX,d_ptr->m_offsetY); | ||
|
sauimone
|
r799 | } | ||
| /*! | ||||
|
Michal Klocek
|
r950 | Sets the visibility of legend background to \a visible | ||
| */ | ||||
| void QLegend::setBackgroundVisible(bool visible) | ||||
|
sauimone
|
r799 | { | ||
|
Michal Klocek
|
r950 | if(d_ptr->m_backgroundVisible!=visible) | ||
| { | ||||
| d_ptr->m_backgroundVisible=visible; | ||||
| update(); | ||||
| } | ||||
|
sauimone
|
r799 | } | ||
| /*! | ||||
|
Michal Klocek
|
r950 | Returns the visibility of legend background | ||
| */ | ||||
| bool QLegend::isBackgroundVisible() const | ||||
|
sauimone
|
r799 | { | ||
|
Michal Klocek
|
r950 | return d_ptr->m_backgroundVisible; | ||
|
sauimone
|
r799 | } | ||
|
sauimone
|
r724 | /*! | ||
|
Michal Klocek
|
r950 | \internal \a event see QGraphicsWidget for details | ||
| */ | ||||
| void QLegend::resizeEvent(QGraphicsSceneResizeEvent *event) | ||||
|
sauimone
|
r586 | { | ||
|
Michal Klocek
|
r950 | const QRectF& rect = QRectF(QPoint(0,0),event->newSize()); | ||
| QGraphicsWidget::resizeEvent(event); | ||||
| if(d_ptr->m_rect != rect) { | ||||
| d_ptr->m_rect = rect; | ||||
| d_ptr->updateLayout(); | ||||
| } | ||||
|
sauimone
|
r576 | } | ||
|
sauimone
|
r724 | /*! | ||
|
Michal Klocek
|
r950 | \internal \a event see QGraphicsWidget for details | ||
| */ | ||||
| void QLegend::hideEvent(QHideEvent *event) | ||||
|
sauimone
|
r529 | { | ||
|
Michal Klocek
|
r950 | QGraphicsWidget::hideEvent(event); | ||
| setEnabled(false); | ||||
| d_ptr->updateLayout(); | ||||
|
sauimone
|
r565 | } | ||
|
sauimone
|
r724 | /*! | ||
|
Michal Klocek
|
r950 | \internal \a event see QGraphicsWidget for details | ||
| */ | ||||
| void QLegend::showEvent(QShowEvent *event) | ||||
|
sauimone
|
r565 | { | ||
|
Michal Klocek
|
r950 | QGraphicsWidget::showEvent(event); | ||
| setEnabled(true); | ||||
| d_ptr->updateLayout(); | ||||
|
sauimone
|
r565 | } | ||
|
sauimone
|
r529 | |||
|
Michal Klocek
|
r950 | qreal QLegend::minWidth() const | ||
|
sauimone
|
r565 | { | ||
|
Michal Klocek
|
r950 | return d_ptr->m_minWidth; | ||
|
sauimone
|
r529 | } | ||
|
Michal Klocek
|
r950 | qreal QLegend::minHeight() const | ||
|
sauimone
|
r586 | { | ||
|
Michal Klocek
|
r950 | return d_ptr->m_minHeight; | ||
| } | ||||
|
Michal Klocek
|
r855 | |||
|
Michal Klocek
|
r950 | //////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////// | ||
| QLegendPrivate::QLegendPrivate(ChartPresenter* presenter,QLegend *q): | ||||
| q_ptr(q), | ||||
| m_presenter(presenter), | ||||
| m_markers(new QGraphicsItemGroup(q)), | ||||
| m_alignment(QLegend::AlignmentTop), | ||||
| m_offsetX(0), | ||||
| m_offsetY(0), | ||||
| m_minWidth(0), | ||||
| m_minHeight(0), | ||||
| m_width(0), | ||||
| m_height(0), | ||||
| m_attachedToChart(true), | ||||
| m_backgroundVisible(false) | ||||
| { | ||||
|
Michal Klocek
|
r855 | |||
|
sauimone
|
r586 | } | ||
|
Michal Klocek
|
r950 | QLegendPrivate::~QLegendPrivate() | ||
| { | ||||
|
sauimone
|
r529 | |||
|
Michal Klocek
|
r950 | } | ||
| void QLegendPrivate::setOffset(qreal x, qreal y) | ||||
|
Michal Klocek
|
r855 | { | ||
|
sauimone
|
r626 | |||
|
Michal Klocek
|
r855 | switch(m_alignment) { | ||
|
sauimone
|
r716 | |||
|
Michal Klocek
|
r950 | case QLegend::AlignmentTop: | ||
| case QLegend::AlignmentBottom: { | ||||
|
Michal Klocek
|
r855 | if(m_width<=m_rect.width()) return; | ||
|
sauimone
|
r810 | |||
|
Michal Klocek
|
r950 | if (x != m_offsetX) { | ||
| m_offsetX = qBound(0.0, x, m_width - m_rect.width()); | ||||
|
Michal Klocek
|
r855 | m_markers->setPos(-m_offsetX,m_rect.top()); | ||
|
sauimone
|
r626 | } | ||
|
Michal Klocek
|
r855 | break; | ||
|
sauimone
|
r616 | } | ||
|
Michal Klocek
|
r950 | case QLegend::AlignmentLeft: | ||
| case QLegend::AlignmentRight: { | ||||
|
sauimone
|
r716 | |||
|
Michal Klocek
|
r855 | if(m_height<=m_rect.height()) return; | ||
|
sauimone
|
r716 | |||
|
Michal Klocek
|
r950 | if (y != m_offsetY) { | ||
| m_offsetY = qBound(0.0, y, m_height - m_rect.height()); | ||||
|
Michal Klocek
|
r855 | m_markers->setPos(m_rect.left(),-m_offsetY); | ||
|
sauimone
|
r716 | } | ||
|
Michal Klocek
|
r855 | break; | ||
|
sauimone
|
r716 | } | ||
|
sauimone
|
r810 | } | ||
|
Michal Klocek
|
r855 | } | ||
|
sauimone
|
r716 | |||
|
Michal Klocek
|
r950 | void QLegendPrivate::updateLayout() | ||
|
sauimone
|
r716 | { | ||
|
Michal Klocek
|
r950 | m_offsetX=0; | ||
|
Michal Klocek
|
r855 | QList<QGraphicsItem *> items = m_markers->childItems(); | ||
| if(items.isEmpty()) return; | ||||
| m_minWidth=0; | ||||
| m_minHeight=0; | ||||
| switch(m_alignment) { | ||||
|
Michal Klocek
|
r950 | case QLegend::AlignmentTop: | ||
| case QLegend::AlignmentBottom: { | ||||
|
Michal Klocek
|
r855 | QPointF point = m_rect.topLeft(); | ||
| m_width = 0; | ||||
| foreach (QGraphicsItem *item, items) { | ||||
| item->setPos(point.x(),m_rect.height()/2 -item->boundingRect().height()/2); | ||||
| const QRectF& rect = item->boundingRect(); | ||||
| qreal w = rect.width(); | ||||
| m_minWidth=qMax(m_minWidth,w); | ||||
| m_minHeight=qMax(m_minHeight,rect.height()); | ||||
| m_width+=w; | ||||
| point.setX(point.x() + w); | ||||
| } | ||||
|
Michal Klocek
|
r950 | if(m_width<m_rect.width()) { | ||
|
Michal Klocek
|
r855 | m_markers->setPos(m_rect.width()/2-m_width/2,m_rect.top()); | ||
|
Michal Klocek
|
r950 | } | ||
| else { | ||||
|
Michal Klocek
|
r855 | m_markers->setPos(m_rect.topLeft()); | ||
| } | ||||
| m_height=m_minHeight; | ||||
| } | ||||
| break; | ||||
|
Michal Klocek
|
r950 | case QLegend::AlignmentLeft: | ||
| case QLegend::AlignmentRight: { | ||||
|
Michal Klocek
|
r855 | QPointF point = m_rect.topLeft(); | ||
| m_height = 0; | ||||
| foreach (QGraphicsItem *item, items) { | ||||
| item->setPos(point); | ||||
| const QRectF& rect = item->boundingRect(); | ||||
| qreal h = rect.height(); | ||||
| m_minWidth=qMax(m_minWidth,rect.width()); | ||||
| m_minHeight=qMax(m_minHeight,h); | ||||
| m_height+=h; | ||||
| point.setY(point.y() + h); | ||||
| } | ||||
|
Michal Klocek
|
r950 | if(m_height<m_rect.height()) { | ||
|
Michal Klocek
|
r855 | m_markers->setPos(m_rect.left(),m_rect.height()/2-m_height/2); | ||
|
Michal Klocek
|
r950 | } | ||
| else { | ||||
|
Michal Klocek
|
r855 | m_markers->setPos(m_rect.topLeft()); | ||
| } | ||||
| m_width=m_minWidth; | ||||
| } | ||||
| break; | ||||
| } | ||||
|
sauimone
|
r716 | |||
|
Michal Klocek
|
r950 | m_presenter->updateLayout(); | ||
|
sauimone
|
r716 | } | ||
|
Michal Klocek
|
r950 | void QLegendPrivate::handleSeriesAdded(QSeries *series, Domain *domain) | ||
|
Michal Klocek
|
r855 | { | ||
|
Michal Klocek
|
r950 | Q_UNUSED(domain) | ||
|
sauimone
|
r716 | |||
|
Michal Klocek
|
r950 | QList<LegendMarker*> markers = series->d_ptr->createLegendMarker(q_ptr); | ||
| foreach(LegendMarker* marker , markers) | ||||
| m_markers->addToGroup(marker); | ||||
|
sauimone
|
r716 | |||
|
Michal Klocek
|
r956 | if(series->type()==QSeries::SeriesTypePie) | ||
| { | ||||
| QPieSeries *pieSeries = static_cast<QPieSeries *>(series); | ||||
| QObject::connect(pieSeries,SIGNAL(added(QList<QPieSlice*>)),this,SLOT(handleUpdateSeries())); | ||||
| QObject::connect(pieSeries,SIGNAL(removed(QList<QPieSlice*>)),this,SLOT(handleUpdateSeries())); | ||||
| } | ||||
|
Michal Klocek
|
r855 | updateLayout(); | ||
|
sauimone
|
r716 | } | ||
|
Michal Klocek
|
r950 | void QLegendPrivate::handleSeriesRemoved(QSeries *series) | ||
|
sauimone
|
r716 | { | ||
|
Michal Klocek
|
r950 | |||
| QList<QGraphicsItem *> items = m_markers->childItems(); | ||||
|
Michal Klocek
|
r956 | foreach (QGraphicsItem *markers, items) { | ||
| LegendMarker *marker = static_cast<LegendMarker*>(markers); | ||||
| if (marker->series() == series) { | ||||
| delete marker; | ||||
| } | ||||
| } | ||||
| if(series->type()==QSeries::SeriesTypePie) | ||||
| { | ||||
| QPieSeries *pieSeries = static_cast<QPieSeries *>(series); | ||||
| QObject::disconnect(pieSeries,SIGNAL(added(QList<QPieSlice*>)),this,SLOT(handleUpdateSeries())); | ||||
| QObject::disconnect(pieSeries,SIGNAL(removed(QList<QPieSlice*>)),this,SLOT(handleUpdateSeries())); | ||||
| } | ||||
|
Michal Klocek
|
r950 | |||
|
Michal Klocek
|
r855 | updateLayout(); | ||
| } | ||||
|
sauimone
|
r724 | |||
|
Michal Klocek
|
r956 | void QLegendPrivate::handleUpdateSeries() | ||
| { | ||||
| //TODO: reimplement to be optimal | ||||
| QSeries* series = qobject_cast<QSeries *> (sender()); | ||||
| Q_ASSERT(series); | ||||
| handleSeriesRemoved(series); | ||||
| handleSeriesAdded(series,0); | ||||
| } | ||||
|
sauimone
|
r524 | #include "moc_qlegend.cpp" | ||
|
Michal Klocek
|
r950 | #include "moc_qlegend_p.cpp" | ||
|
Tero Ahola
|
r737 | |||
|
sauimone
|
r524 | QTCOMMERCIALCHART_END_NAMESPACE | ||