Sur cette page

QLegendMarker Class

La classe QLegendMarker est un objet abstrait permettant d'accéder aux marqueurs d'une légende. En savoir plus...

Header: #include <QLegendMarker>
Inherits: QObject
Inherited By:

QAreaLegendMarker, QBarLegendMarker, QBoxPlotLegendMarker, QCandlestickLegendMarker, QPieLegendMarker, and QXYLegendMarker

Status: Deprecated

Cette classe est obsolète. Nous déconseillons fortement de l'utiliser dans du nouveau code.

Types publics

enum LegendMarkerType { LegendMarkerTypeArea, LegendMarkerTypeBar, LegendMarkerTypePie, LegendMarkerTypeXY, LegendMarkerTypeBoxPlot, LegendMarkerTypeCandlestick }

Propriétés

Fonctions publiques

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

Signaux

void brushChanged()
void clicked()
void fontChanged()
void hovered(bool status)
void labelBrushChanged()
void labelChanged()
void penChanged()
void shapeChanged()
void visibleChanged()

Description détaillée

Un marqueur de légende se compose d’une icône et d’une étiquette. La couleur de l’icône correspond à la couleur utilisée pour tracer une série et l’étiquette affiche le nom de la série (ou le libellé de la part pour une série circulaire, ou de l’ensemble de barres pour une série à barres). Un marqueur de légende est toujours associé à une série, une part ou un ensemble de barres.

Diagramme à barres en pourcentage avec une légende en bas indiquant les noms des cinq séries de barres en fonction de leur couleur

Voir également QLegend.

Documentation sur les types de membres

enum QLegendMarker::LegendMarkerType

Le type de l'objet « marqueur de légende ».

ConstanteValeurDescription
QLegendMarker::LegendMarkerTypeArea0Un marqueur de légende pour une série de surfaces.
QLegendMarker::LegendMarkerTypeBar1Un marqueur de légende pour un ensemble de barres.
QLegendMarker::LegendMarkerTypePie2Un marqueur de légende pour une part de camembert.
QLegendMarker::LegendMarkerTypeXY3Un marqueur de légende pour une série de lignes, de splines ou de points.
QLegendMarker::LegendMarkerTypeBoxPlot4Un marqueur de légende pour une série de diagrammes en boîte.
QLegendMarker::LegendMarkerTypeCandlestick5Un marqueur de légende pour une série de chandeliers.

Documentation sur les propriétés

brush : QBrush

Cette propriété contient le pinceau utilisé pour remplir l'icône.

Fonctions d'accès :

QBrush brush() const
void setBrush(const QBrush &brush)

Signal de notification :

void brushChanged()

font : QFont

Cette propriété contient la police de caractères de l'étiquette.

Fonctions d'accès :

QFont font() const
void setFont(const QFont &font)

Signal de notification :

void fontChanged()

label : QString

Cette propriété contient le texte affiché dans la légende pour un marqueur de légende.

Fonctions d'accès :

QString label() const
void setLabel(const QString &label)

Signal de notification :

void labelChanged()

labelBrush : QBrush

Cette propriété contient le pinceau de l'étiquette.

Fonctions d'accès :

QBrush labelBrush() const
void setLabelBrush(const QBrush &brush)

Signal de notification :

pen : QPen

Cette propriété contient le stylo utilisé pour dessiner le contour de l'icône.

Fonctions d'accès :

QPen pen() const
void setPen(const QPen &pen)

Signal de notification :

void penChanged()

shape : QLegend::MarkerShape

La forme du marqueur de légende. La valeur par défaut est « QLegend::MarkerShapeDefault », ce qui signifie que la forme est déterminée par la propriété « QLegend::markerShape ».

Fonctions d’accès :

QLegend::MarkerShape shape() const
void setShape(QLegend::MarkerShape shape)

Signal de notification :

void shapeChanged()

visible : bool

Cette propriété définit la visibilité du marqueur de légende.

La visibilité s'applique à la fois au libellé et à l'icône du marqueur de légende.

Fonctions d'accès :

bool isVisible() const
void setVisible(bool visible)

Signal de notification :

Documentation des fonctions membres

[virtual noexcept] QLegendMarker::~QLegendMarker()

Supprime le marqueur de légende.

QBrush QLegendMarker::brush() const

Renvoie le pinceau utilisé pour remplir l'icône.

