En esta página

QXYSeries Class

La clase QXYSeries es una clase padre para todas las clases de series x & y. Más...

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

QLineSeries, QScatterSeries, y QSplineSeries

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)
bool take(QPointF point)
void toggleSelection(const QList<qsizetype> &indexes)

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

Descripción detallada

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

Ver también QLineSeries y QScatterSeries.

Documentación de Propiedades

color : QColor

Esta propiedad contiene el color principal de la serie. Para QLineSeries esto significa el color de la línea y para QScatterSeries el color del punto.

Funciones de acceso:

QColor color() const
void setColor(QColor newColor)

Señal del notificador:

void colorChanged(QColor color)

[read-only] count : qsizetype

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

Funciones de acceso:

qsizetype count() const

Señal del notificador:

void countChanged()

draggable : bool

Controla si la serie se puede arrastrar.

Controla si la serie se puede arrastrar con el ratón/toque. Por defecto, draggable se establece en false.

Funciones de acceso:

bool isDraggable() const
void setDraggable(bool newDraggable)

Señal de aviso:

void draggableChanged()

pointDelegate : QQmlComponent*

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

Las propiedades dinámicas disponibles para este componente son

TipoNombreDescripción
boolpointSelectedEste valor es verdadero cuando el punto está seleccionado, lo que significa que el índice del punto está en QXYSeries::selectedPoints.
QColorpointColorEl color de la serie. Este valor proviene de QGraphsTheme o de QXYSeries::color si QXYSeries anula el color.
QColorpointBorderColorColor del borde de la serie. Este valor proviene de QGraphsTheme.
QColorpointSelectedColorEl color seleccionado de la serie. Este valor procede de QGraphsTheme o de QXYSeries::selectedColor si QXYSeries anula el color.
qrealpointBorderWidthAnchura del borde de la serie. Este valor procede de QGraphsTheme.
qrealpointValueXEl valor de QXYPoint::x en esta posición.
qrealpointValueYValor de QXYPoint::y en esta posición.
intpointIndexEl índice del punto, de 0 a la cantidad de puntos - 1. [desde 6.9]

Para utilizar cualquiera de ellos, añada la propiedad con el nombre definido en su 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 del notificador:

void selectedColorChanged(QColor color)

[read-only] selectedPoints : QList<qsizetype>

Esta propiedad contiene los índices de los puntos actualmente seleccionados.

Funciones de acceso:

QList<qsizetype> selectedPoints() const

Señal del notificador:

void selectedPointsChanged()

Documentación de la función miembro

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

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

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

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

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

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

Nota: Esta función puede ser invocada a través del sistema de meta-objetos y desde QML. Véase Q_INVOKABLE.

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

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

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

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

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

Nota: Esta función puede invocarse 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 puede invocarse 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 puede invocarse 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 en index.

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

Véase también setPointSelected().

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

Marca múltiples puntos pasados en una lista indexes como deseleccionados.

Nota: Esta función puede invocarse 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 según se define en point. Devuelve -1 si no se encuentra el punto.

Nota: Esta función puede invocarse 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 en la serie. Si el índice es 0 o menor que 0, el punto se añade a 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 a la lista de puntos.

Nota: Esta función puede invocarse 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 en index está entre los puntos seleccionados y false en caso contrario.

Nota: Los puntos seleccionados se dibujan utilizando el color seleccionado si se ha especificado.

Nota: Esta función puede invocarse 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 sustituyen todos los puntos.

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

Elimina de la serie el punto con las coordenadas point. No hace nada si el punto no existe.

Nota: Esta función puede invocarse 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 puede invocarse 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 hace nada si el punto no existe.

Nota: Esta función puede invocarse 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 que comienza en la posición especificada por index.

Nota: Esta función puede invocarse 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 reemplazar los puntos de datos uno a uno, o primero borrar todos los datos, y luego añadir los nuevos datos. Emite pointsReplaced cuando los puntos han sido reemplazados.

Nota: Esta función puede invocarse 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 hace nada si el punto anterior no existe.

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

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

Sustituye el punto en la posición especificada por index por el punto que tiene las coordenadas newPoint.

Nota: Esta función puede invocarse 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 en la posición especificada por index por el punto que tiene las coordenadas newX y newY.

Nota: Esta función puede invocarse 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 hace nada si el punto anterior no existe.

Nota: Esta función puede invocarse 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 puede invocarse 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)

Marca el punto en index como seleccionado.

Nota: Esta función puede invocarse 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 múltiples puntos pasados en una lista indexes como seleccionados.

Nota: Esta función puede invocarse 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ón Getter para la propiedad selectedPoints.

Véase también setPointSelected().

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

Marca un punto en index como seleccionado o deseleccionado según se especifique en selected.

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

Nota: Esta función puede invocarse 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)

Toma un punto, especificado por point, de la serie si se encuentra. Devuelve true si la operación tiene éxito.

Nota: Esta función puede invocarse 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 en indexes por el opuesto.

Nota: Esta función puede ser invocada a través del sistema de meta-objetos 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.