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 |
- Lista de todos los miembros, incluidos los heredados
- QAbstractSeries forma parte de las clases C++ deQt Graphs para 2D.
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.
| Constante | Valor | Descripción |
|---|---|---|
QAbstractSeries::SeriesType::Line | 0 | Un gráfico de líneas. |
QAbstractSeries::SeriesType::Bar | 2 | Un gráfico de barras. |
QAbstractSeries::SeriesType::Scatter | 4 | Un gráfico de dispersión. |
QAbstractSeries::SeriesType::Pie | 3 | Un gráfico circular. |
QAbstractSeries::SeriesType::Spline | 5 | Un gráfico de splines. |
QAbstractSeries::SeriesType::Area | 1 | Un gráfico de área. |
QAbstractSeries::SeriesType::Custom | 6 | Un 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.