En esta página

QXYSeries Class

La clase «QXYSeries» es la clase principal de todas las clases de las series x e y. Más información...

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

QLineSeries, QScatterSeries y QSplineSeries

Tipos públicos

(since 6.12) enum class ValueMapping { X, Y }

Propiedades

Funciones públicas

void append(QPointF point)
void append(const QList<QPointF> &points)
void append(qreal x, qreal y)
QPointF at(qsizetype index) const
void clear()
QColor color() const
qsizetype count() const
void deselectAllPoints()
void deselectPoint(qsizetype index)
void deselectPoints(const QList<qsizetype> &indexes)
qsizetype find(QPointF point) const
void insert(qsizetype index, QPointF point)
bool isDraggable() const
bool isPointSelected(qsizetype index) const
QQmlComponent *pointDelegate() const
QList<QPointF> points() const
void remove(QPointF point)
void remove(qsizetype index)
void remove(qreal x, qreal y)
void removeMultiple(qsizetype index, qsizetype count)
void replace(const QList<QPointF> &points)
void replace(QPointF oldPoint, QPointF newPoint)
void replace(qsizetype index, QPointF newPoint)
void replace(qsizetype index, qreal newX, qreal newY)
void replace(qreal oldX, qreal oldY, qreal newX, qreal newY)
void selectAllPoints()
void selectPoint(qsizetype index)
void selectPoints(const QList<qsizetype> &indexes)
QColor selectedColor() const
QList<qsizetype> selectedPoints() const
void setColor(QColor newColor)
void setDraggable(bool newDraggable)
void setPointDelegate(QQmlComponent *newPointDelegate)
void setPointSelected(qsizetype index, bool selected)
void setSelectedColor(QColor color)
void setStepSize(qreal stepSize)
void setValueMapping(QXYSeries::ValueMapping newHint)
void setValueMin(qreal newMin)
void setValues(QVariantList values)
qreal stepSize() const
bool take(QPointF point)
void toggleSelection(const QList<qsizetype> &indexes)
QXYSeries::ValueMapping valueMapping() const
qreal valueMin() const
QVariantList values() const

Señales

void colorChanged(QColor color)
void countChanged()
void draggableChanged()
void pointDelegateChanged()
void pointReplaced(qsizetype index)
(since 6.9) void pointsAdded(qsizetype start, qsizetype end)
void pointsReplaced()
void selectedColorChanged(QColor color)
void selectedPointsChanged()
void stepSizeChanged(qreal newStepSize)
void valueMappingChanged(QXYSeries::ValueMapping newHint)
void valueMinChanged(qreal newMin)
void valuesChanged(const QVariantList &values)

Descripción detallada

En QXYSeries, los puntos de datos se definen como una lista de QPointF, que definen las posiciones X e Y.

Véase también « QLineSeries » y « QScatterSeries ».

Documentación sobre tipos de miembros

[since 6.12] enum class QXYSeries::ValueMapping

Esta enumeración describe cómo se interpretan los números sin formato en values.

ConstanteValorDescripción
QXYSeries::ValueMapping::X0Cada número es el valor X; el valor Y se genera a partir del índice y de stepSize.
QXYSeries::ValueMapping::Y1Cada número es el valor Y; X se genera a partir de valueMin y stepSize.

Esta enumeración se introdujo en Qt 6.12.

Documentación de la propiedad

color : QColor

Esta propiedad define el color principal de la serie. En el caso de QLineSeries, se refiere al color de la línea, y en QScatterSeries, al color del punto.

Funciones de acceso:

QColor color() const
void setColor(QColor newColor)

Señal de notificación:

void colorChanged(QColor color)

[read-only] count : qsizetype

Devuelve el número de puntos de datos de una serie.

Funciones de Access:

qsizetype count() const

Señal de notificación:

void countChanged()

draggable : bool

Determina si la serie se puede arrastrar.

Determina si la serie se puede arrastrar con el ratón o mediante el tacto. Por defecto, « draggable » está establecido en « false ».

