XYSeries QML Type
Un tipo padre para todos los tipos de series x & y. Más...
| Import Statement: | import QtGraphs |
| In C++: | QXYSeries |
| Inherits: | |
| Inherited By: |
- Lista de todos los miembros, incluyendo los heredados
- XYSeries es parte de Qt Graphs QML Types for 2D.
Propiedades
- color : color
- count : int
- draggable : bool
- pointDelegate : Component
- selectedColor : color
- selectedPoints : list<int>
Señales
- clicked(point point)
- colorChanged(color color)
- doubleClicked(point point)
- draggableChanged()
- pointMarkerChanged()
- pointReplaced(int index)
- pointsAdded(int start, int end)
(since 6.9) - pointsReplaced()
- pressed(point point)
- released(point point)
- selectedColorChanged(color color)
- selectedPointsChanged()
Métodos
- void append(list<point> points)
- void append(point point)
- void append(real x, real y)
- point at(int index)
- void clear()
- void deselectAllPoints()
- void deselectPoint(int index)
- void deselectPoints(list<int> indexes)
- int find(point point)
- void insert(int index, point point)
- bool isPointSelected(int index)
- void remove(int index)
- void remove(point point)
- void remove(real x, real y)
- void removeMultiple(int index, int count)
- void replace(list<point> points)
- void replace(int index, point newPoint)
- void replace(point oldPoint, point newPoint)
- void replace(int index, real newX, real newY)
- void replace(real oldX, real oldY, real newX, real newY)
- void selectAllPoints()
- void selectPoint(int index)
- void selectPoints(list<int> indexes)
- void setPointSelected(int index, bool selected)
- bool take(point point)
- void toggleSelection(list<int> indexes)
Descripción detallada
En XYSeries, los puntos de datos se definen como una lista de tipos de puntos, definiendo las posiciones X e Y.
Documentación de propiedades
color : color
El color principal de la serie. Para LineSeries significa el color de la línea y para ScatterSeries el color del punto.
count : int [read-only]
Devuelve el número de puntos de datos de una serie.
draggable : bool
Controla si la serie puede arrastrarse con el ratón/toque. Por defecto, draggable se establece en false.
pointDelegate : Component
Un componente QML personalizado utilizado 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. |
| Color | pointColor | El color de la serie. Este valor proviene de GraphsTheme o de XYSeries::color si XYSeries anula el color. |
| Color | pointBorderColor | Color del borde de la serie. Este valor procede de GraphsTheme. |
| Color | pointSelectedColor | El color seleccionado de la serie. Este valor procede de GraphsTheme o de XYSeries::selectedColor si XYSeries anula el color. |
| real | pointBorderWidth | Anchura del borde de la serie. Este valor proviene de GraphsTheme. |
| real | pointValueX | El valor de XYPoint::x en esta posición. |
| real | pointValueY | Valor de XYPoint::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".
selectedColor : color
El color de los puntos seleccionados.
selectedPoints : list<int> [read-only]
Los índices de los puntos actualmente seleccionados.
Documentación de señales
clicked(point point)
Esta señal se emite cuando el usuario hace clic o toca point en el gráfico.
Nota: El manejador correspondiente es onClicked.
colorChanged(color color)
Esta señal se emite cuando el color de la línea cambia a color.
Nota: El manejador correspondiente es onColorChanged.
doubleClicked(point point)
Esta señal se emite cuando el usuario hace doble clic o doble toque en los datos point del gráfico. El point es el punto en el que se produjo la primera pulsación. Esta señal siempre se produce después de clicked.
Nota: El manejador correspondiente es onDoubleClicked.
draggableChanged()
Esta señal se emite cuando una serie se vuelve arrastrable por el ratón/toque o se vuelve fija.
Nota: El manejador correspondiente es onDraggableChanged.
pointMarkerChanged()
Esta señal se emite cuando se cambia un punto.
Nota: El manejador 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 manejador 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 están comprendidos entre start y end.
Nota: El manejador correspondiente es onPointsAdded.
Esta señal se introdujo en Qt 6.9.
pointsReplaced()
Esta señal se emite cuando se sustituyen todos los puntos.
Nota: El manejador correspondiente es onPointsReplaced.
pressed(point point)
Esta señal se emite cuando el usuario pulsa el dato point en el gráfico y mantiene pulsado el botón o gesto del ratón.
Nota: El manejador correspondiente es onPressed.
released(point point)
Esta señal se emite cuando el usuario suelta el botón o el gesto del ratón previamente pulsado sobre los datos point.
Nota: El manejador correspondiente es onReleased.
selectedColorChanged(color color)
Esta señal se emite cuando el color de la serie seleccionada cambia a color.
Nota: El manejador correspondiente es onSelectedColorChanged.
selectedPointsChanged()
Esta señal se emite cuando cambia el conjunto de puntos seleccionados.
Nota: El manejador correspondiente es onSelectedPointsChanged.
Documentación del método
void append(list<point> 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 se han añadido los puntos.
void append(point point)
Añade un punto con las coordenadas point a la serie.
void append(real x, real y)
Añade un punto con las coordenadas x y y a la serie.
point at(int index)
Devuelve el punto 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 en index.
Nota: Emite QXYSeries::selectedPointsChanged
Véase también setPointSelected().
void deselectPoints(list<int> indexes)
Marca múltiples puntos pasados en una lista indexes como deseleccionados.
Nota: Emite QXYSeries::selectedPointsChanged
Véase también setPointSelected().
int find(point point)
Busca y devuelve el índice del primer punto coincidente encontrado según 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 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.
bool isPointSelected(int index)
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.
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 hace nada si el punto no existe.
void remove(real x, real y)
Elimina de la serie el punto con las coordenadas x y y. No hace nada si el punto no existe.
void removeMultiple(int index, int count)
Elimina el número de puntos especificado por count de la serie que comienza en 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 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.
void replace(int index, point newPoint)
Sustituye el punto en la posición especificada por index por el punto que tiene las coordenadas newPoint.
void replace(point oldPoint, point newPoint)
Sustituye el punto con las coordenadas oldPoint por el punto con las coordenadas newPoint. No hace nada si el punto anterior no existe.
void replace(int index, real newX, real newY)
Sustituye el punto en la posición especificada por index por el punto que tiene las coordenadas 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 hace nada si el punto anterior no existe.
void selectAllPoints()
Marca todos los puntos de la serie como seleccionados,
Nota: Emite QXYSeries::selectedPointsChanged
Véase también setPointSelected().
void selectPoint(int index)
Marca el punto en index como seleccionado.
Nota: Emite QXYSeries::selectedPointsChanged
Véase también setPointSelected().
void selectPoints(list<int> indexes)
Marca múltiples puntos pasados en una lista indexes como seleccionados.
Nota: Emite QXYSeries::selectedPointsChanged
Véase también setPointSelected().
void setPointSelected(int 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
Véase también isPointSelected(), selectAllPoints(), y selectedColor.
bool take(point point)
Toma un punto, especificado por point, de la serie si se encuentra. Devuelve true si la operación tiene éxito.
void toggleSelection(list<int> indexes)
Cambia el estado de selección de los puntos en indexes por el opuesto.
Nota: Emite QXYSeries::selectedPointsChanged
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.