QLegend Class
La classe QLegend affiche la légende d'un graphique. Plus d'informations...
| Header: | #include <QLegend> |
| In QML: | Legend |
| Inherits: | QGraphicsWidget |
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 attachée au graphique, mais elle peut être détachée pour la rendre indépendante de la disposition du graphique. Les objets de légende ne peuvent pas être créés ou 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 pour le rendu des marqueurs de légende.
| Constante | Valeur | Description de la forme |
|---|---|---|
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 individuels de QLegendMarker. |
QLegend::MarkerShapeRectangle | 1 | Les marqueurs rectangulaires sont utilisés. La taille du marqueur est déterminée par la taille de la police. |
QLegend::MarkerShapeCircle | 2 | Les marqueurs circulaires sont utilisés. La taille du marqueur est déterminée par la taille de la police. |
QLegend::MarkerShapeRotatedRectangle | 4 | Des marqueurs en forme de rectangle tourné 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 du marqueur 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 | Les marqueurs en forme de pentagone sont utilisés. La taille du marqueur 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 dispersée, le marqueur de légende ressemble à un point de dispersion et est de la même taille que le point. Dans le cas d'une série de lignes ou de splines, le marqueur de légende ressemble à un petit segment de la ligne. Pour les autres types de séries, des marqueurs rectangulaires sont affichés. Si un lightMarker est spécifié pour une série, le lightMarker sera affiché 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
La façon dont la légende est alignée sur le graphique.
Peut être Qt::AlignTop, Qt::AlignBottom, Qt::AlignLeft, Qt::AlignRight. Si vous activez plus d'un drapeau, le résultat est indéfini.
Fonctions d'accès :
| Qt::Alignment | alignment() const |
| void | setAlignment(Qt::Alignment alignment) |
backgroundVisible : bool
Cette propriété indique si l'arrière-plan de la légende est visible.
Fonctions d'accès :
| bool | isBackgroundVisible() const |
| void | setBackgroundVisible(bool visible = true) |
Signal du notificateur :
| void | backgroundVisibleChanged(bool visible) |
borderColor : QColor
Cette propriété définit la couleur de la ligne 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é contient la couleur d'arrière-plan (pinceau) de la légende.
Si vous modifiez la couleur de la légende, le style de la brosse 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é contient la police des marqueurs utilisés par la légende.
Fonctions d'accès :
| QFont | font() const |
| void | setFont(const QFont &font) |
Signal du notificateur :
| void | fontChanged(QFont font) |
labelColor : QColor
Cette propriété définit la couleur de la brosse utilisée pour dessiner les étiquettes.
Fonctions d'accès :
| QColor | labelColor() const |
| void | setLabelColor(QColor color) |
Signal du notificateur :
| void | labelColorChanged(QColor color) |
markerShape : MarkerShape
Forme par défaut des marqueurs de 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 inverse est utilisé pour les marqueurs de la légende.
Cette propriété est false par défaut.
Fonctions d'accès :
| bool | reverseMarkers() |
| void | setReverseMarkers(bool reverseMarkers = true) |
Signal de notification :
| void | reverseMarkersChanged(bool reverseMarkers) |
showToolTips : bool
Cette propriété indique si les infobulles sont affichées lorsque le texte est tronqué.
Cette propriété est false par défaut.
Fonctions d'accès :
| bool | showToolTips() const |
| void | setShowToolTips(bool show) |
Signal du notificateur :
| void | showToolTipsChanged(bool showToolTips) |
Member Function Documentation
[virtual noexcept] QLegend::~QLegend()
Détruit l'objet légende. La légende appartient toujours à QChart, de sorte qu'une application ne doit jamais appeler cette fonction.
void QLegend::attachToChart()
Attache la légende à un graphique. Le graphique peut adapter la disposition de la légende.
[signal, since 6.2] void QLegend::attachedToChartChanged(bool attached)
Ce signal est émis lorsque la légende est attached ou détachée 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.
Note : Signal de 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 devient color.
Note : Signal de notification pour la propriété borderColor.
QBrush QLegend::brush() const
Renvoie la brosse utilisée par la légende.
Voir aussi setBrush().
[signal] void QLegend::colorChanged(QColor color)
Ce signal est émis lorsque la couleur de l'arrière-plan de la légende devient color.
Note : Signal de notification pour la propriété color.
void QLegend::detachFromChart()
Détache la légende du graphique. Le graphique n'ajustera plus la disposition 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.
Note : Signal de notification pour la propriété font.
bool QLegend::isAttachedToChart()
Renvoie true, si la légende est attachée à un graphique.
bool QLegend::isBackgroundVisible() const
Renvoie la visibilité de l'arrière-plan de la légende.
Remarque : fonction Getter 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 aussi QLegend::setInteractive().
QBrush QLegend::labelBrush() const
Renvoie la brosse utilisée pour dessiner les étiquettes.
Voir aussi setLabelBrush().
[signal] void QLegend::labelColorChanged(QColor color)
Ce signal est émis lorsque la couleur de la brosse utilisée pour dessiner les étiquettes de la légende devient color.
Note : Signal de notification pour la propriété labelColor.
QList<QLegendMarker *> QLegend::markers(QAbstractSeries *series = nullptr) const
Renvoie la liste des marqueurs de la légende. La liste peut être filtrée en spécifiant le site series pour lequel les marqueurs sont retourné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'utilisation de l'ordre inverse pour les marqueurs de la légende est modifiée en reverseMarkers.
Note : Signal de notification pour la propriété reverseMarkers.
void QLegend::setBackgroundVisible(bool visible = true)
Fixe la visibilité de l'arrière-plan de la légende à visible.
Remarque : fonction de définition de la propriété backgroundVisible.
Voir également isBackgroundVisible().
void QLegend::setBrush(const QBrush &brush)
Définit le site brush utilisé pour dessiner l'arrière-plan de la légende.
Voir également brush().
[since 6.2] void QLegend::setInteractive(bool interactive)
Lorsque interactive est true et que la légende est détachée, la légende 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 s'attache automatiquement à un bord du graphique en la faisant glisser à partir de ce bord. Un double clic sur une légende attachée la détache. Cette fonction est disponible à l'adresse 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 la brosse utilisée pour dessiner les étiquettes de la légende à brush.
Voir aussi labelBrush().
void QLegend::setPen(const QPen &pen)
Définit le site pen utilisé pour dessiner les bordures de la légende.
Voir également pen().
void QLegend::setShowToolTips(bool show)
Lorsque show est true, les étiquettes de la légende afficheront une infobulle lorsque la souris les survolera si l'étiquette elle-même est affichée sous forme élidée. La valeur par défaut est false.
Remarque : fonction de définition de la propriété showToolTips.
Voir également showToolTips().
bool QLegend::showToolTips() const
Retourne si les infobulles sont affichées pour les étiquettes de la légende lorsqu'elles sont élidées.
Remarque : fonction Getter pour la propriété showToolTips.
Voir également setShowToolTips().
[signal] void QLegend::showToolTipsChanged(bool showToolTips)
Ce signal est émis lorsque la visibilité des infobulles passe à showToolTips.
Note : Signal de 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.