Funciones de acceso:

bool isDraggable() const
void setDraggable(bool newDraggable)

Señal de notificación:

void draggableChanged()

pointDelegate : QQmlComponent*

Esta propiedad contiene un componente QML personalizado que se utiliza como marcador para los puntos de datos.

Las propiedades dinámicas disponibles para este componente son:

TipoNombreDescripción
boolpointSelectedEste valor es «true» cuando el punto está seleccionado, lo que significa que el índice del punto está en « QXYSeries::selectedPoints ».
QColorcolorDelPuntoEl color de la serie. Este valor procede de QGraphsTheme o de QXYSeries::color si QXYSeries anula el color.
QColorcolorBordePuntoEl color del borde de la serie. Este valor procede de QGraphsTheme.
QColorcolorPuntoSeleccionadoEl color de los puntos seleccionados de la serie. Este valor procede de QGraphsTheme o de QXYSeries::selectedColor si QXYSeries anula el color.
qrealpointBorderWidthEl ancho del borde de la serie. Este valor procede de QGraphsTheme.
qrealpointValueXEl valor de la « QXYPoint::x » en esta posición.
qrealpointValueYEl valor del « QXYPoint::y » en esta posición.
intíndiceDelPuntoEl índice del punto, desde 0 hasta el número total de puntos menos 1. [desde la versión 6.9]

Para utilizar cualquiera de ellas, añade una propiedad con el nombre definido a tu componente personalizado. Por ejemplo, « "property color pointColor" » y « "property real pointValueX" ».

Funciones de acceso:

QQmlComponent *pointDelegate() const
void setPointDelegate(QQmlComponent *newPointDelegate)

Señal del notificador:

void pointDelegateChanged()

selectedColor : QColor

Esta propiedad contiene el color de los puntos seleccionados.

Funciones de acceso:

QColor selectedColor() const
void setSelectedColor(QColor color)

Señal de notificación:

void selectedColorChanged(QColor color)

[read-only] selectedPoints : QList<qsizetype>

Esta propiedad contiene los índices de los puntos que están seleccionados actualmente.

Funciones de acceso:

QList<qsizetype> selectedPoints() const

Señal de notificación:

void selectedPointsChanged()

[since 6.12] stepSize : qreal

Esta propiedad define el intervalo entre los valores de X (o Y) generados automáticamente al rellenar la serie a partir de números simples mediante values.

El valor por defecto es 1.

Esta enumeración se introdujo en Qt 6.12.

Funciones de acceso:

qreal stepSize() const
void setStepSize(qreal stepSize)

Señal de notificación:

void stepSizeChanged(qreal newStepSize)

Véase también values, valueMapping y valueMin.

[since 6.12] valueMapping : ValueMapping

Determina cómo se interpretan los números de « values ».

Cuando ` values ` contiene números simples en lugar de valores ` QPointF `, esta propiedad determina si cada número es el componente X o Y de un punto.

Esta enumeración se introdujo en Qt 6.12.

Funciones de acceso:

QXYSeries::ValueMapping valueMapping() const
void setValueMapping(QXYSeries::ValueMapping newHint)

Señal de notificador:

void valueMappingChanged(QXYSeries::ValueMapping newHint)

Véase también « values », « valueMin » y « stepSize ».

[since 6.12] valueMin : qreal

Esta propiedad contiene el valor mínimo de X (o Y) que se utiliza al generar puntos a partir de números simples en values.

Se utiliza junto con ` stepSize ` cuando ` valueMapping ` es ` ValueMapping::Y ` para generar los valores X de cada punto.

El valor por defecto es 0.

Esta enumeración se introdujo en Qt 6.12.

Funciones de acceso:

qreal valueMin() const
void setValueMin(qreal newMin)

Señal de notificador:

void valueMinChanged(qreal newMin)

Véase también values, valueMapping y stepSize.

[since 6.12] values : QVariantList

Esta propiedad contiene los puntos de la serie, definidos de forma declarativa.

