qlegendmarker.cpp
292 lines
| 6.6 KiB
| text/x-c
|
CppLexer
sauimone
|
r2160 | /**************************************************************************** | ||
| ** | ||||
Titta Heikkala
|
r2688 | ** Copyright (C) 2014 Digia Plc | ||
|
sauimone
|
r2160 | ** All rights reserved. | ||
Titta Heikkala
|
r2740 | ** For any questions to Digia, please use contact form at http://qt.io | ||
|
sauimone
|
r2160 | ** | ||
|
Titta Heikkala
|
r2740 | ** This file is part of the Qt Charts module. | ||
|
sauimone
|
r2160 | ** | ||
|
Titta Heikkala
|
r2740 | ** Licensees holding valid commercial license for Qt may use this file in | ||
| ** accordance with the Qt License Agreement provided with the Software | ||||
| ** or, alternatively, in accordance with the terms contained in a written | ||||
| ** agreement between you and Digia. | ||||
|
sauimone
|
r2160 | ** | ||
| ** If you have questions regarding the use of this file, please use | ||||
|
Titta Heikkala
|
r2740 | ** contact form at http://qt.io | ||
|
sauimone
|
r2160 | ** | ||
| ****************************************************************************/ | ||||
|
Titta Heikkala
|
r2714 | #include <QtCharts/QLegendMarker> | ||
| #include <private/qlegendmarker_p.h> | ||||
| #include <private/legendmarkeritem_p.h> | ||||
| #include <QtCharts/QLegend> | ||||
| #include <private/qlegend_p.h> | ||||
| #include <private/legendlayout_p.h> | ||||
| #include <QtGui/QFontMetrics> | ||||
| #include <QtWidgets/QGraphicsSceneEvent> | ||||
| #include <QtCharts/QAbstractSeries> | ||||
|
sauimone
|
r2160 | |||
|
Titta Heikkala
|
r2712 | QT_CHARTS_BEGIN_NAMESPACE | ||
|
sauimone
|
r2174 | |||
|
sauimone
|
r2216 | /*! | ||
| \class QLegendMarker | ||||
|
Titta Heikkala
|
r2639 | \inmodule Qt Charts | ||
Miikka Heikkinen
|
r2520 | \brief LegendMarker object. | ||
|
sauimone
|
r2216 | \mainclass | ||
|
sauimone
|
r2217 | QLegendMarker is abstract object that can be used to access markers inside QLegend. Legend marker consists of two | ||
| items: The colored box, which reflects the color of series and label, which is the name of series (or label of slice/barset | ||||
| in case of pie or bar series) | ||||
| The QLegendMarker is always related to one series. | ||||
|
sauimone
|
r2216 | |||
|
sauimone
|
r2217 | \image examples_percentbarchart_legend.png | ||
|
sauimone
|
r2216 | |||
| \sa QLegend | ||||
| */ | ||||
| /*! | ||||
| \enum QLegendMarker::LegendMarkerType | ||||
| The type of the legendmarker object. | ||||
| \value LegendMarkerTypeArea | ||||
| \value LegendMarkerTypeBar | ||||
| \value LegendMarkerTypePie | ||||
| \value LegendMarkerTypeXY | ||||
Mika Salmela
|
r2548 | \value LegendMarkerTypeBoxPlot | ||
|
sauimone
|
r2216 | */ | ||
| /*! | ||||
| \fn virtual LegendMarkerType QLegendMarker::type() = 0; | ||||
| Returns the type of legendmarker. Type depends of the related series. LegendMarkerTypeXY is used for all QXYSeries derived | ||||
| classes. | ||||
| */ | ||||
| /*! | ||||
| \fn virtual QAbstractSeries* QLegendMarker::series() = 0; | ||||
| Returns pointer to series, which is related to this marker. Marker is always related to some series. | ||||
| */ | ||||
| /*! | ||||
| \fn void QLegendMarker::clicked(); | ||||
| This signal is emitted, when marker is clicked with mouse. | ||||
| */ | ||||
| /*! | ||||
| \fn void QLegendMarker::hovered(bool status); | ||||
| This signal is emitted, when mouse is hovered over marker. \a status is true, when mouse enters the marker | ||||
| and false when it leaves the marker. | ||||
| */ | ||||
Tero Ahola
|
r2265 | /*! | ||
| \fn void QLegendMarker::labelChanged() | ||||
| This signal is emitted when the label of the legend marker has changed. | ||||
| */ | ||||
| /*! | ||||
| \fn void QLegendMarker::labelBrushChanged() | ||||
| This signal is emitted when the label brush of the legend marker has changed. | ||||
| */ | ||||
| /*! | ||||
| \fn void QLegendMarker::fontChanged() | ||||
| This signal is emitted when the (label) font of the legend marker has changed. | ||||
| */ | ||||
| /*! | ||||
| \fn void QLegendMarker::penChanged() | ||||
| This signal is emitted when the pen of the legend marker has changed. | ||||
| */ | ||||
| /*! | ||||
| \fn void QLegendMarker::brushChanged() | ||||
| This signal is emitted when the brush of the legend marker has changed. | ||||
| */ | ||||
| /*! | ||||
| \fn void QLegendMarker::visibleChanged() | ||||
| This signal is emitted when the visibility of the legend marker has changed. | ||||
| */ | ||||
|
sauimone
|
r2225 | /*! | ||
| \property QLegendMarker::label | ||||
| Label of the marker. This is the text that is shown in legend. | ||||
| */ | ||||
|
sauimone
|
r2226 | /*! | ||
| \property QLegendMarker::labelBrush | ||||
| Brush of the label | ||||
| */ | ||||
| /*! | ||||
| \property QLegendMarker::font | ||||
| Font of the label | ||||
| */ | ||||
| /*! | ||||
| \property QLegendMarker::pen | ||||
| Pen of the marker. This is the outline of the colored square. | ||||
| */ | ||||
| /*! | ||||
| \property QLegendMarker::brush | ||||
| Brush of the marker. This is the inside of the colored square. | ||||
| */ | ||||
| /*! | ||||
| \property QLegendMarker::visible | ||||
| Visibility of the legend marker. Affects label and the colored square. | ||||
| */ | ||||
|
sauimone
|
r2216 | /*! | ||
|
Tero Ahola
|
r2265 | \internal | ||
|
sauimone
|
r2216 | */ | ||
|
sauimone
|
r2167 | QLegendMarker::QLegendMarker(QLegendMarkerPrivate &d, QObject *parent) : | ||
| QObject(parent), | ||||
| d_ptr(&d) | ||||
| { | ||||
|
sauimone
|
r2182 | d_ptr->m_item->setVisible(d_ptr->series()->isVisible()); | ||
|
sauimone
|
r2167 | } | ||
|
sauimone
|
r2160 | |||
|
sauimone
|
r2216 | /*! | ||
| Destructor of marker | ||||
| */ | ||||
|
sauimone
|
r2160 | QLegendMarker::~QLegendMarker() | ||
| { | ||||
| } | ||||
|
sauimone
|
r2216 | /*! | ||
| Returns the label of the marker. | ||||
| */ | ||||
|
sauimone
|
r2160 | QString QLegendMarker::label() const | ||
| { | ||||
|
sauimone
|
r2174 | return d_ptr->m_item->label(); | ||
|
sauimone
|
r2160 | } | ||
|
sauimone
|
r2216 | /*! | ||
| Sets the \a label of marker. Note that changing name of series will also change label of its marker. | ||||
| */ | ||||
|
sauimone
|
r2160 | void QLegendMarker::setLabel(const QString &label) | ||
| { | ||||
|
Mika Salmela
|
r2429 | if (label.isEmpty()) { | ||
| d_ptr->m_customLabel = false; | ||||
| } else { | ||||
| d_ptr->m_customLabel = true; | ||||
| d_ptr->m_item->setLabel(label); | ||||
| } | ||||
|
sauimone
|
r2163 | } | ||
|
sauimone
|
r2216 | /*! | ||
| Returns the brush which is used to draw label. | ||||
| */ | ||||
|
sauimone
|
r2163 | QBrush QLegendMarker::labelBrush() const | ||
| { | ||||
|
sauimone
|
r2195 | return d_ptr->m_item->labelBrush(); | ||
|
sauimone
|
r2163 | } | ||
|
sauimone
|
r2216 | /*! | ||
| Sets the \a brush of label | ||||
| */ | ||||
|
sauimone
|
r2163 | void QLegendMarker::setLabelBrush(const QBrush &brush) | ||
| { | ||||
|
sauimone
|
r2174 | d_ptr->m_item->setLabelBrush(brush); | ||
|
sauimone
|
r2163 | } | ||
|
sauimone
|
r2216 | /*! | ||
| Retuns the font of label | ||||
| */ | ||||
|
sauimone
|
r2163 | QFont QLegendMarker::font() const | ||
| { | ||||
|
sauimone
|
r2174 | return d_ptr->m_item->font(); | ||
|
sauimone
|
r2163 | } | ||
|
sauimone
|
r2216 | /*! | ||
| Sets the \a font of label | ||||
| */ | ||||
|
sauimone
|
r2163 | void QLegendMarker::setFont(const QFont &font) | ||
| { | ||||
|
sauimone
|
r2174 | d_ptr->m_item->setFont(font); | ||
|
sauimone
|
r2160 | } | ||
|
sauimone
|
r2216 | /*! | ||
| Returns the pen of marker item | ||||
| */ | ||||
|
sauimone
|
r2160 | QPen QLegendMarker::pen() const | ||
| { | ||||
|
sauimone
|
r2174 | return d_ptr->m_item->pen(); | ||
|
sauimone
|
r2160 | } | ||
|
sauimone
|
r2216 | /*! | ||
| Sets the \a pen of marker item | ||||
| */ | ||||
|
sauimone
|
r2160 | void QLegendMarker::setPen(const QPen &pen) | ||
| { | ||||
|
Mika Salmela
|
r2429 | if (pen == QPen(Qt::NoPen)) { | ||
| d_ptr->m_customPen = false; | ||||
| } else { | ||||
| d_ptr->m_customPen = true; | ||||
| d_ptr->m_item->setPen(pen); | ||||
| } | ||||
|
sauimone
|
r2160 | } | ||
|
sauimone
|
r2216 | /*! | ||
| Returns the brush of marker item | ||||
| */ | ||||
|
sauimone
|
r2160 | QBrush QLegendMarker::brush() const | ||
| { | ||||
|
sauimone
|
r2174 | return d_ptr->m_item->brush(); | ||
|
sauimone
|
r2160 | } | ||
|
sauimone
|
r2216 | /*! | ||
| Sets the \a brush of marker item. Note that changing color of the series also changes this. | ||||
| */ | ||||
|
sauimone
|
r2160 | void QLegendMarker::setBrush(const QBrush &brush) | ||
| { | ||||
|
Mika Salmela
|
r2429 | if (brush == QBrush(Qt::NoBrush)) { | ||
| d_ptr->m_customBrush = false; | ||||
| } else { | ||||
| d_ptr->m_customBrush = true; | ||||
| d_ptr->m_item->setBrush(brush); | ||||
| } | ||||
|
sauimone
|
r2160 | } | ||
|
sauimone
|
r2216 | /*! | ||
| Returns visibility of the marker | ||||
| */ | ||||
|
sauimone
|
r2160 | bool QLegendMarker::isVisible() const | ||
| { | ||||
|
sauimone
|
r2174 | return d_ptr->m_item->isVisible(); | ||
|
sauimone
|
r2160 | } | ||
|
sauimone
|
r2216 | /*! | ||
| Sets markers visibility to \a visible | ||||
| */ | ||||
|
sauimone
|
r2160 | void QLegendMarker::setVisible(bool visible) | ||
| { | ||||
|
sauimone
|
r2174 | d_ptr->m_item->setVisible(visible); | ||
|
sauimone
|
r2160 | } | ||
|
sauimone
|
r2163 | //////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////// | ||
|
sauimone
|
r2171 | QLegendMarkerPrivate::QLegendMarkerPrivate(QLegendMarker *q, QLegend *legend) : | ||
|
sauimone
|
r2202 | m_legend(legend), | ||
|
Mika Salmela
|
r2429 | m_customLabel(false), | ||
| m_customBrush(false), | ||||
| m_customPen(false), | ||||
|
sauimone
|
r2202 | q_ptr(q) | ||
|
sauimone
|
r2167 | { | ||
| m_item = new LegendMarkerItem(this); | ||||
| } | ||||
|
sauimone
|
r2163 | |||
|
sauimone
|
r2166 | QLegendMarkerPrivate::~QLegendMarkerPrivate() | ||
| { | ||||
|
sauimone
|
r2381 | delete m_item; | ||
|
sauimone
|
r2166 | } | ||
|
sauimone
|
r2194 | void QLegendMarkerPrivate::invalidateLegend() | ||
| { | ||||
| m_legend->d_ptr->m_layout->invalidate(); | ||||
| } | ||||
|
sauimone
|
r2160 | #include "moc_qlegendmarker.cpp" | ||
|
sauimone
|
r2163 | #include "moc_qlegendmarker_p.cpp" | ||
|
sauimone
|
r2160 | |||
|
Titta Heikkala
|
r2712 | QT_CHARTS_END_NAMESPACE | ||