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

Header: #include <QAreaSeries>
In QML: AreaSeries
Inherits: QAbstractSeries

Propiedades

Funciones públicas

QAreaSeries(QObject *parent = nullptr)
QAreaSeries(QLineSeries *upperSeries, QLineSeries *lowerSeries = nullptr)
virtual ~QAreaSeries()
QColor borderColor() const
QBrush brush() const
QColor color() const
QLineSeries *lowerSeries() const
QPen pen() const
bool pointLabelsClipping() const
QColor pointLabelsColor() const
QFont pointLabelsFont() const
QString pointLabelsFormat() const
bool pointLabelsVisible() const
bool pointsVisible() const
void setBorderColor(const QColor &color)
void setBrush(const QBrush &brush)
void setColor(const QColor &color)
void setLowerSeries(QLineSeries *series)
void setPen(const QPen &pen)
void setPointLabelsClipping(bool enabled = true)
void setPointLabelsColor(const QColor &color)
void setPointLabelsFont(const QFont &font)
void setPointLabelsFormat(const QString &format)
void setPointLabelsVisible(bool visible = true)
void setPointsVisible(bool visible = true)
void setUpperSeries(QLineSeries *series)
QLineSeries *upperSeries() const

Funciones públicas reimplementadas

virtual QAbstractSeries::SeriesType type() const override

Señales

void borderColorChanged(QColor color)
void clicked(const QPointF &point)
void colorChanged(QColor color)
void doubleClicked(const QPointF &point)
void hovered(const QPointF &point, bool state)
void pointLabelsClippingChanged(bool clipping)
void pointLabelsColorChanged(const QColor &color)
void pointLabelsFontChanged(const QFont &font)
void pointLabelsFormatChanged(const QString &format)
void pointLabelsVisibilityChanged(bool visible)
void pressed(const QPointF &point)
void released(const QPointF &point)

Descripción detallada

Una serie de área se utiliza para mostrar datos cuantitativos. Se basa en una serie de líneas, en el sentido de que el área entre las líneas límite se enfatiza con color. Dado que la serie de área se basa en la serie de líneas, el constructor QAreaSeries necesita una instancia QLineSeries, que define el límite superior del área. El gráfico de áreas se dibuja utilizando la parte inferior del área de trazado como límite inferior por defecto. En lugar de la parte inferior del área de trazado, el límite inferior puede especificarse mediante otra línea. En ese caso, QAreaSeries debe inicializarse con dos instancias QLineSeries.

Nota: Los términos límite superior e inferior pueden inducir a error en los casos en que el valor del límite inferior sea mayor que el del límite superior. Lo importante es que se rellenará el área comprendida entre estas dos líneas.

Consulte la Galería de Gráficos con Widgets para aprender a crear un gráfico de áreas sencillo.

Captura de pantalla de un ejemplo de areachart

Documentación de propiedades

borderColor : QColor

Esta propiedad contiene el color de la línea (pluma) de la serie. Es una propiedad de conveniencia para modificar el color de la pluma.

Funciones de acceso:

QColor borderColor() const
void setBorderColor(const QColor &color)

Señal del notificador:

void borderColorChanged(QColor color)

Véase también QAreaSeries::pen().

color : QColor

Esta propiedad contiene el color de relleno (pincel) de la serie. Es una propiedad de conveniencia para modificar el color del pincel.

Funciones de acceso:

QColor color() const
void setColor(const QColor &color)

Señal del notificador:

void colorChanged(QColor color)

Véase también QAreaSeries::brush().

[read-only] lowerSeries : QLineSeries*

Esta propiedad contiene la serie inferior de las dos series lineales utilizadas para definir los límites de las series de área.

Nota: Si QAreaSeries se construyó sin lowerSeries, esta propiedad es nula.

Funciones de acceso:

QLineSeries *lowerSeries() const

pointLabelsClipping : bool

Esta propiedad mantiene el recorte para las etiquetas de los puntos de datos. Verdadero por defecto. Las etiquetas en el borde del área del gráfico se cortan cuando el recorte está activado.