La lista de variantes puede contener valores « QPointF » o números. Si se proporcionan números, la opción « valueMapping » controla si cada número se interpreta como un componente X o Y.

Esta enumeración se introdujo en Qt 6.12.

Funciones de acceso:

QVariantList values() const
void setValues(QVariantList values)

Señal de notificación:

void valuesChanged(const QVariantList &values)

Véase también valueMapping, valueMin y stepSize.

Documentación de las funciones miembro

[invokable] void QXYSeries::append(QPointF point)

Añade a la serie un punto con las coordenadas point.

Nota: Esta función se puede invocar a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.

[invokable] void QXYSeries::append(const QList<QPointF> &points)

Añade a la serie los puntos con las coordenadas points.

Nota: Esto es mucho más rápido que añadir puntos de datos uno a uno. Emite pointsAdded cuando se han añadido los puntos.

Nota: Esta función se puede invocar a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.

[invokable] void QXYSeries::append(qreal x, qreal y)

Añade a la serie un punto con las coordenadas x y y.

Nota: Esta función se puede invocar a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.

[invokable] QPointF QXYSeries::at(qsizetype index) const

Devuelve el punto situado en la posición especificada por ` index`. Devuelve (0, 0) si el índice no es válido.

Nota: Esta función se puede invocar a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.

[invokable] void QXYSeries::clear()

Elimina todos los puntos de la serie.

Nota: Esta función se puede invocar a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.

[invokable] void QXYSeries::deselectAllPoints()

Deselecciona todos los puntos de la serie.

Nota: Esta función se puede invocar a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.

Véase también setPointSelected().

[invokable] void QXYSeries::deselectPoint(qsizetype index)

Deselecciona el punto situado en la coordenada dada index.

Nota: Esta función se puede invocar a través del sistema de metobjetos y desde QML. Véase Q_INVOKABLE.

Véase también setPointSelected().

[invokable] void QXYSeries::deselectPoints(const QList<qsizetype> &indexes)

Marca como deseleccionados varios puntos de una lista « indexes ».

Nota: Esta función se puede invocar a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.

Véase también setPointSelected().

[invokable] qsizetype QXYSeries::find(QPointF point) const

Busca y devuelve el índice del primer punto coincidente encontrado, tal y como se define en point. Devuelve -1 si no se encuentra el punto.

Nota: Esta función se puede invocar a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.

[invokable] void QXYSeries::insert(qsizetype index, QPointF point)

Inserta un punto con las coordenadas point en la posición especificada por index dentro de la serie. Si el índice es 0 o menor que 0, el punto se añade al principio de la lista de puntos. Si el índice es igual o mayor que el número de puntos de la serie, el punto se añade al final de la lista de puntos.

Nota: Esta función se puede invocar a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.

[invokable] bool QXYSeries::isPointSelected(qsizetype index) const

Devuelve «true» si el punto situado en la coordenada « index » se encuentra entre los puntos seleccionados y «false» en caso contrario.

Nota: Los puntosseleccionados se dibujan con el color seleccionado, si se ha especificado.

Nota: Esta función se puede invocar a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.

Véase también selectedPoints, setPointSelected() y setSelectedColor().

[signal] void QXYSeries::pointReplaced(qsizetype index)

Esta señal se emite cuando se sustituye un punto en la posición especificada por index.

Véase también replace().

QList<QPointF> QXYSeries::points() const

Devuelve los puntos de la serie.

[signal, since 6.9] void QXYSeries::pointsAdded(qsizetype start, qsizetype end)

Esta señal se emite cuando se añade una lista de puntos. Los índices de los nuevos puntos añadidos están comprendidos entre start y end.

Esta función se introdujo en Qt 6.9.

[signal] void QXYSeries::pointsReplaced()

Esta señal se emite cuando se han sustituido todos los puntos.

[invokable] void QXYSeries::remove(QPointF point)

Elimina de la serie el punto con las coordenadas point. No realiza ninguna acción si el punto no existe.

Nota: Esta función se puede invocar a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.

