QAbstractSeries Class
La clase QAbstractSeries es una clase base para todas las series de gráficos Qt. Más...
| Header: | #include <QAbstractSeries> |
| In QML: | AbstractSeries |
| Inherits: | QObject |
| Inherited By: | QAbstractBarSeries, QAreaSeries, QBoxPlotSeries, QCandlestickSeries, QPieSeries, and QXYSeries |
Tipos Públicos
| enum | SeriesType { SeriesTypeLine, SeriesTypeArea, SeriesTypeBar, SeriesTypeStackedBar, SeriesTypePercentBar, …, SeriesTypeCandlestick } |
Propiedades
Funciones públicas
| virtual | ~QAbstractSeries() |
| bool | attachAxis(QAbstractAxis *axis) |
| QList<QAbstractAxis *> | attachedAxes() |
| QChart * | chart() const |
| bool | detachAxis(QAbstractAxis *axis) |
| void | hide() |
| bool | isVisible() const |
| QString | name() const |
| qreal | opacity() const |
| void | setName(const QString &name) |
| void | setOpacity(qreal opacity) |
| void | setUseOpenGL(bool enable = true) |
| void | setVisible(bool visible = true) |
| void | show() |
| virtual QAbstractSeries::SeriesType | type() const = 0 |
| bool | useOpenGL() const |
Señales
| void | nameChanged() |
| void | opacityChanged() |
| void | useOpenGLChanged() |
| void | visibleChanged() |
Descripción detallada
Normalmente, las clases heredadas específicas del tipo de serie se utilizan en lugar de la clase base.
Véase también QXYSeries, QLineSeries, QSplineSeries, QScatterSeries, QAreaSeries, QAbstractBarSeries, QBarSeries, QStackedBarSeries, QPercentBarSeries, QHorizontalBarSeries, QHorizontalStackedBarSeries, QHorizontalPercentBarSeries, y QPieSeries.
Documentación de tipos de miembros
enum QAbstractSeries::SeriesType
Este enum describe el tipo de la serie.
| Constante | Valor | Descripción |
|---|---|---|
QAbstractSeries::SeriesTypeLine | 0 | Un gráfico de líneas. |
QAbstractSeries::SeriesTypeArea | 1 | Un gráfico de áreas. |
QAbstractSeries::SeriesTypeBar | 2 | Gráfico de barras verticales. |
QAbstractSeries::SeriesTypeStackedBar | 3 | Gráfico de barras verticales apiladas. |
QAbstractSeries::SeriesTypePercentBar | 4 | Gráfico de porcentaje vertical. |
QAbstractSeries::SeriesTypePie | 5 | Gráfico circular. |
QAbstractSeries::SeriesTypeScatter | 6 | Un gráfico de dispersión. |
QAbstractSeries::SeriesTypeSpline | 7 | Gráfico de splines. |
QAbstractSeries::SeriesTypeHorizontalBar | 8 | Un gráfico de barras horizontales. |
QAbstractSeries::SeriesTypeHorizontalStackedBar | 9 | Gráfico de barras horizontales apiladas. |
QAbstractSeries::SeriesTypeHorizontalPercentBar | 10 | Un gráfico de barras horizontales porcentuales. |
QAbstractSeries::SeriesTypeBoxPlot | 11 | Un gráfico de cajas. |
QAbstractSeries::SeriesTypeCandlestick | 12 | Un gráfico de velas. |
Documentación de propiedades
name : QString
Esta propiedad contiene el nombre de la serie.
El nombre se muestra en la leyenda de la serie y admite formato HTML.
Funciones de acceso:
| QString | name() const |
| void | setName(const QString &name) |
Señal del notificador:
| void | nameChanged() |
opacity : qreal
Esta propiedad contiene la opacidad de la serie.
Por defecto, la opacidad es 1.0. Los valores válidos van de 0.0 (transparente) a 1.0 (opaco).
Funciones de acceso:
| qreal | opacity() const |
| void | setOpacity(qreal opacity) |
Señal del notificador:
| void | opacityChanged() |
[read-only] type : SeriesType
Esta propiedad contiene el tipo de la serie.
Funciones de acceso:
| virtual QAbstractSeries::SeriesType | type() const = 0 |
useOpenGL : bool
Especifica si el dibujo de la serie se acelera o no utilizando OpenGL.
La aceleración mediante OpenGL sólo es compatible con QLineSeries y QScatterSeries. Una serie lineal utilizada como serie de borde para QAreaSeries no puede utilizar la aceleración OpenGL. Cuando un gráfico contiene cualquier serie que se dibuja con OpenGL, se crea un QOpenGLWidget transparente encima del área de trazado del gráfico. Las series aceleradas no se dibujan en el QGraphicsView subyacente, sino en el QOpenGLWidget creado.
El rendimiento obtenido al utilizar OpenGL para acelerar el dibujo de series depende del hardware subyacente, pero en la mayoría de los casos es significativo. Por ejemplo, en un ordenador de sobremesa estándar, habilitar la aceleración OpenGL para una serie permite normalmente renderizar al menos cien veces más puntos sin reducción en la tasa de fotogramas. El tamaño del gráfico también afecta menos a la velocidad de fotogramas.
La aceleración OpenGL del dibujo de series está pensada para casos de uso que necesitan un dibujo rápido de un gran número de puntos. Está optimizado para la eficiencia, y por lo tanto las series que lo utilizan carecen de soporte para muchas características disponibles para las series no aceleradas:
- Las animaciones de series no son compatibles con las series aceleradas.
- Las etiquetas de puntos no son compatibles con las series aceleradas.
- Los estilos de lápiz, las formas de marcador y los marcadores luminosos se ignoran en las series aceleradas. Sólo se admiten líneas sólidas y puntos de dispersión lisos. Los puntos de dispersión pueden ser circulares o rectangulares, dependiendo del hardware gráfico subyacente y de los controladores.
- Los gráficos polares no admiten series aceleradas.
- No se recomienda activar la sombra del gráfico o utilizar un color de fondo transparente cuando se utilizan series aceleradas, ya que esto puede ralentizar significativamente la velocidad de fotogramas.
Estas restricciones adicionales provienen del hecho de que las series aceleradas se dibujan en un widget separado encima del gráfico:
- Si dibuja cualquier elemento gráfico encima de un gráfico que contiene una serie acelerada, la serie acelerada se dibuja sobre esos elementos.
- Para que QOpenGLWidget sea parcialmente transparente, necesita estar apilado encima de todos los demás widgets. Esto significa que no puedes tener otros widgets cubriendo parcialmente el gráfico cuando uses series aceleradas.
- Las series aceleradas no son compatibles con los casos de uso en los que la escena gráfica tiene más de una vista gráfica adjunta.
- Las series aceleradas no son compatibles con los casos de uso en los que el gráfico tiene una geometría no predeterminada. Por ejemplo, si se añaden transformaciones a la vista de gráficos, las series aceleradas se dibujan en una posición incorrecta en relación con el gráfico.
El valor por defecto es false.
Funciones de acceso:
| bool | useOpenGL() const |
| void | setUseOpenGL(bool enable = true) |
Señal de notificador:
| void | useOpenGLChanged() |
visible : bool
Esta propiedad indica si la serie es visible o no.
Por defecto, true.
Funciones de acceso:
| bool | isVisible() const |
| void | setVisible(bool visible = true) |
Señal del notificador:
| void | visibleChanged() |
Documentación de la función miembro
[virtual noexcept] QAbstractSeries::~QAbstractSeries()
Destructor virtual de la serie de gráficos.
bool QAbstractSeries::attachAxis(QAbstractAxis *axis)
Adjunta el eje especificado por axis a la serie.
Devuelve true si el eje se ha conectado correctamente, false en caso contrario.
Nota: Si varios ejes de la misma orientación se adjuntan a la misma serie, tendrán los mismos valores mínimo y máximo.
Véase también QChart::addAxis() y QChart::createDefaultAxes().
QList<QAbstractAxis *> QAbstractSeries::attachedAxes()
Devuelve la lista de ejes adjuntos a la serie. Normalmente, se adjuntan un eje x y un eje y a una serie, excepto para QPieSeries, que no tiene ningún eje adjunto.
Véase también attachAxis() y detachAxis().
QChart *QAbstractSeries::chart() const
Devuelve el gráfico al que pertenece la serie.
Se establece automáticamente cuando la serie se añade al gráfico y se desactiva cuando la serie se elimina del gráfico.
bool QAbstractSeries::detachAxis(QAbstractAxis *axis)
Desacopla de la serie el eje especificado por axis.
Devuelve true si el eje se ha separado correctamente, false en caso contrario.
Véase también QChart::removeAxis().
void QAbstractSeries::hide()
Establece la visibilidad de la serie en false.
Véase también setVisible() y isVisible().
[signal] void QAbstractSeries::nameChanged()
Esta señal se emite cuando cambia el nombre de la serie.
Nota: Señal notificadora para la propiedad name.
[signal] void QAbstractSeries::opacityChanged()
Esta señal se emite cuando cambia la opacidad de la serie.
Nota: Señal notificadora para la propiedad opacity.
void QAbstractSeries::show()
Establece la visibilidad de la serie en true.
Véase también setVisible() y isVisible().
[signal] void QAbstractSeries::useOpenGLChanged()
Esta señal se emite cuando se activa o desactiva la aceleración del dibujo de las series mediante OpenGL.
Nota: Señal notificadora para la propiedad useOpenGL.
[signal] void QAbstractSeries::visibleChanged()
Esta señal se emite cuando cambia la visibilidad de la serie.
Nota: Señal notificadora para la propiedad visible.
© 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.
