En esta página

XYSeries QML Type (Uncreatable)

Un tipo padre para todos los tipos de las series x e y. Más...

Import Statement: import QtGraphs
In C++: QXYSeries
Inherits:

AbstractSeries

Inherited By:

LineSeries, ScatterSeries, and SplineSeries

Nota: Se trata de un tipo no creable. No se puede instanciar en QML.

Propiedades

Señales

Métodos

Descripción detallada

En XYSeries, los puntos de datos se definen como una lista de tipos de punto, que especifican las posiciones X e Y.

Documentación de propiedades

color : color

El color principal de la serie. En el caso de LineSeries, se refiere al color de la línea, y en el de ScatterSeries, al color del punto.

count : int [read-only]

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

draggable : bool

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

pointDelegate : Component

Un componente QML personalizado que se utiliza como marcador para puntos de datos.

Las propiedades dinámicas disponibles para este componente son:

TipoNombreDescripción
boolpointSelectedEste valor es «true» cuando el punto está seleccionado.
ColorcolorPuntoEl color de la serie. Este valor procede de « GraphsTheme » o de « XYSeries::color » si « XYSeries » anula el color.
ColorcolorBordePuntoEl color del borde de la serie. Este valor procede de GraphsTheme.
ColorpointSelectedColorEl color seleccionado de la serie. Este valor procede de GraphsTheme o de XYSeries::selectedColor si XYSeries anula el color.
realpointBorderWidthEl ancho del borde de la serie. Este valor procede de GraphsTheme.
realpointValueXEl valor del « XYPoint::x » en esta posición.
realpointValueYEl valor del « XYPoint::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" ».

selectedColor : color

El color de los puntos seleccionados.

selectedPoints : list<int> [read-only]

Los índices de los puntos que están seleccionados actualmente.

values : list<variant> [since 6.12]

Esta propiedad se puede utilizar para definir puntos de forma declarativa en un « XYSeries ». La lista de variantes puede estar compuesta por puntos o por números. Si se especifican números, se puede utilizar «valueMapping» para indicar si el número se interpreta como el componente X o Y de un punto.

Esta propiedad se introdujo en Qt 6.12.

Documentación de señales

clicked(point point)

Esta señal se emite cuando el usuario hace clic o pulsa sobre el « point » en el gráfico.

Nota: El controlador correspondiente es onClicked.

colorChanged(color color)

Esta señal se emite cuando el color de la línea cambia a color.

Nota: El controlador correspondiente es onColorChanged.

doubleClicked(point point)

Esta señal se emite cuando el usuario hace doble clic o toca dos veces los datos point en el gráfico. El point es el punto en el que se activó la primera pulsación. Esta señal siempre se produce después de clicked.

Nota: El controlador correspondiente es onDoubleClicked.

draggableChanged()

Esta señal se emite cuando una serie se puede arrastrar con el ratón o mediante un gesto táctil, o cuando se fija.

Nota: El controlador correspondiente es onDraggableChanged.

pointMarkerChanged()

Esta señal se emite cuando se modifica un punto.

Nota: El controlador correspondiente es onPointMarkerChanged.

pointReplaced(int index)

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

Nota: El controlador correspondiente es onPointReplaced.

[since 6.9] pointsAdded(int start, int end)

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

Nota: El controlador correspondiente es onPointsAdded.

Esta señal se introdujo en Qt 6.9.

pointsReplaced()

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

Nota: El controlador correspondiente es onPointsReplaced.

pressed(point point)

Esta señal se emite cuando el usuario pulsa sobre los datos point en el gráfico y mantiene pulsado el botón del ratón o realiza un gesto.

Nota: El controlador correspondiente es onPressed.

released(point point)

Esta señal se emite cuando el usuario suelta el botón del ratón que había pulsado anteriormente o realiza un gesto en el dato point.

Nota: El controlador correspondiente es onReleased.

selectedColorChanged(color color)

Esta señal se emite cuando el color de la serie seleccionada cambia a color.

Nota: El controlador correspondiente es onSelectedColorChanged.

selectedPointsChanged()

Esta señal se emite cuando cambia el conjunto de puntos seleccionados.

Nota: El controlador correspondiente es onSelectedPointsChanged.

Documentación del método

void append(list<point> 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 por uno. Emite pointsAdded cuando se han añadido los puntos.

void append(point point)

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

void append(real x, real y)

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

point at(int index)

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

void clear()

Elimina todos los puntos de la serie.

void deselectAllPoints()

Deselecciona todos los puntos de la serie.

Véase también setPointSelected().

void deselectPoint(int index)

Deselecciona el punto situado en la coordenada dada index.

Véase también setPointSelected().

void deselectPoints(list<int> indexes)

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

Véase también ` setPointSelected()`.

int find(point point)

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.

void insert(int index, point 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.

bool isPointSelected(int index)

Devuelve «true» si el punto situado en la dirección dada 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.

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

void remove(int index)

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

void remove(point point)

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

void remove(real x, real y)

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

void removeMultiple(int index, int count)

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

void replace(list<point> 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 un evento « pointsReplaced » cuando se han sustituido los puntos.

void replace(int index, point newPoint)

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

void replace(point oldPoint, point 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.

void replace(int index, real newX, real newY)

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

void replace(real oldX, real oldY, real newX, real 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.

void selectAllPoints()

Marca todos los puntos de la serie como seleccionados,

Véase también setPointSelected().

void selectPoint(int index)

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

Véase también setPointSelected().

void selectPoints(list<int> indexes)

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

Véase también ` setPointSelected()`.

void setPointSelected(int index, bool selected)

Marca los puntos de la tabla « 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

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

bool take(point point)

Extrae un punto, especificado por point, de la serie si se encuentra. Devuelve true si la operación se realiza correctamente.

void toggleSelection(list<int> indexes)

Cambia el estado de selección de los puntos en la dirección dada indexes por el contrario.

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.