Funciones de acceso:

bool pointLabelsClipping() const
void setPointLabelsClipping(bool enabled = true)

Señal del notificador:

void pointLabelsClippingChanged(bool clipping)

Véase también pointLabelsVisible.

pointLabelsColor : QColor

Esta propiedad contiene el color utilizado para las etiquetas de los puntos de datos. Por defecto, el color es el del pincel definido para las etiquetas en el tema.

Funciones de acceso:

QColor pointLabelsColor() const
void setPointLabelsColor(const QColor &color)

Señal del notificador:

void pointLabelsColorChanged(const QColor &color)

Véase también QAreaSeries::pointLabelsFormat.

pointLabelsFont : QFont

Esta propiedad contiene la fuente utilizada para las etiquetas de los puntos de datos.

Funciones de acceso:

QFont pointLabelsFont() const
void setPointLabelsFont(const QFont &font)

Señal del notificador:

void pointLabelsFontChanged(const QFont &font)

Véase también QAreaSeries::pointLabelsFormat.

pointLabelsFormat : QString

Esta propiedad contiene el formato utilizado para mostrar etiquetas con puntos de series.

QAreaSeries Soporta las siguientes etiquetas de formato:

@xPuntoEl valor x del punto de datos
@yPuntoEl valor y del punto de datos

Por ejemplo, el siguiente uso de las etiquetas de formato produciría etiquetas que tienen el punto de datos (x, y) mostrado dentro de paréntesis separados por una coma:

series->setPointLabelsFormat("(@xPoint, @yPoint)");

Por defecto, el formato de la etiqueta se establece en @xPoint, @yPoint. Las etiquetas se muestran en el área de trazado, mientras que las etiquetas en el borde del área de trazado se cortan. Si los puntos están próximos entre sí, las etiquetas pueden solaparse.

Funciones de acceso:

QString pointLabelsFormat() const
void setPointLabelsFormat(const QString &format)

Señal notificadora:

void pointLabelsFormatChanged(const QString &format)

Véase también QAreaSeries::pointLabelsVisible, QAreaSeries::pointLabelsFont, y QAreaSeries::pointLabelsColor.

pointLabelsVisible : bool

Esta propiedad mantiene la visibilidad de las etiquetas de los puntos de datos. Falso por defecto.

Funciones de acceso:

bool pointLabelsVisible() const
void setPointLabelsVisible(bool visible = true)

Señal del notificador:

void pointLabelsVisibilityChanged(bool visible)

Véase también QAreaSeries::pointLabelsFormat y QAreaSeries::pointLabelsClipping.

[read-only] upperSeries : QLineSeries*

Esta propiedad contiene la superior de las dos series de líneas utilizadas para definir los límites de las series de áreas.

Funciones de acceso:

QLineSeries *upperSeries() const

Documentación de funciones miembro

[explicit] QAreaSeries::QAreaSeries(QObject *parent = nullptr)

Construye un objeto de serie de área sin serie superior o inferior con el objeto parent.

[explicit] QAreaSeries::QAreaSeries(QLineSeries *upperSeries, QLineSeries *lowerSeries = nullptr)

Construye un objeto de serie de área que se extenderá entre una línea upperSeries y una línea lowerSeries. Si no se pasa lowerSeries al constructor, se utiliza el eje x como límite inferior.

La QAreaSeries no es propietaria de la serie superior o inferior, sino que la propiedad permanece con el llamador. Cuando el objeto serie se añade a QChartView o QChart, la propiedad de la instancia se transfiere.

[virtual noexcept] QAreaSeries::~QAreaSeries()

Destruye el objeto.

[signal] void QAreaSeries::borderColorChanged(QColor color)

Esta señal se emite cuando el color de la línea (pluma) cambia a color.

Nota: Señal notificadora para la propiedad borderColor.

QBrush QAreaSeries::brush() const

Devuelve el pincel utilizado para dibujar la línea de esta serie.

Véase también setBrush().

