- Qt 6.4
- Qt Charts
- QML Types
- Legend
- Qt Charts | Commercial or GPLv3

# Legend QML Type

Displays the legend of a chart. More...

Import Statement: | import QtCharts 2.4

- List of all members, including inherited members

## Properties

- alignment : alignment
- backgroundVisible : bool
- borderColor : color
- color : color
- font : Font
- labelColor : color
- markerShape : enumeration
- reverseMarkers : bool
- showToolTips : bool
- visible : bool

## Detailed Description

A legend is a graphical object that displays the legend of a chart. The legend state is updated by the ChartView type when series change. The Legend type properties can be attached to the ChartView type. For example:

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

Note: There is no QML API available for modifying legend markers. Markers can be modified by creating a custom legend, as illustrated by Qml Custom Example.

## Property Documentation

alignment : alignment

Defines how the legend is aligned with the chart. Can be Qt.AlignLeft, Qt.AlignRight, Qt.AlignBottom, or Qt.AlignTop. If you set more than one flag, the result is undefined.

backgroundVisible : bool

Whether the legend background is visible.

borderColor : color

The line color of the legend.

color : color

The background (brush) color of the legend.

font : Font

The font of the markers used by the legend.

labelColor : color

The color of the brush used to draw labels.

[since 5.9] markerShape : enumeration

The default shape of the legend markers. The default value is `MarkerShapeRectangle`.

Constant | Description
--- | ---
`Legend.MarkerShapeRectangle` | Legend markers are rectangular
`Legend.MarkerShapeCircle` | Legend markers are circular
`MarkerShapeRotatedRectangle` | Legend markers are rotated rectangle shaped.
`MarkerShapeTriangle` | Legend markers are triangular.
`MarkerShapeStar` | Legend markers are star shaped.
`MarkerShapePentagon` | Legend markers are pentagon shaped.
`Legend.MarkerShapeFromSeries` | Legend marker shape is determined by the series

This property was introduced in Qt 5.9.

See also QLegend::MarkerShape.

reverseMarkers : bool

Whether reverse order is used for the markers in the legend. This property is `false` by default.

showToolTips : bool

Whether tooltips are shown when the text is truncated. This property is `false` by default. This property currently has no effect as there is no support for tooltips in QML.

visible : bool

Whether the legend is visible.

By default, this property is `true`.

See also QGraphicsObject::visible.