QLegend Class
La classe QLegend affiche la légende d'un graphique. En savoir plus...
| Header: | #include <QLegend> |
| In QML: | Legend |
| Inherits: | QGraphicsWidget |
| Status: | Deprecated |
Cette classe est obsolète. Nous déconseillons fortement de l'utiliser dans du nouveau code.
Types publics
| enum | MarkerShape { MarkerShapeDefault, MarkerShapeRectangle, MarkerShapeCircle, MarkerShapeRotatedRectangle, MarkerShapeTriangle, …, MarkerShapeFromSeries } |
Propriétés
|
|
Fonctions publiques
| virtual | ~QLegend() |
| Qt::Alignment | alignment() const |
| void | attachToChart() |
| QColor | borderColor() |
| QBrush | brush() const |
| QColor | color() |
| void | detachFromChart() |
| QFont | font() const |
| bool | isAttachedToChart() |
| bool | isBackgroundVisible() const |
(since 6.2) bool | isInteractive() const |
| QBrush | labelBrush() const |
| QColor | labelColor() const |
| QLegend::MarkerShape | markerShape() const |
| QList<QLegendMarker *> | markers(QAbstractSeries *series = nullptr) const |
| QPen | pen() const |
| bool | reverseMarkers() |
| void | setAlignment(Qt::Alignment alignment) |
| void | setBackgroundVisible(bool visible = true) |
| void | setBorderColor(QColor color) |
| void | setBrush(const QBrush &brush) |
| void | setColor(QColor color) |
| void | setFont(const QFont &font) |
(since 6.2) void | setInteractive(bool interactive) |
| void | setLabelBrush(const QBrush &brush) |
| void | setLabelColor(QColor color) |
| void | setMarkerShape(QLegend::MarkerShape shape) |
| void | setPen(const QPen &pen) |
| void | setReverseMarkers(bool reverseMarkers = true) |
| void | setShowToolTips(bool show) |
| bool | showToolTips() const |
Signaux
(since 6.2) void | attachedToChartChanged(bool attached) |
| void | backgroundVisibleChanged(bool visible) |
| void | borderColorChanged(QColor color) |
| void | colorChanged(QColor color) |
| void | fontChanged(QFont font) |
| void | labelColorChanged(QColor color) |
| void | markerShapeChanged(QLegend::MarkerShape shape) |
| void | reverseMarkersChanged(bool reverseMarkers) |
| void | showToolTipsChanged(bool showToolTips) |
Description détaillée
Une légende est un objet graphique qui affiche la légende d'un graphique. L'état de la légende est mis à jour par QChart lorsque les séries changent. Par défaut, la légende est rattachée au graphique, mais elle peut être détachée pour la rendre indépendante de la mise en page du graphique. Les objets légende ne peuvent pas être créés ni supprimés, mais ils peuvent être référencés via la classe QChart.
Voir également QChart.
Documentation sur les types de membres
enum QLegend::MarkerShape
Cette énumération décrit la forme utilisée lors du rendu des éléments de la légende.
| Constante | Valeur | Description |
|---|---|---|
QLegend::MarkerShapeDefault | 0 | La forme par défaut déterminée par QLegend est utilisée pour le marqueur. Cette valeur n'est prise en charge que pour les éléments QLegendMarker individuels. |
QLegend::MarkerShapeRectangle | 1 | Des marqueurs rectangulaires sont utilisés. La taille du marqueur est déterminée par la taille de la police. |
QLegend::MarkerShapeCircle | 2 | Des marqueurs circulaires sont utilisés. La taille des marqueurs est déterminée par la taille de la police. |
QLegend::MarkerShapeRotatedRectangle | 4 | Des marqueurs en forme de rectangle pivoté sont utilisés. La taille du marqueur est déterminée par la taille de la police. |
QLegend::MarkerShapeTriangle | 5 | Des marqueurs triangulaires sont utilisés. La taille des marqueurs est déterminée par la taille de la police. |
QLegend::MarkerShapeStar | 6 | Des marqueurs en forme d’étoile sont utilisés. La taille du marqueur est déterminée par la taille de la police. |
QLegend::MarkerShapePentagon | 7 | Des marqueurs en forme de pentagone sont utilisés. La taille des marqueurs est déterminée par la taille de la police. |
QLegend::MarkerShapeFromSeries | 3 | La forme du marqueur est déterminée par la série. Dans le cas d’une série de nuages de points, le marqueur de la légende ressemble à un point du nuage et a la même taille que ce point. Dans le cas d’une série de lignes ou de splines, le marqueur de la légende ressemble à un petit segment de la ligne. Pour les autres types de séries, des marqueurs rectangulaires sont affichés. Si une « lightMarker » est spécifiée pour une série, l’ lightMarker sera affichée et sa taille sera déterminée par la taille du marqueur de la série. |
Voir également « markerShape ».
Documentation sur les propriétés
alignment : Qt::Alignment
Comment la légende est alignée par rapport au graphique.
Peut prendre les valeurs suivantes : Qt::AlignTop, Qt::AlignBottom, Qt::AlignLeft, Qt::AlignRight. Si vous définissez plusieurs indicateurs, le résultat n'est pas défini.
Fonctions d'accès :
| Qt::Alignment | alignment() const |
| void | setAlignment(Qt::Alignment alignment) |
backgroundVisible : bool
Cette propriété détermine si l'arrière-plan de la légende est visible.
Fonctions d'accès :
| bool | isBackgroundVisible() const |
| void | setBackgroundVisible(bool visible = true) |
Signal de notification :
| void | backgroundVisibleChanged(bool visible) |
borderColor : QColor
Cette propriété définit la couleur du trait de la légende.
Fonctions d'accès :
| QColor | borderColor() |
| void | setBorderColor(QColor color) |
Signal de notification :
| void | borderColorChanged(QColor color) |
color : QColor
Cette propriété définit la couleur d'arrière-plan (pinceau) de la légende.
Si vous modifiez la couleur de la légende, le style du pinceau de la légende est défini sur « Qt::SolidPattern ».
Fonctions d’accès :
| QColor | color() |
| void | setColor(QColor color) |
Signal de notification :
| void | colorChanged(QColor color) |
font : QFont
Cette propriété définit la police des marqueurs utilisés par la légende.
Fonctions d'accès :
| QFont | font() const |
| void | setFont(const QFont &font) |
Signal de notification :
| void | fontChanged(QFont font) |
labelColor : QColor
Cette propriété définit la couleur du pinceau utilisé pour dessiner les étiquettes.
Fonctions d'accès :
| QColor | labelColor() const |
| void | setLabelColor(QColor color) |
Signal de notification :
| void | labelColorChanged(QColor color) |
markerShape : MarkerShape
Forme par défaut des marqueurs de la légende. La valeur par défaut est « MarkerShapeRectangle ».
Fonctions d'accès :
| QLegend::MarkerShape | markerShape() const |
| void | setMarkerShape(QLegend::MarkerShape shape) |
Signal de notification :
| void | markerShapeChanged(QLegend::MarkerShape shape) |
reverseMarkers : bool
Cette propriété indique si l'ordre des marqueurs dans la légende est inversé.
Cette propriété est définie par défaut sur « false ».
Fonctions d'accès :
| bool | reverseMarkers() |
| void | setReverseMarkers(bool reverseMarkers = true) |
Signal de notification :
| void | reverseMarkersChanged(bool reverseMarkers) |
showToolTips : bool
Cette propriété détermine si les infobulles s'affichent lorsque le texte est tronqué.
Cette propriété est définie par défaut sur « false ».
Fonctions d’accès :
| bool | showToolTips() const |
| void | setShowToolTips(bool show) |
Signal de notification :
| void | showToolTipsChanged(bool showToolTips) |
Documentation des fonctions membres
[virtual noexcept] QLegend::~QLegend()
Supprime l'objet « légende ». La légende appartenant toujours à un QChart, une application ne doit en aucun cas appeler cette fonction.
void QLegend::attachToChart()
Ajoute la légende à un graphique. Le graphique peut modifier la mise en page de la légende.
[signal, since 6.2] void QLegend::attachedToChartChanged(bool attached)
Ce signal est émis lorsque la légende est « attached » ou «detached» du graphique.
Cette fonction a été introduite dans Qt 6.2.
[signal] void QLegend::backgroundVisibleChanged(bool visible)
Ce signal est émis lorsque la visibilité de l'arrière-plan de la légende passe à « visible ».
Remarque : signalde notification pour la propriété « backgroundVisible ».
[signal] void QLegend::borderColorChanged(QColor color)
Ce signal est émis lorsque la couleur de la bordure de l'arrière-plan de la légende passe à color.
Remarque : signalde notification pour la propriété borderColor.
QBrush QLegend::brush() const
Renvoie le pinceau utilisé par la légende.
Voir aussi setBrush().
[signal] void QLegend::colorChanged(QColor color)
Ce signal est émis lorsque la couleur d'arrière-plan de la légende passe à color.
Remarque : signalde notification pour la propriété color.
void QLegend::detachFromChart()
Détache la légende du graphique. Le graphique n'adaptera plus la mise en page de la légende.
[signal] void QLegend::fontChanged(QFont font)
Ce signal est émis lorsque la police des marqueurs de la légende passe à « font ».
Remarque : signalde notification pour la propriété font.
bool QLegend::isAttachedToChart()
Renvoie « true » si la légende est associée à un graphique.
bool QLegend::isBackgroundVisible() const
Renvoie la visibilité de l'arrière-plan de la légende.
Remarque : fonctiongetter pour la propriété backgroundVisible.
[since 6.2] bool QLegend::isInteractive() const
Indique si la légende peut être déplacée ou redimensionnée à l'aide de la souris lorsqu'elle est détachée.
Cette fonction a été introduite dans Qt 6.2.
Voir également QLegend::setInteractive().
QBrush QLegend::labelBrush() const
Renvoie le pinceau utilisé pour dessiner les étiquettes.
Voir aussi setLabelBrush().
[signal] void QLegend::labelColorChanged(QColor color)
Ce signal est émis lorsque la couleur du pinceau utilisé pour dessiner les étiquettes de la légende passe à color.
Remarque : signalde notification pour la propriété « labelColor ».
[signal] void QLegend::markerShapeChanged(QLegend::MarkerShape shape)
Ce signal est émis lorsque la forme des marqueurs de la légende passe à « shape ».
Remarque : signalde notification pour la propriété markerShape.
QList<QLegendMarker *> QLegend::markers(QAbstractSeries *series = nullptr) const
Renvoie la liste des marqueurs de la légende. Cette liste peut être filtrée en précisant l’ series e pour laquelle les marqueurs sont renvoyés.
QPen QLegend::pen() const
Renvoie le stylo utilisé par la légende.
Voir aussi setPen().
[signal] void QLegend::reverseMarkersChanged(bool reverseMarkers)
Ce signal est émis lorsque l'ordre inversé des marqueurs dans la légende est remplacé par « reverseMarkers ».
Remarque : signalde notification pour la propriété « reverseMarkers ».
void QLegend::setBackgroundVisible(bool visible = true)
Définit la visibilité de l'arrière-plan de la légende sur « visible ».
Remarque : fonctionde définition de la propriété backgroundVisible.
Voir aussi isBackgroundVisible().
void QLegend::setBrush(const QBrush &brush)
Définit l'brush utilisé pour dessiner l'arrière-plan de la légende.
Voir aussi brush().
[since 6.2] void QLegend::setInteractive(bool interactive)
Lorsque l'option « interactive » (Afficher la légende) est activée ( true ) et que la légende est détachée, celle-ci peut être déplacée et redimensionnée à l'aide de la souris, de la même manière qu'une fenêtre.
La légende se fixe automatiquement à un bord du graphique lorsque l'on la fait glisser hors de ce bord. Un double-clic sur une légende fixée permet de la détacher. C'est l'false par défaut.
Cette fonction a été introduite dans Qt 6.2.
Voir également QLegend::isInteractive().
void QLegend::setLabelBrush(const QBrush &brush)
Définit le pinceau utilisé pour dessiner les étiquettes de la légende sur brush.
Voir également labelBrush().
void QLegend::setPen(const QPen &pen)
Définit l'pen utilisé pour dessiner les bordures de la légende.
Voir aussi pen().
void QLegend::setShowToolTips(bool show)
Lorsque la propriété « show » est définie sur « true », les libellés de la légende affichent une info-bulle lorsque la souris passe dessus, si le libellé lui-même est affiché sous forme abrégée. Cette valeur est « false » par défaut.
Remarque : fonctionde définition de la propriété showToolTips.
Voir également showToolTips().
bool QLegend::showToolTips() const
Indique si les infobulles s'affichent pour les étiquettes de la légende lorsqu'elles sont tronquées.
Remarque : fonctiongetter pour la propriété showToolTips.
Voir aussi setShowToolTips().
[signal] void QLegend::showToolTipsChanged(bool showToolTips)
Ce signal est émis lorsque la visibilité des infobulles passe à « showToolTips ».
Remarque : signalde notification pour la propriété « showToolTips ».
© 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.
