En esta página

QAbstractSeries Class

La clase `QAbstractSeries` es una clase base para todas las clases derivadas de ` Qt Graphs ` destinadas a series 2D. Más información...

Encabezado: #include <QAbstractSeries>
CMake: find_package(Qt6 REQUIRED COMPONENTS Graphs)
target_link_libraries(mytarget PRIVATE Qt6::Graphs)
qmake: QT += graphs
En QML: AbstractSeries
Heredan de:QObject y QQmlParserStatus
Heredado por:

QAreaSeries, QBarSeries, QCustomSeries, QPieSeries y QXYSeries

Tipos públicos

enum class SeriesType { Line, Bar, Scatter, Pie, Spline, …, Custom }

Propiedades

Funciones públicas

virtual ~QAbstractSeries() override
QAbstractAxis *axisX() const
QAbstractAxis *axisY() const
void hide()
bool isHoverable() const
bool isHovered() const
bool isSelectable() const
bool isVisible() const
const QList<QLegendData> legendData() const
QString name() const
qreal opacity() const
QQmlListProperty<QObject> seriesChildren()
void setAxisX(QAbstractAxis *newAxisX)
void setAxisY(QAbstractAxis *newAxisY)
void setHoverable(bool newHoverable)
void setName(const QString &name)
void setOpacity(qreal opacity)
void setSelectable(bool selectable)
void setValuesMultiplier(qreal valuesMultiplier)
void setVisible(bool visible = true)
void setZValue(int newDrawOrder)
void show()
virtual QAbstractSeries::SeriesType type() const = 0
qreal valuesMultiplier() const
int zValue() const

Señales

void axisXChanged(QAbstractAxis *newAxis)
void axisYChanged(QAbstractAxis *newAxis)
void hover(const QString &seriesName, QPointF position, QPointF value)
void hoverEnter(const QString &seriesName, QPointF position, QPointF value)
void hoverExit(const QString &seriesName, QPointF position)
void hoverableChanged()
void hoveredChanged(bool hovered)
void legendDataChanged()
void nameChanged()
void opacityChanged()
void selectableChanged()
void valuesMultiplierChanged()
void visibleChanged()
void zValueChanged(int z)

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 QLineSeries, QSplineSeries, QScatterSeries, QBarSeries y QXYSeries.

Documentación sobre los tipos de miembro

enum class QAbstractSeries::SeriesType

Esta enumeración describe el tipo de la serie.

ConstanteValorDescripción
QAbstractSeries::SeriesType::Line0Un gráfico de líneas.
QAbstractSeries::SeriesType::Bar2Un gráfico de barras.
QAbstractSeries::SeriesType::Scatter4Un gráfico de dispersión.
QAbstractSeries::SeriesType::Pie3Un gráfico circular.
QAbstractSeries::SeriesType::Spline5Un gráfico de splines.
QAbstractSeries::SeriesType::Area1Un gráfico de área.
QAbstractSeries::SeriesType::Custom6Un gráfico personalizado.

Documentación de propiedades

[since 6.10] axisX : QAbstractAxis*

Eje X de esta serie.

El eje x utilizado para esta serie. Crea un eje independiente del definido en GraphsView, lo que permite al usuario visualizar varios ejes por gráfico.

Esta enumeración se introdujo en Qt 6.10.

Funciones de acceso:

QAbstractAxis *axisX() const
void setAxisX(QAbstractAxis *newAxisX)

Señal del notificador:

void axisXChanged(QAbstractAxis *newAxis)

[since 6.10] axisY : QAbstractAxis*

Eje Y de esta serie.

El eje Y utilizado para esta serie. Crea un eje independiente del definido en GraphsView, lo que permite al usuario visualizar varios ejes por gráfico.

Esta enumeración se introdujo en Qt 6.10.

Funciones de acceso:

QAbstractAxis *axisY() const
void setAxisY(QAbstractAxis *newAxisY)

Señal de notificador:

void axisYChanged(QAbstractAxis *newAxis)

hoverable : bool

Determina si se puede pasar el cursor por encima de la serie.

Controla si se puede pasar el cursor por encima de la serie con el ratón o mediante el tacto. Por defecto, « hoverable » está configurado en « false ».

Funciones de acceso:

bool isHoverable() const
void setHoverable(bool newHoverable)

Señal de notificación:

void hoverableChanged()

[read-only] hovered : bool

Comprueba si el cursor se encuentra sobre una serie.

Se puede utilizar para comprobar si el ratón o el dedo se encuentra actualmente sobre una serie.

