- Qt 6.12
- Qt Graphs
- C++ Classes
- QtGraphs
- QAreaSeries
- Qt Graphs | Commercial or GPLv3

# QAreaSeries Class

The QAreaSeries class presents data in area graphs. More...

Header: | `#include <QAreaSeries>`
CMake: | `find_package(Qt6 REQUIRED COMPONENTS Graphs)` `target_link_libraries(mytarget PRIVATE Qt6::Graphs)`
qmake: | `QT += graphs`
In QML: | AreaSeries
Inherits: | QAbstractSeries

- List of all members, including inherited members
- QAreaSeries is part of Qt Graphs C++ Classes for 2D.

## Properties

borderColor : QColor borderWidth : qreal color : QColor `(since 6.11)` gradient : QQuickShapeGradient* lowerSeries : QXYSeries* | selected : bool selectedBorderColor : QColor selectedColor : QColor `(since 6.11)` selectedGradient : QQuickShapeGradient* upperSeries : QXYSeries*

## Public Functions

QColor | borderColor() const
qreal | borderWidth() const
QColor | color() const
QQuickShapeGradient * | gradient() const
bool | isSelected() const
QXYSeries * | lowerSeries() const
QColor | selectedBorderColor() const
QColor | selectedColor() const
QQuickShapeGradient * | selectedGradient() const
void | setBorderColor(QColor newBorderColor)
void | setBorderWidth(qreal newBorderWidth)
void | setColor(QColor newColor)
void | setGradient(QQuickShapeGradient *newGradient)
void | setLowerSeries(QXYSeries *newLowerSeries)
void | setSelected(bool newSelected)
void | setSelectedBorderColor(QColor newSelectedBorderColor)
void | setSelectedColor(QColor newColor)
void | setSelectedGradient(QQuickShapeGradient *newSelectedGradient)
void | setUpperSeries(QXYSeries *newUpperSeries)
QXYSeries * | upperSeries() const

## Signals

void | borderColorChanged(QColor newBorderColor)
void | borderWidthChanged()
void | colorChanged(QColor newColor)
void | gradientChanged(QQuickShapeGradient *newGradient)
void | lowerSeriesChanged()
void | selectedBorderColorChanged(QColor newSelectedBorderColor)
void | selectedChanged()
void | selectedColorChanged(QColor newSelectedColor)
void | selectedGradientChanged(QQuickShapeGradient *newGradient)
void | upperSeriesChanged()

## Detailed Description

An area graph is used to draw an area composed by points. The points are defined by two series: upperSeries and lowerSeries. The area between the series is drawn as a graph. If only the upperSeries is defined, the area is then between the bottom of the graph and the upper series.

## Property Documentation

### borderColor : QColor

This property holds the border color of the area. The default value is `Qt::transparent`, meaning the border color is defined by the theme.

Access functions:

QColor | borderColor() const
void | setBorderColor(QColor newBorderColor)

Notifier signal:

void | borderColorChanged(QColor newBorderColor)

### borderWidth : qreal

This property holds the width of the line that encloses the area. The default value is `-1`, meaning the border width is defined by the theme.

Access functions:

qreal | borderWidth() const
void | setBorderWidth(qreal newBorderWidth)

Notifier signal:

void | borderWidthChanged()

### color : QColor

This property holds the fill color of the area. The default value is `Qt::transparent`, meaning the color is defined by the theme.

Note: If gradient is set to something other than `null`, these will take precedence over `color`. The `color` will be ignored in this case.

Access functions:

QColor | color() const
void | setColor(QColor newColor)

Notifier signal:

void | colorChanged(QColor newColor)

### `[since 6.11]` gradient : QQuickShapeGradient*

This property defines the fill gradient. By default no gradient is enabled and the value is `null`. In this case the fill will be based on the color property.

Note: The Gradient type cannot be used here. Rather, prefer using one of the advanced subtypes, like LinearGradient.

Note: If set to something other than `null`, the `gradient` will take precedence over color.

This enumeration was introduced in Qt 6.11.

Access functions:

QQuickShapeGradient * | gradient() const
void | setGradient(QQuickShapeGradient *newGradient)

Notifier signal:

void | gradientChanged(QQuickShapeGradient *newGradient)

### lowerSeries : QXYSeries*

Sets the lower boundary of the area. If this is null, the graph bottom is considered the lower bound.

Access functions:

QXYSeries * | lowerSeries() const
void | setLowerSeries(QXYSeries *newLowerSeries)

Notifier signal:

void | lowerSeriesChanged()

### selected : bool

Sets this area as selected. The default value is `false`.

Access functions:

bool | isSelected() const
void | setSelected(bool newSelected)

Notifier signal:

void | selectedChanged()

### selectedBorderColor : QColor

This property holds the border color of the area when selected. The default value is `Qt::transparent`, meaning the selected border color is defined by the theme.

Access functions:

QColor | selectedBorderColor() const
void | setSelectedBorderColor(QColor newSelectedBorderColor)

Notifier signal:

void | selectedBorderColorChanged(QColor newSelectedBorderColor)

### selectedColor : QColor

This property holds the fill color of the area when selected. The default value is `Qt::transparent`, meaning the selected color is defined by the theme.

Note: If selectedGradient is set to something other than `null`, these will take precedence over `selectedColor`. The `selectedColor` will be ignored in this case.

Access functions:

QColor | selectedColor() const
void | setSelectedColor(QColor newColor)

Notifier signal:

void | selectedColorChanged(QColor newSelectedColor)

### `[since 6.11]` selectedGradient : QQuickShapeGradient*

This property defines the fill gradient of the area when selected. By default no gradient is enabled and the value is `null`. In this case the fill will be based on the selectedColor property.

Note: The Gradient type cannot be used here. Rather, prefer using one of the advanced subtypes, like LinearGradient.

Note: If set to something other than `null`, the `selectedGradient` will take precedence over selectedColor.

This enumeration was introduced in Qt 6.11.

Access functions:

QQuickShapeGradient * | selectedGradient() const
void | setSelectedGradient(QQuickShapeGradient *newSelectedGradient)

Notifier signal:

void | selectedGradientChanged(QQuickShapeGradient *newGradient)

### upperSeries : QXYSeries*

Sets the upper boundary of the area. No area is drawn if this is null.

Access functions:

QXYSeries * | upperSeries() const
void | setUpperSeries(QXYSeries *newUpperSeries)

Notifier signal:

void | upperSeriesChanged()