[invokable] void QXYSeries::remove(qsizetype index)

Elimina de la serie el punto situado en la posición especificada por index.

Nota: Esta función se puede invocar a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.

[invokable] void QXYSeries::remove(qreal x, qreal y)

Elimina de la serie el punto con las coordenadas x y y. No realiza ninguna acción si el punto no existe.

Nota: Esta función se puede invocar a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.

[invokable] void QXYSeries::removeMultiple(qsizetype index, qsizetype count)

Elimina el número de puntos especificado por ` count ` de la serie a partir de la posición especificada por ` index`.

Nota: Esta función se puede invocar a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.

[invokable] void QXYSeries::replace(const QList<QPointF> &points)

Sustituye los puntos actuales por los puntos especificados por points

Nota: Esto es mucho más rápido que sustituir los puntos de datos uno por uno, o borrar primero todos los datos y, a continuación, añadir los nuevos. Emite pointsReplaced cuando se han sustituido los puntos.

Nota: Esta función se puede invocar a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.

[invokable] void QXYSeries::replace(QPointF oldPoint, QPointF newPoint)

Sustituye el punto con las coordenadas oldPoint por el punto con las coordenadas newPoint. No realiza ninguna acción si el punto anterior no existe.

Nota: Esta función se puede invocar a través del sistema de metaoobjetos y desde QML. Véase Q_INVOKABLE.

[invokable] void QXYSeries::replace(qsizetype index, QPointF newPoint)

Sustituye el punto situado en la posición especificada por index por el punto cuyas coordenadas son newPoint.

Nota: Esta función se puede invocar a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.

[invokable] void QXYSeries::replace(qsizetype index, qreal newX, qreal newY)

Sustituye el punto situado en la posición especificada por index por el punto cuyas coordenadas son newX y newY.

Nota: Esta función se puede invocar a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.

[invokable] void QXYSeries::replace(qreal oldX, qreal oldY, qreal newX, qreal newY)

Sustituye el punto con las coordenadas oldX y oldY por el punto con las coordenadas newX y newY. No realiza ninguna acción si el punto anterior no existe.

Nota: Esta función se puede invocar a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.

[invokable] void QXYSeries::selectAllPoints()

Marca todos los puntos de la serie como seleccionados,

Nota: Esta función se puede invocar a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.

Véase también setPointSelected().

[invokable] void QXYSeries::selectPoint(qsizetype index)

Las marcas indican que index es la opción seleccionada.

Nota: Esta función se puede invocar a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.

Véase también setPointSelected().

[invokable] void QXYSeries::selectPoints(const QList<qsizetype> &indexes)

Marca como seleccionados varios elementos de una lista « indexes ».

Nota: Esta función se puede invocar a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.

Véase también setPointSelected().

QList<qsizetype> QXYSeries::selectedPoints() const

Devuelve una lista de índices de puntos marcados como seleccionados. Los puntos seleccionados son visibles independientemente de la visibilidad de los puntos.

Nota: Funcióngetter para la propiedad selectedPoints.

Véase también setPointSelected().

[invokable] void QXYSeries::setPointSelected(qsizetype index, bool selected)

Marca los puntos de la tabla de datos « index » como seleccionados o deseleccionados, según se especifique en « selected ».

Nota: Los puntosseleccionados se dibujan utilizando el color seleccionado, si se ha especificado. Emite QXYSeries::selectedPointsChanged

Nota: Esta función se puede invocar a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.

Véase también isPointSelected(), selectAllPoints() y setSelectedColor().

[invokable] bool QXYSeries::take(QPointF point)

Extrae de la serie un punto, especificado por ` point`, si lo encuentra. Devuelve ` true ` si la operación se realiza con éxito.

Nota: Esta función se puede invocar a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.

[invokable] void QXYSeries::toggleSelection(const QList<qsizetype> &indexes)

Cambia el estado de selección de los puntos de la ruta « indexes » por el contrario.

Nota: Esta función se puede invocar a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.

Véase también setPointSelected().

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