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: |
- Lista de todos los miembros, incluidos los heredados
- QXYSeries forma parte de las clases C++ deQt Graphs para 2D.
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.
| Constante | Valor | Descripción |
|---|---|---|
QXYSeries::ValueMapping::X | 0 | Cada número es el valor X; el valor Y se genera a partir del índice y de stepSize. |
QXYSeries::ValueMapping::Y | 1 | Cada 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:
| Tipo | Nombre | Descripción |
|---|---|---|
| bool | pointSelected | Este valor es «true» cuando el punto está seleccionado, lo que significa que el índice del punto está en « QXYSeries::selectedPoints ». |
| QColor | colorDelPunto | El color de la serie. Este valor procede de QGraphsTheme o de QXYSeries::color si QXYSeries anula el color. |
| QColor | colorBordePunto | El color del borde de la serie. Este valor procede de QGraphsTheme. |
| QColor | colorPuntoSeleccionado | El color de los puntos seleccionados de la serie. Este valor procede de QGraphsTheme o de QXYSeries::selectedColor si QXYSeries anula el color. |
| qreal | pointBorderWidth | El ancho del borde de la serie. Este valor procede de QGraphsTheme. |
| qreal | pointValueX | El valor de la « QXYPoint::x » en esta posición. |
| qreal | pointValueY | El valor del « QXYPoint::y » en esta posición. |
| int | índiceDelPunto | El í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: 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 setPointSelected().
[invokable] void QXYSeries::deselectPoint(qsizetype index)
Deselecciona el punto situado en la coordenada dada index.
Nota: Emite QXYSeries::selectedPointsChanged
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: 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 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: 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 setPointSelected().
[invokable] void QXYSeries::selectPoint(qsizetype index)
Las marcas indican que index es la opción seleccionada.
Nota: 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 setPointSelected().
[invokable] void QXYSeries::selectPoints(const QList<qsizetype> &indexes)
Marca como seleccionados varios elementos de una lista « indexes ».
Nota: 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 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: 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 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.