En esta página

QAreaSeries Class

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

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

Esta clase está obsoleta. Recomendamos encarecidamente no utilizarla en código nuevo.

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, de tal forma que el área entre las líneas delimitadoras se resalta con color. Dado que la serie de área se basa en la serie de líneas, el constructor de QAreaSeries necesita una instancia de QLineSeries, que define el límite superior del área. El gráfico de área se dibuja utilizando, por defecto, la parte inferior del área de trazado como límite inferior. 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 de ` QLineSeries `.

Nota: Los términos «límite superior» y «límite inferior» pueden resultar engañosos 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 límite.

Consulta la Galería de gráficos con widgets para aprender a crear un gráfico de área sencillo.

Captura de pantalla de un ejemplo de gráfico de áreas

Documentación de propiedades

borderColor : QColor

Esta propiedad contiene el color de la línea (lápiz) de la serie. Se trata de una propiedad de uso práctico que permite modificar el color del lápiz.

Funciones de acceso:

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

Señal de notificación:

void borderColorChanged(QColor color)

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

color : QColor

Esta propiedad contiene el color de relleno (pincel) de la serie. Se trata de una propiedad de uso práctico para modificar el color del pincel.

Funciones de acceso:

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

Señal de notificación:

void colorChanged(QColor color)

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

[read-only] lowerSeries : QLineSeries*

Esta propiedad contiene la serie de líneas inferior de las dos que se utilizan para definir los límites de las series de área.

Nota: Si se ha creado un objeto ` QAreaSeries ` sin una serie inferior (`lowerSeries`), este valor es nulo.

Funciones de acceso:

QLineSeries *lowerSeries() const

pointLabelsClipping : bool

Esta propiedad controla el recorte de las etiquetas de los puntos de datos. El valor predeterminado es «True». Las etiquetas situadas en el borde del área de representación se recortan cuando se activa el recorte.

Funciones de acceso:

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

Señal de notificación:

void pointLabelsClippingChanged(bool clipping)

Véase también pointLabelsVisible.

pointLabelsColor : QColor

Esta propiedad determina el color que se utiliza 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 de 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 de notificación:

void pointLabelsFontChanged(const QFont &font)

Véase también QAreaSeries::pointLabelsFormat.

pointLabelsFormat : QString

Esta propiedad define el formato que se utiliza para mostrar las etiquetas de los puntos de una serie.

QAreaSeries Admite las siguientes etiquetas de formato:

@xPointEl valor x del punto de datos
@yPointEl valor y del punto de datos

Por ejemplo, el siguiente uso de las etiquetas de formato generaría etiquetas en las que el punto de datos (x, y) aparecería entre paréntesis y separado por una coma:

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

Por defecto, el formato de las etiquetas está configurado como « @xPoint, @yPoint ». Las etiquetas se muestran en el área del gráfico, mientras que las que se encuentran en el borde de dicha área quedan cortadas. Si los puntos están muy próximos entre sí, las etiquetas pueden solaparse.

Funciones de acceso:

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

Señal de notificación:

void pointLabelsFormatChanged(const QString &format)

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

pointLabelsVisible : bool

Esta propiedad controla la visibilidad de las etiquetas de los puntos de datos. El valor predeterminado es «false».

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 línea superior de las dos series de líneas que se utilizan para definir los límites de las series de área.

Funciones de acceso:

QLineSeries *upperSeries() const

Documentación de las funciones de miembro

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

Crea un objeto de serie de área sin serie superior ni inferior mediante el objeto « parent ».

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

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

QAreaSeries no es propietaria de las series superior ni inferior, sino que la propiedad recae en quien realiza la llamada. Cuando el objeto de serie se añade a QChartView o QChart, se transfiere la propiedad de la instancia.

[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 (lápiz) cambia a color.

Nota: Señalde notificación 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 » al hacer clic en ella dentro de 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 (del pincel) cambia a color.

Nota: Señalde notificación para la propiedad « color ».

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

Esta señal se emite cuando el usuario realiza la primera pulsación en un gráfico de área 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 (coordenadas) del evento de paso del cursor. « state » es « true » cuando el cursor pasa por encima de la serie y pasa a ser «false» cuando se aleja de ella.

QPen QAreaSeries::pen() const

Devuelve el lápiz utilizado 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ñalde notificación para 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ñalde notificación 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ñalde notificación para la propiedad « pointLabelsFont ».

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

Esta señal se emite cuando se modifica la propiedad « format » de las etiquetas de los puntos de datos.

Nota: Señalde notificación 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ñalde notificación para la propiedad « pointLabelsVisible ».

bool QAreaSeries::pointsVisible() const

Devuelve si se han extraído los puntos 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 área.

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

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

Esta señal se emite cuando el usuario suelta un botón que se había pulsado en point en un gráfico de áreas.

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

void QAreaSeries::setBrush(const QBrush &brush)

Establece el objeto « brush » que se utiliza para rellenar el área.

Véase también brush().

void QAreaSeries::setLowerSeries(QLineSeries *series)

Establece el objeto « 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 objeto « pen » que se utiliza 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 representarse en la línea.

Véase también pointsVisible().

void QAreaSeries::setUpperSeries(QLineSeries *series)

Establece la variable « series » que se utilizará como serie superior del gráfico de área. Si la serie superior es nula, el gráfico de área 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 para 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.