Funciones de acceso:

bool isHovered() const

Señal de notificador:

void hoveredChanged(bool hovered)

Véase también QAbstractSeries ::hovered.

[read-only] legendData : QList<QLegendData>

Contiene la información necesaria para crear un marcador de leyenda para un conjunto de datos en un gráfico.

Funciones de acceso:

const QList<QLegendData> legendData() const

Señal de notificación:

void legendDataChanged()

Véase también QLegendData.

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()

selectable : bool

Determina si la serie se puede seleccionar.

Determina si la serie se puede seleccionar con el ratón o mediante el tacto. Por defecto, « selectable » está configurado como « false ».

Funciones de acceso:

bool isSelectable() const
void setSelectable(bool selectable)

Señal de notificación:

void selectableChanged()

[read-only] seriesChildren : const QQmlListProperty<QObject>

La lista de objetos hijos de la serie. Se trata de una propiedad predeterminada que permite especificar objetos hijos dentro de un elemento de serie en QML sin necesidad de utilizar explícitamente el nombre de la propiedad «children».

Funciones de acceso:

QQmlListProperty<QObject> seriesChildren()

[read-only] type : const SeriesType

Esta propiedad indica el tipo de la serie.

Funciones de acceso:

virtual QAbstractSeries::SeriesType type() const = 0

valuesMultiplier : qreal

Controla el valor visible efectivo de los valores de la serie.

Esta variable se puede utilizar para animar los valores de la serie de modo que se escalen desde 0 hasta el tamaño real del valor. Por defecto, el valor de valuesMultiplier es 1,0. Los valores válidos oscilan entre 0,0 (altura 0) y 1,0 (valor completo).

Funciones de acceso:

qreal valuesMultiplier() const
void setValuesMultiplier(qreal valuesMultiplier)

Señal de notificación:

void valuesMultiplierChanged()

visible : bool

Visibilidad de la serie.

La visibilidad aplicada a esta serie. Por defecto, « visible » está configurado en « true ».

Funciones de acceso:

bool isVisible() const
void setVisible(bool visible = true)

Señal de notificación:

void visibleChanged()

[since 6.10] zValue : int

Controla el orden en el que se dibuja la serie

La lista de series de GraphsView se ordena según la propiedad zValue. Dado que cada tipo de serie se representa de una sola vez, el orden funciona principalmente como un orden interno de cada tipo de serie. El valor zValue más alto de cada tipo de serie determina el orden de representación entre los distintos tipos de serie. El valor por defecto es 0.

Esta enumeración se introdujo en Qt 6.10.

Funciones de acceso:

int zValue() const
void setZValue(int newDrawOrder)

Señal del notificador:

void zValueChanged(int z)

Documentación de las funciones miembro

[override virtual noexcept] QAbstractSeries::~QAbstractSeries()

Destructor virtual para la serie de grafos.

void QAbstractSeries::hide()

Establece la visibilidad de la serie en « false ».

Véase también setVisible() y isVisible().

[signal] void QAbstractSeries::hover(const QString &seriesName, QPointF position, QPointF value)

Esta señal se emite cuando cambia la serie sobre la que se pasa el cursor. El nombre de la serie se encuentra en seriesName, la posición del ratón o del toque en position y el valor de la serie en value.

Nota: Esta señal solo se emite cuando hoverable está establecido en «true».

Nota: En el caso del gráfico circular, el valor representa (ángulo de posición, ángulo inicial de la porción sobre la que se pasa el cursor).

[signal] void QAbstractSeries::hoverEnter(const QString &seriesName, QPointF position, QPointF value)

Esta señal se emite cuando comienza el desplazamiento sobre la serie. El nombre de la serie se encuentra en seriesName, la posición del ratón o del tacto en position y el valor de la serie en value.

Nota: Esta señal solo se emite cuando hoverable está establecido en «true».

Nota: En el caso de los gráficos circulares, el valor representa (ángulo de posición, ángulo inicial de la porción sobre la que se pasa el cursor).

[signal] void QAbstractSeries::hoverExit(const QString &seriesName, QPointF position)

Esta señal se emite cuando finaliza el desplazamiento sobre la serie. El nombre de la serie se encuentra en seriesName, y la posición del ratón o del tacto, en position.

Nota: Esta señal solo se emite cuando hoverable está establecido en «true».

void QAbstractSeries::show()

Establece la visibilidad de la serie en « true ».

Véase también setVisible() y isVisible().

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