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: |
- Lista de todos los miembros, incluyendo los heredados
- QXYSeries es parte de Qt Graphs C++ Classes for 2D.
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
| Tipo | Nombre | Descripción |
|---|---|---|
| bool | pointSelected | Este valor es verdadero cuando el punto está seleccionado, lo que significa que el índice del punto está en QXYSeries::selectedPoints. |
| QColor | pointColor | El color de la serie. Este valor proviene de QGraphsTheme o de QXYSeries::color si QXYSeries anula el color. |
| QColor | pointBorderColor | Color del borde de la serie. Este valor proviene de QGraphsTheme. |
| QColor | pointSelectedColor | El color seleccionado de la serie. Este valor procede de QGraphsTheme o de QXYSeries::selectedColor si QXYSeries anula el color. |
| qreal | pointBorderWidth | Anchura del borde de la serie. Este valor procede de QGraphsTheme. |
| qreal | pointValueX | El valor de QXYPoint::x en esta posición. |
| qreal | pointValueY | Valor de QXYPoint::y en esta posición. |
| int | pointIndex | El í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: 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 setPointSelected().
[invokable] void QXYSeries::deselectPoint(qsizetype index)
Deselecciona el punto en index.
Nota: 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 setPointSelected().
[invokable] void QXYSeries::deselectPoints(const QList<qsizetype> &indexes)
Marca múltiples puntos pasados en una lista indexes como deseleccionados.
Nota: 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 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: 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 setPointSelected().
[invokable] void QXYSeries::selectPoint(qsizetype index)
Marca el punto en index como seleccionado.
Nota: 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 setPointSelected().
[invokable] void QXYSeries::selectPoints(const QList<qsizetype> &indexes)
Marca múltiples puntos pasados en una lista indexes como seleccionados.
Nota: 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 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: Emite QXYSeries::selectedPointsChanged
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.