QAbstractSeries Class
La clase QAbstractSeries es una clase base para todas las Qt Graphs para series 2D. Más...
| Cabecera: | #include <QAbstractSeries> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Graphs)target_link_libraries(mytarget PRIVATE Qt6::Graphs) |
| qmake: | QT += graphs |
| En QML: | AbstractSeries |
| Hereda: | QObject y QQmlParserStatus |
| Heredado de: | QAreaSeries, QBarSeries, QCustomSeries, QPieSeries, y QXYSeries |
- Lista de todos los miembros, incluyendo los heredados
- QAbstractSeries es parte de Qt Graphs C++ Classes for 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, las clases heredadas específicas del tipo de serie se utilizan en lugar de la clase base.
Véase también QLineSeries, QSplineSeries, QScatterSeries, QBarSeries, y QXYSeries.
Documentación de tipos de miembros
enum class QAbstractSeries::SeriesType
Este enum describe el tipo de la serie.
| Constante | Valor | Descripción |
|---|---|---|
QAbstractSeries::SeriesType::Line | 0 | Un gráfico de líneas. |
QAbstractSeries::SeriesType::Bar | 2 | Gráfico de barras. |
QAbstractSeries::SeriesType::Scatter | 4 | Gráfico de dispersión. |
QAbstractSeries::SeriesType::Pie | 3 | Gráfico circular. |
QAbstractSeries::SeriesType::Spline | 5 | Gráfico de splines. |
QAbstractSeries::SeriesType::Area | 1 | Gráfico de áreas. |
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 separado del definido en GraphsView mostrando al usuario múltiples ejes por gráfico.
Esta propiedad se introdujo en Qt 6.10.
Funciones de acceso:
| QAbstractAxis * | axisX() const |
| void | setAxisX(QAbstractAxis *newAxisX) |
Señal notificadora:
| void | axisXChanged(QAbstractAxis *newAxis) |
[since 6.10] axisY : QAbstractAxis*
Eje Y de esta serie.
El eje y utilizado para esta serie. Crea un eje separado del definido en GraphsView mostrando al usuario múltiples ejes por gráfico.
Esta propiedad se introdujo en Qt 6.10.
Funciones de acceso:
| QAbstractAxis * | axisY() const |
| void | setAxisY(QAbstractAxis *newAxisY) |
Señal notificadora:
| void | axisYChanged(QAbstractAxis *newAxis) |
hoverable : bool
Controla si la serie es hoverable.
Controla si se puede pasar el ratón por encima de la serie. Por defecto, hoverable se establece en false.
Funciones de acceso:
| bool | isHoverable() const |
| void | setHoverable(bool newHoverable) |
Señal de aviso:
| void | hoverableChanged() |
[read-only] hovered : bool
Comprueba si una serie está sobrevolada.
Se puede utilizar para comprobar si el ratón/toque está actualmente sobre una serie.
Funciones de acceso:
| bool | isHovered() const |
Señal notificadora:
| void | hoveredChanged(bool hovered) |
Ver 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 del notificador:
| void | legendDataChanged() |
Véase también QLegendData.
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() |
selectable : bool
Controla si la serie es seleccionable.
Controla si la serie se puede seleccionar con el ratón/toque. Por defecto, selectable se establece en false.
Funciones de acceso:
| bool | isSelectable() const |
| void | setSelectable(bool selectable) |
Señal de aviso:
| void | selectableChanged() |
[read-only] seriesChildren : const QQmlListProperty<QObject>
La lista de objetos hijo de la serie. Se trata de una propiedad por defecto que permite especificar objetos hijo dentro de un elemento serie en QML sin utilizar explícitamente el nombre de la propiedad children.
Funciones de acceso:
| QQmlListProperty<QObject> | seriesChildren() |
[read-only] type : const SeriesType
Esta propiedad contiene 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 escalen de 0 al tamaño del valor real. Por defecto, el valuesMultiplier es 1.0. Los valores válidos van de 0.0 (altura 0) a 1.0 (valor total).
Funciones de acceso:
| qreal | valuesMultiplier() const |
| void | setValuesMultiplier(qreal valuesMultiplier) |
Señal del notificador:
| void | valuesMultiplierChanged() |
visible : bool
Visibilidad de la serie.
La visibilidad utilizada para esta serie. Por defecto, visible se establece en true.
Funciones de acceso:
| bool | isVisible() const |
| void | setVisible(bool visible = true) |
Señal del notificador:
| void | visibleChanged() |
[since 6.10] zValue : int
Controla el orden en el que se dibujan las series.
La lista de series de GraphsView se ordena por la propiedad zValue. Dado que cada tipo de serie se renderiza a la vez, el orden funciona mayoritariamente como un orden interno de cada tipo de serie. El zValue más alto de cada tipo de serie determina el orden de renderizado entre los tipos de serie. El valor por defecto es 0.
Esta propiedad 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 funciones miembro
[override virtual noexcept] QAbstractSeries::~QAbstractSeries()
Destructor virtual de la serie de gráficos.
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 el hover de la serie. El nombre de la serie está en seriesName, la posición del ratón/toque en position, y el valor de la serie en value.
Nota: Esta señal sólo se emite cuando hoverable tiene el valor true.
Nota: Para el gráfico de tarta, el valor representa (ángulo de posición, ángulo de inicio de la rebanada de hovering)
[signal] void QAbstractSeries::hoverEnter(const QString &seriesName, QPointF position, QPointF value)
Esta señal se emite cuando se inicia el hovering de la serie. El nombre de la serie está en seriesName, la posición del ratón/toque en position, y el valor de la serie en value.
Nota: Esta señal sólo se emite cuando hoverable tiene el valor true.
Nota: Para el gráfico circular, el valor representa (ángulo de posición, ángulo de inicio del hovering slice)
[signal] void QAbstractSeries::hoverExit(const QString &seriesName, QPointF position)
Esta señal se emite cuando finaliza el hovering de la serie. El nombre de la serie está en seriesName, y la posición del ratón/toque en position.
Nota: Esta señal sólo se emite cuando hoverable tiene el valor 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.