[signal] void QAreaSeries::clicked(const QPointF &point)

Esta señal se emite cuando el usuario activa una pulsación en point haciendo clic en ella en un gráfico de áreas.

Véase también pressed, released, y doubleClicked.

[signal] void QAreaSeries::colorChanged(QColor color)

Esta señal se emite cuando el color de relleno (pincel) cambia a color.

Nota: Señal notificadora para la propiedad color.

[signal] void QAreaSeries::doubleClicked(const QPointF &point)

Esta señal se emite cuando el usuario activa la primera pulsación en un gráfico de áreas haciendo doble clic en point.

Véase también pressed, released, y clicked.

[signal] void QAreaSeries::hovered(const QPointF &point, bool state)

Esta señal se emite cuando el usuario pasa el cursor del ratón por encima de una serie o lo aleja de ella. point muestra el origen (coordenada) del evento hover. state es true cuando el cursor pasa por encima de la serie y se vuelve falso cuando se aleja de ella.

QPen QAreaSeries::pen() const

Devuelve la pluma utilizada para dibujar la línea de esta serie.

Véase también setPen().

[signal] void QAreaSeries::pointLabelsClippingChanged(bool clipping)

Esta señal se emite cuando el recorte de las etiquetas de los puntos de datos cambia a clipping.

Nota: Señal notificadora de la propiedad pointLabelsClipping.

[signal] void QAreaSeries::pointLabelsColorChanged(const QColor &color)

Esta señal se emite cuando el color utilizado para las etiquetas de los puntos de datos cambia a color.

Nota: Señal notificadora para la propiedad pointLabelsColor.

[signal] void QAreaSeries::pointLabelsFontChanged(const QFont &font)

Esta señal se emite cuando la fuente utilizada para las etiquetas de los puntos de datos cambia a font.

Nota: Señal notificadora para la propiedad pointLabelsFont.

[signal] void QAreaSeries::pointLabelsFormatChanged(const QString &format)

Esta señal se emite cuando se cambia el format de las etiquetas de los puntos de datos.

Nota: Señal notificadora para la propiedad pointLabelsFormat.

[signal] void QAreaSeries::pointLabelsVisibilityChanged(bool visible)

Esta señal se emite cuando la visibilidad de las etiquetas de los puntos de datos cambia a visible.

Nota: Señal notificadora para la propiedad pointLabelsVisible.

bool QAreaSeries::pointsVisible() const

Devuelve si los puntos están dibujados para esta serie.

Véase también setPointsVisible().

[signal] void QAreaSeries::pressed(const QPointF &point)

Esta señal se emite cuando el usuario pulsa el punto especificado por point en un gráfico de áreas.

Véase también clicked, released, y doubleClicked.

[signal] void QAreaSeries::released(const QPointF &point)

Esta señal se emite cuando el usuario suelta una pulsación que se activó en point en un gráfico de áreas.

Véase también pressed, clicked, y doubleClicked.

void QAreaSeries::setBrush(const QBrush &brush)

Establece el brush utilizado para rellenar el área.

Véase también brush().

void QAreaSeries::setLowerSeries(QLineSeries *series)

Establece la series que se utilizará como serie inferior del gráfico de áreas.

Véase también lowerSeries().

void QAreaSeries::setPen(const QPen &pen)

Establece el pen utilizado para dibujar el contorno del área.

Véase también pen().

void QAreaSeries::setPointsVisible(bool visible = true)

Determina si los puntos de datos son visible y deben dibujarse en la línea.

Véase también pointsVisible().

void QAreaSeries::setUpperSeries(QLineSeries *series)

Establece la series que se utilizará como serie superior del gráfico de áreas. Si la serie superior es nula, el gráfico de áreas no se dibuja, aunque tenga una serie inferior.

Véase también upperSeries().

[override virtual] QAbstractSeries::SeriesType QAreaSeries::type() const

Reimplementa una función de acceso a la propiedad: QAbstractSeries::type.

Devuelve QAbstractSeries::SeriesTypeArea.

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