Back to Qt.io
Contact Us Blog Download Qt
En esta página

QAreaSeries Class

La clase QAreaSeries presenta datos en gráficos de área. Más...

Cabecera: #include <QAreaSeries>
CMake: find_package(Qt6 REQUIRED COMPONENTS Graphs)
target_link_libraries(mytarget PRIVATE Qt6::Graphs)
qmake: QT += graphs
En QML: AreaSeries
Hereda: QAbstractSeries

Propiedades

Funciones públicas

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

Señales

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()

Descripción detallada

Un gráfico de área sirve para dibujar un área compuesta por puntos. Los puntos están definidos por dos series: upperSeries y lowerSeries. El área entre las series se dibuja como un gráfico. Si sólo se define upperSeries, el área se sitúa entre la parte inferior del gráfico y la serie superior.

Documentación de propiedades

borderColor : QColor

Esta propiedad contiene el color del borde del área. El valor por defecto es Qt::transparent, lo que significa que el color del borde está definido por el tema.

Funciones de acceso:

QColor borderColor() const
void setBorderColor(QColor newBorderColor)

Señal del notificador:

void borderColorChanged(QColor newBorderColor)

borderWidth : qreal

Esta propiedad contiene el ancho de la línea que encierra el área. El valor por defecto es -1, lo que significa que el ancho del borde viene definido por el tema.

Funciones de acceso:

qreal borderWidth() const
void setBorderWidth(qreal newBorderWidth)

Señal del notificador:

void borderWidthChanged()

color : QColor

Esta propiedad contiene el color de relleno del área. El valor por defecto es Qt::transparent, lo que significa que el color está definido por el tema.

Nota: Si gradient tiene un valor distinto de null, estos tendrán prioridad sobre color. En este caso se ignorará color.

Funciones de acceso:

QColor color() const
void setColor(QColor newColor)

Señal del notificador:

void colorChanged(QColor newColor)

[since 6.11] gradient : QQuickShapeGradient*

Esta propiedad define el gradiente de relleno. Por defecto no se activa ningún gradiente y el valor es null. En este caso el relleno se basará en la propiedad color.

Nota: Aquí no se puede utilizar el tipo Gradiente. En su lugar, prefiera utilizar uno de los subtipos avanzados, como LinearGradient.

Nota: Si se establece en algo distinto de null, la propiedad gradient tendrá prioridad sobre color.

Esta propiedad se introdujo en Qt 6.11.

Funciones de acceso:

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

Señal de notificador:

void gradientChanged(QQuickShapeGradient *newGradient)

lowerSeries : QXYSeries*

Establece el límite inferior del área. Si es nulo, el fondo del gráfico se considera el límite inferior.

Funciones de acceso:

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

Señal del notificador:

void lowerSeriesChanged()

selected : bool

Establece esta área como seleccionada. El valor por defecto es false.

Funciones de acceso:

bool isSelected() const
void setSelected(bool newSelected)

Señal de aviso:

void selectedChanged()

selectedBorderColor : QColor

Esta propiedad contiene el color del borde del área cuando se selecciona. El valor por defecto es Qt::transparent, lo que significa que el color del borde seleccionado está definido por el tema.

Funciones de acceso:

QColor selectedBorderColor() const
void setSelectedBorderColor(QColor newSelectedBorderColor)

Señal del notificador:

void selectedBorderColorChanged(QColor newSelectedBorderColor)

selectedColor : QColor

Esta propiedad contiene el color de relleno del área cuando se selecciona. El valor por defecto es Qt::transparent, lo que significa que el color seleccionado está definido por el tema.

Nota: Si selectedGradient tiene un valor distinto de null, estos tendrán prioridad sobre selectedColor. En este caso se ignorará selectedColor.

Funciones de acceso:

QColor selectedColor() const
void setSelectedColor(QColor newColor)

Señal del notificador:

void selectedColorChanged(QColor newSelectedColor)

[since 6.11] selectedGradient : QQuickShapeGradient*

Esta propiedad define el gradiente de relleno del área cuando se selecciona. Por defecto no se activa ningún gradiente y el valor es null. En este caso el relleno se basará en la propiedad selectedColor.

Nota: Aquí no se puede utilizar el tipo Gradiente. En su lugar, prefiera utilizar uno de los subtipos avanzados, como LinearGradient.

Nota: Si se establece en algo distinto de null, la propiedad selectedGradient tendrá prioridad sobre selectedColor.

Esta propiedad se introdujo en Qt 6.11.

Funciones de acceso:

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

Señal de notificador:

void selectedGradientChanged(QQuickShapeGradient *newGradient)

upperSeries : QXYSeries*

Establece el límite superior del área. Si es nulo, no se dibuja ningún área.

Funciones de acceso:

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

Señal del notificador:

void upperSeriesChanged()

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