- Qt 6.12
- 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.12`
In C++: | QLegend
Status: | Deprecated

This type is deprecated. We strongly advise against using it in new code.

- 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. For more information, see Using Legend Markers.

## 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.

### 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

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.