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: | |
| Inherited By: |
Nota: Se trata de un tipo no creable. No se puede instanciar en QML.
- Lista de todos los miembros, incluidos los heredados
- XYSeries forma parte de los tipos QML deQt Graphs para 2D.
Propiedades
- color : color
- count : int
- draggable : bool
- pointDelegate : Component
- selectedColor : color
- selectedPoints : list<int>
- values : list<variant>
(since 6.12)
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 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:
| Tipo | Nombre | Descripción |
|---|---|---|
| bool | pointSelected | Este valor es «true» cuando el punto está seleccionado. |
| Color | colorPunto | El color de la serie. Este valor procede de « GraphsTheme » o de « XYSeries::color » si « XYSeries » anula el color. |
| Color | colorBordePunto | El 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 | El ancho del borde de la serie. Este valor procede de GraphsTheme. |
| real | pointValueX | El valor del « XYPoint::x » en esta posición. |
| real | pointValueY | El valor del « XYPoint::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" ».
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.
Nota: Emite QXYSeries::selectedPointsChanged
Véase también setPointSelected().
void deselectPoint(int index)
Deselecciona el punto situado en la coordenada dada index.
Nota: Emite QXYSeries::selectedPointsChanged
Véase también setPointSelected().
void deselectPoints(list<int> indexes)
Marca como deseleccionados varios puntos de una lista « indexes ».
Nota: Emite QXYSeries::selectedPointsChanged
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,
Nota: Emite QXYSeries::selectedPointsChanged
Véase también setPointSelected().
void selectPoint(int index)
Las marcas indican que index es la opción seleccionada.
Nota: Emite QXYSeries::selectedPointsChanged
Véase también setPointSelected().
void selectPoints(list<int> indexes)
Marca como seleccionados varios elementos de una lista « indexes ».
Nota: Emite QXYSeries::selectedPointsChanged
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.
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.