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.

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:
| @xPoint | El valor x del punto de datos |
| @yPoint | El 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.