QAbstractSeries Class
La clase `QAbstractSeries` es una clase base para todas las series de Qt Charts. Más información...
| Header: | #include <QAbstractSeries> |
| In QML: | AbstractSeries |
| Inherits: | QObject |
| Inherited By: | QAbstractBarSeries, QAreaSeries, QBoxPlotSeries, QCandlestickSeries, QPieSeries, and QXYSeries |
| Status: | Deprecated |
Esta clase está obsoleta. Recomendamos encarecidamente no utilizarla en código nuevo.
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, se utilizan las clases heredadas específicas del tipo de serie 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 sobre los tipos de miembros
enum QAbstractSeries::SeriesType
Esta enumeración 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 | Un gráfico de barras verticales. |
QAbstractSeries::SeriesTypeStackedBar | 3 | Un gráfico de barras apiladas verticales. |
QAbstractSeries::SeriesTypePercentBar | 4 | Un gráfico de barras verticales con porcentajes. |
QAbstractSeries::SeriesTypePie | 5 | Un gráfico circular. |
QAbstractSeries::SeriesTypeScatter | 6 | Un gráfico de dispersión. |
QAbstractSeries::SeriesTypeSpline | 7 | Un gráfico de splines. |
QAbstractSeries::SeriesTypeHorizontalBar | 8 | Un gráfico de barras horizontal. |
QAbstractSeries::SeriesTypeHorizontalStackedBar | 9 | Un gráfico de barras apiladas horizontales. |
QAbstractSeries::SeriesTypeHorizontalPercentBar | 10 | Un gráfico de barras horizontales con porcentajes. |
QAbstractSeries::SeriesTypeBoxPlot | 11 | Un diagrama de caja. |
QAbstractSeries::SeriesTypeCandlestick | 12 | Un gráfico de velas. |
Documentación de la propiedad
name : QString
Esta propiedad contiene el nombre de la serie.
El nombre aparece en la leyenda de la serie y admite formato HTML.
Funciones de acceso:
| QString | name() const |
| void | setName(const QString &name) |
Señal de notificación:
| void | nameChanged() |
opacity : qreal
Esta propiedad define 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 de notificación:
| 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 mediante OpenGL.
La aceleración mediante OpenGL solo es compatible con QLineSeries y QScatterSeries. Una serie de líneas utilizada como serie de bordes para QAreaSeries no puede utilizar la aceleración mediante OpenGL. Cuando un gráfico contiene alguna serie que se dibuja con OpenGL, se crea un QOpenGLWidget transparente sobre el área de trazado del gráfico. Las series aceleradas no se dibujan en el QGraphicsView subyacente, sino que se dibujan 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 suele permitir renderizar al menos cien veces más puntos sin reducir la frecuencia de fotogramas. El tamaño del gráfico también tiene menos efecto sobre la frecuencia de fotogramas.
La aceleración OpenGL del dibujo de series está pensada para casos de uso que requieren un dibujo rápido de un gran número de puntos. Está optimizada para la eficiencia y, por lo tanto, las series que la utilizan carecen de compatibilidad con 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 trazo, las formas de los marcadores y los marcadores ligeros se ignoran en las series aceleradas. Solo se admiten líneas continuas y puntos de dispersión sencillos. Los puntos de dispersión pueden ser circulares o rectangulares, dependiendo del hardware gráfico y los controladores subyacentes.
- Los gráficos polares no admiten series aceleradas.
- No se recomienda habilitar la sombra proyectada del gráfico ni utilizar un color de fondo transparente cuando se utilizan series aceleradas, ya que esto puede reducir significativamente la velocidad de actualización.
Estas restricciones adicionales se deben a que la serie acelerada se dibuja en un control independiente situado encima del gráfico:
- Si se dibujan elementos gráficos sobre un gráfico que contenga una serie acelerada, la serie acelerada se dibuja sobre dichos elementos.
- Para que QOpenGLWidget sea parcialmente transparente, debe apilarse encima de todos los demás widgets. Esto significa que no puedes tener otros widgets que cubran parcialmente el gráfico cuando utilices series aceleradas.
- Las series aceleradas no son compatibles con casos de uso en los que la escena gráfica tenga más de una vista gráfica asociada.
- Las series aceleradas no son compatibles con casos de uso en los que el gráfico tenga una geometría no predeterminada. Por ejemplo, añadir transformaciones a la vista gráfica hace que las series aceleradas se dibujen en una posición incorrecta con respecto al gráfico.
El valor por defecto es false.
Funciones de acceso:
| bool | useOpenGL() const |
| void | setUseOpenGL(bool enable = true) |
Señal de notificación:
| void | useOpenGLChanged() |
visible : bool
Esta propiedad indica si la serie está 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 para la serie del gráfico.
bool QAbstractSeries::attachAxis(QAbstractAxis *axis)
Adjunta a la serie el eje especificado por axis.
Devuelve ` true ` si el eje se ha añadido correctamente; en caso contrario, devuelve ` false `.
Nota: Si se añaden varios ejes con la misma orientación a una 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 asociados a la serie. Normalmente, a una serie se le asocian un eje x y un eje y, salvo en el caso de QPieSeries, que no tiene ningún eje asociado.
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 se añade la serie al gráfico y se desactiva cuando se elimina la serie del gráfico.
bool QAbstractSeries::detachAxis(QAbstractAxis *axis)
Separa el eje especificado por axis de la serie.
Devuelve true si el eje se ha separado correctamente; en caso contrario, devuelve false.
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ñalde notificación para la propiedad « name ».
[signal] void QAbstractSeries::opacityChanged()
Esta señal se emite cuando cambia la opacidad de la serie.
Nota: Señalde notificación 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 la serie mediante OpenGL.
Nota: Señalde notificación para la propiedad « useOpenGL ».
[signal] void QAbstractSeries::visibleChanged()
Esta señal se emite cuando cambia la visibilidad de la serie.
Nota: Señalde notificación 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.