Sur cette page

Legend QML Type

Affiche la légende d'un graphique. En savoir plus...

Import Statement: import QtCharts 2.12
In C++: QLegend
Status: Deprecated

Ce type est obsolète. Nous vous déconseillons fortement de l'utiliser dans du nouveau code.

Propriétés

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 le type « ChartView » lorsque les séries changent. Les propriétés du type « Legend » peuvent être associées au type « ChartView ». Par exemple :

ChartView {
    legend.visible: true
    legend.alignment: Qt.AlignBottom
    // Add a few series...
}

Capture d'écran ne montrant que les légendes d'un graphique à barres flou

Remarque : il n’existe pas d’API QML permettant de modifier les marqueurs de légende. Les marqueurs peuvent être modifiés en créant une légende personnalisée. Pour plus d’informations, consultez la section Utilisation des marqueurs de légende.

Documentation sur les propriétés

alignment : alignment

Définit l'alignement de la légende par rapport au graphique. Peut prendre les valeurs suivantes : « Qt.AlignLeft », « Qt.AlignRight », « Qt.AlignBottom » ou « Qt.AlignTop ». Si vous définissez plusieurs indicateurs, le résultat n'est pas défini.

backgroundVisible : bool

Si l'arrière-plan de la légende est visible.

borderColor : color

La couleur des lignes de la légende.

color : color

La couleur d'arrière-plan (au pinceau) de la légende.

font : Font

La police des repères utilisés dans la légende.

labelColor : color

La couleur du pinceau utilisé pour dessiner les étiquettes.

markerShape : enumeration

Forme par défaut des marqueurs de la légende. La valeur par défaut est « MarkerShapeRectangle ».

ConstanteDescription
Legend.MarkerShapeRectangleLes marqueurs de légende sont rectangulaires
Legend.MarkerShapeCircleLes marqueurs de légende sont circulaires
MarkerShapeRotatedRectangleLes marqueurs de légende sont des rectangles pivotés.
MarkerShapeTriangleLes marqueurs de légende sont triangulaires.
MarkerShapeStarLes marqueurs de légende sont en forme d'étoile.
MarkerShapePentagonLes marqueurs de légende sont en forme de pentagone.
Legend.MarkerShapeFromSeriesLa forme des marqueurs de légende est déterminée par la série

Voir également QLegend::MarkerShape.

reverseMarkers : bool

Indique si l'ordre des marqueurs dans la légende est inversé. Cette propriété est définie par défaut sur « false ».

showToolTips : bool

Détermine si les infobulles s'affichent lorsque le texte est tronqué. Cette propriété est définie par défaut sur « false ». Elle n'a actuellement aucun effet, car les infobulles ne sont pas prises en charge dans QML.

visible : bool

Indique si la légende est visible.

Par défaut, cette propriété est définie sur « true ».

Voir également « QGraphicsObject::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.