Remarque : fonctiongetter pour la propriété brush.

Voir aussi : ` setBrush()`.

[signal] void QLegendMarker::brushChanged()

Ce signal est émis lorsque le pinceau du marqueur de légende a changé.

Remarque : signalde notification pour la propriété « brush ».

[signal] void QLegendMarker::clicked()

Ce signal est émis lorsqu'on clique sur le marqueur de légende.

QFont QLegendMarker::font() const

Renvoie la police de l'étiquette.

Remarque : fonctiongetter pour la propriété font.

Voir aussi setFont().

[signal] void QLegendMarker::fontChanged()

Ce signal est émis lorsque la police (étiquette) du marqueur de légende a changé.

Remarque : signalde notification pour la propriété font.

[signal] void QLegendMarker::hovered(bool status)

Ce signal est émis lorsque le curseur de la souris survole le marqueur de la légende. Lorsque la souris survole le marqueur, status devient true, et lorsque la souris s'en éloigne, il redevient false.

bool QLegendMarker::isVisible() const

Renvoie la visibilité du marqueur.

Remarque : fonctiongetter pour la propriété visible.

QString QLegendMarker::label() const

Renvoie le libellé du marqueur.

Remarque : fonctiongetter pour la propriété « label ».

Voir aussi setLabel().

QBrush QLegendMarker::labelBrush() const

Renvoie le pinceau utilisé pour dessiner l'étiquette.

Remarque : fonctionde récupération pour la propriété labelBrush.

Voir également setLabelBrush().

[signal] void QLegendMarker::labelBrushChanged()

Ce signal est émis lorsque le pinceau d'étiquette du marqueur de légende a changé.

Remarque : signalde notification pour la propriété labelBrush.

[signal] void QLegendMarker::labelChanged()

Ce signal est émis lorsque le libellé du marqueur de légende a changé.

Remarque : signalde notification pour la propriété « label ».

QPen QLegendMarker::pen() const

Renvoie le stylo utilisé pour tracer le contour de l'icône.

Remarque : fonctiongetter pour la propriété pen.

Voir aussi setPen().

[signal] void QLegendMarker::penChanged()

Ce signal est émis lorsque la pointe du marqueur de légende a changé.

Remarque : signalde notification pour la propriété pen.

[pure virtual] QAbstractSeries *QLegendMarker::series()

Renvoie un pointeur vers la série associée à ce marqueur de légende. Un marqueur de légende est toujours associé à une série.

void QLegendMarker::setBrush(const QBrush &brush)

Définit le pinceau utilisé pour remplir l'icône sur « brush ».

Remarque : la modification de la couleur de la série entraîne également la modification de la couleur de l'icône.

Remarque : fonctionde définition de la propriété brush.

Voir également brush().

void QLegendMarker::setFont(const QFont &font)

Définit la police de l'étiquette sur « font ».

Remarque : fonctionde définition de la propriété font.

Voir aussi ` font()`.

void QLegendMarker::setLabel(const QString &label)

Définit le libellé du marqueur sur « label ».

Remarque : la modification du nom d'une série entraîne également la modification du libellé de son marqueur.

Remarque : fonctionde définition de la propriété label.

Voir également label().

void QLegendMarker::setLabelBrush(const QBrush &brush)

Définit le pinceau utilisé pour dessiner l'étiquette sur brush.

Remarque : fonctionde définition de la propriété ` labelBrush`.

Voir aussi ` labelBrush()`.

void QLegendMarker::setPen(const QPen &pen)

Définit l'pen utilisé pour dessiner le contour de l'icône sur pen.

Remarque : fonctionde définition de la propriété pen.

Voir aussi pen().

void QLegendMarker::setVisible(bool visible)

Définit la visibilité du marqueur sur « visible ».

Remarque : fonctionde définition pour la propriété visible.

Voir aussi ` isVisible()`.

[pure virtual] QLegendMarker::LegendMarkerType QLegendMarker::type()

Renvoie le type du marqueur de légende correspondant à la série, au secteur de camembert ou à l'ensemble de barres concerné.

Voir également LegendMarkerType.

[signal] void QLegendMarker::visibleChanged()

Ce signal est émis lorsque la visibilité du marqueur de légende a changé.

Remarque : signalde notification pour la propriété « visible ».

© 2026 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.