QLegendMarker Class
The QLegendMarker class is an abstract object that can be used to access markers within a legend. More...
| Header: | #include <QLegendMarker> |
| Inherits: | QObject |
| Inherited By: | QAreaLegendMarker, QBarLegendMarker, QBoxPlotLegendMarker, QCandlestickLegendMarker, QPieLegendMarker, and QXYLegendMarker |
Public Types
| enum | LegendMarkerType { LegendMarkerTypeArea, LegendMarkerTypeBar, LegendMarkerTypePie, LegendMarkerTypeXY, LegendMarkerTypeBoxPlot, LegendMarkerTypeCandlestick } |
Properties
|
Public Functions
| virtual | ~QLegendMarker() |
| QBrush | brush() const |
| QFont | font() const |
| bool | isVisible() const |
| QString | label() const |
| QBrush | labelBrush() const |
| QPen | pen() const |
| virtual QAbstractSeries * | series() = 0 |
| void | setBrush(const QBrush &brush) |
| void | setFont(const QFont &font) |
| void | setLabel(const QString &label) |
| void | setLabelBrush(const QBrush &brush) |
| void | setPen(const QPen &pen) |
| void | setShape(QLegend::MarkerShape shape) |
| void | setVisible(bool visible) |
| QLegend::MarkerShape | shape() const |
| virtual QLegendMarker::LegendMarkerType | type() = 0 |
Signals
| void | brushChanged() |
| void | clicked() |
| void | fontChanged() |
| void | hovered(bool status) |
| void | labelBrushChanged() |
| void | labelChanged() |
| void | penChanged() |
| void | shapeChanged() |
| void | visibleChanged() |
Detailed Description
A legend marker consists of an icon and a label. The icon color corresponds to the color used to draw a series and the label displays the name of the series (or the label of the slice for a pie series or bar set for a bar series). A legend marker is always related to one series, slice, or bar set.
See also QLegend.
Member Type Documentation
enum QLegendMarker::LegendMarkerType
The type of the legend marker object.
| Constant | Value | Description |
|---|---|---|
QLegendMarker::LegendMarkerTypeArea | 0 | A legend marker for an area series. |
QLegendMarker::LegendMarkerTypeBar | 1 | A legend marker for a bar set. |
QLegendMarker::LegendMarkerTypePie | 2 | A legend marker for a pie slice. |
QLegendMarker::LegendMarkerTypeXY | 3 | A legend marker for a line, spline, or scatter series. |
QLegendMarker::LegendMarkerTypeBoxPlot | 4 | A legend marker for a box plot series. |
QLegendMarker::LegendMarkerTypeCandlestick | 5 | A legend marker for a candlestick series. |
This enum was introduced or modified in Qt 5.8.
Property Documentation
brush : QBrush
This property holds the brush used to fill the icon.
Access functions:
Notifier signal:
| void | brushChanged() |
font : QFont
This property holds the font of the label.
Access functions:
Notifier signal:
| void | fontChanged() |
label : QString
This property holds the text shown in the legend for a legend marker.
Access functions:
Notifier signal:
| void | labelChanged() |
labelBrush : QBrush
This property holds the brush of the label.
Access functions:
| QBrush | labelBrush() const |
| void | setLabelBrush(const QBrush &brush) |
Notifier signal:
| void | labelBrushChanged() |
pen : QPen
This property holds the pen used to draw the outline of the icon.
Access functions:
Notifier signal:
| void | penChanged() |
shape : QtCharts::QLegend::MarkerShape
The shape of the legend marker. Defaults to QLegend::MarkerShapeDefault, which indicates the shape is determined by QLegend::markerShape property.
Access functions:
| QLegend::MarkerShape | shape() const |
| void | setShape(QLegend::MarkerShape shape) |
Notifier signal:
| void | shapeChanged() |
visible : bool
This property holds the visibility of the legend marker.
The visibility affects both the legend marker label and the icon.
Access functions:
| bool | isVisible() const |
| void | setVisible(bool visible) |
Notifier signal:
| void | visibleChanged() |
Member Function Documentation
[signal] void QLegendMarker::brushChanged()
This signal is emitted when the brush of the legend marker has changed.
Note: Notifier signal for property brush.
[signal] void QLegendMarker::clicked()
This signal is emitted when the legend marker is clicked.
[signal] void QLegendMarker::fontChanged()
This signal is emitted when the (label) font of the legend marker has changed.
Note: Notifier signal for property font.
[signal] void QLegendMarker::hovered(bool status)
This signal is emitted when a mouse is hovered over the legend marker. When the mouse moves over the marker, status turns true, and when the mouse moves away again, it turns false.
[signal] void QLegendMarker::labelBrushChanged()
This signal is emitted when the label brush of the legend marker has changed.
Note: Notifier signal for property labelBrush.
[signal] void QLegendMarker::labelChanged()
This signal is emitted when the label of the legend marker has changed.
Note: Notifier signal for property label.
[signal] void QLegendMarker::penChanged()
This signal is emitted when the pen of the legend marker has changed.
Note: Notifier signal for property pen.
[signal] void QLegendMarker::visibleChanged()
This signal is emitted when the visibility of the legend marker has changed.
Note: Notifier signal for property visible.
[virtual] QLegendMarker::~QLegendMarker()
Removes the legend marker.
QBrush QLegendMarker::brush() const
Returns the brush used to fill the icon.
Note: Getter function for property brush.
See also setBrush().
QFont QLegendMarker::font() const
Retuns the font of the label.
Note: Getter function for property font.
See also setFont().
bool QLegendMarker::isVisible() const
Returns the visibility of the marker.
Note: Getter function for property visible.
QString QLegendMarker::label() const
Returns the label of the marker.
Note: Getter function for property label.
See also setLabel().
QBrush QLegendMarker::labelBrush() const
Returns the brush that is used to draw the label.
Note: Getter function for property labelBrush.
See also setLabelBrush().
QPen QLegendMarker::pen() const
Returns the pen used to draw the outline of the icon.
Note: Getter function for property pen.
See also setPen().
[pure virtual] QAbstractSeries *QLegendMarker::series()
Returns a pointer to the series that is related to this legend marker. A legend marker is always related to a series.
void QLegendMarker::setBrush(const QBrush &brush)
Sets the brush used to fill the icon to brush.
Note: Changing the color of the series also changes the color of the icon.
Note: Setter function for property brush.
See also brush().
void QLegendMarker::setFont(const QFont &font)
Sets the font of the label to font.
Note: Setter function for property font.
See also font().
void QLegendMarker::setLabel(const QString &label)
Sets the label of the marker to label.
Note: Changing the name of a series also changes the label of its marker.
Note: Setter function for property label.
See also label().
void QLegendMarker::setLabelBrush(const QBrush &brush)
Sets the the brush used to draw to label to brush.
Note: Setter function for property labelBrush.
See also labelBrush().
void QLegendMarker::setPen(const QPen &pen)
Sets the pen used to draw the outline of the icon to pen.
Note: Setter function for property pen.
See also pen().
void QLegendMarker::setVisible(bool visible)
Sets the marker's visibility to visible.
Note: Setter function for property visible.
See also isVisible().
[pure virtual] QLegendMarker::LegendMarkerType QLegendMarker::type()
Returns the type of the legend marker for the related series, pie slice, or bar set.
See also LegendMarkerType.
© 2020 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.