QXYSeries Class
La clase QXYSeries es una clase base para series de líneas, splines y puntos dispersos. Más información...
| Header: | #include <QXYSeries> |
| In QML: | XYSeries |
| Inherits: | QAbstractSeries |
| Inherited By: | |
| Status: | Deprecated |
Esta clase está obsoleta. Recomendamos encarecidamente no utilizarla en código nuevo.
Tipos públicos
(since 6.2) enum class | PointConfiguration { Color, Size, Visibility, LabelVisibility, LabelFormat } |
Propiedades
|
|
Funciones públicas
| virtual | ~QXYSeries() |
| void | append(qreal x, qreal y) |
| void | append(const QList<QPointF> &points) |
| void | append(const QPointF &point) |
| const QPointF & | at(int index) const |
| QColor | bestFitLineColor() const |
(since 6.2) QPair<qreal, qreal> | bestFitLineEquation(bool &ok) const |
| bool | bestFitLineVisible() const |
| QBrush | brush() const |
| void | clear() |
(since 6.2) void | clearPointConfiguration(const int index) |
(since 6.2) void | clearPointConfiguration(const int index, const QXYSeries::PointConfiguration key) |
(since 6.2) void | clearPointsConfiguration() |
(since 6.2) void | clearPointsConfiguration(const QXYSeries::PointConfiguration key) |
| virtual QColor | color() const |
(since 6.2) void | colorBy(const QList<qreal> &sourceData, const QLinearGradient &gradient = QLinearGradient()) |
| int | count() const |
(since 6.2) void | deselectAllPoints() |
(since 6.2) void | deselectPoint(int index) |
(since 6.2) void | deselectPoints(const QList<int> &indexes) |
| void | insert(int index, const QPointF &point) |
(since 6.2) bool | isPointSelected(int index) |
(since 6.2) const QImage & | lightMarker() const |
(since 6.2) qreal | markerSize() const |
| QPen | pen() const |
(since 6.2) QHash<QXYSeries::PointConfiguration, QVariant> | pointConfiguration(const int index) const |
| bool | pointLabelsClipping() const |
| QColor | pointLabelsColor() const |
| QFont | pointLabelsFont() const |
| QString | pointLabelsFormat() const |
| bool | pointLabelsVisible() const |
| QList<QPointF> | points() const |
(since 6.2) QXYSeries::PointsConfigurationHash | pointsConfiguration() const |
| bool | pointsVisible() const |
| void | remove(const QPointF &point) |
| void | remove(int index) |
| void | remove(qreal x, qreal y) |
| void | removePoints(int index, int count) |
| void | replace(const QList<QPointF> &points) |
| void | replace(const QPointF &oldPoint, const QPointF &newPoint) |
| void | replace(int index, const QPointF &newPoint) |
| void | replace(int index, qreal newX, qreal newY) |
| void | replace(qreal oldX, qreal oldY, qreal newX, qreal newY) |
(since 6.2) void | selectAllPoints() |
(since 6.2) void | selectPoint(int index) |
(since 6.2) void | selectPoints(const QList<int> &indexes) |
(since 6.2) const QImage & | selectedLightMarker() const |
(since 6.2) QList<int> | selectedPoints() const |
| void | setBestFitLineColor(const QColor &color) |
| void | setBestFitLineVisible(bool visible = true) |
| virtual void | setBrush(const QBrush &brush) |
| virtual void | setColor(const QColor &color) |
(since 6.2) void | setLightMarker(const QImage &lightMarker) |
(since 6.2) void | setMarkerSize(qreal size) |
| virtual void | setPen(const QPen &pen) |
(since 6.2) void | setPointConfiguration(const int index, const QHash<QXYSeries::PointConfiguration, QVariant> &configuration) |
(since 6.2) void | setPointConfiguration(const int index, const QXYSeries::PointConfiguration key, const QVariant &value) |
| void | setPointLabelsClipping(bool enabled = true) |
| void | setPointLabelsColor(const QColor &color) |
| void | setPointLabelsFont(const QFont &font) |
| void | setPointLabelsFormat(const QString &format) |
| void | setPointLabelsVisible(bool visible = true) |
(since 6.2) void | setPointSelected(int index, bool selected) |
(since 6.2) void | setPointsConfiguration(const QHash<int, QHash<QXYSeries::PointConfiguration, QVariant>> &pointsConfiguration) |
| void | setPointsVisible(bool visible = true) |
| void | setSelectedColor(const QColor &color) |
(since 6.2) void | setSelectedLightMarker(const QImage &selectedLightMarker) |
(since 6.2) void | sizeBy(const QList<qreal> &sourceData, const qreal minSize, const qreal maxSize) |
(since 6.2) void | toggleSelection(const QList<int> &indexes) |
| QXYSeries & | operator<<(const QList<QPointF> &points) |
| QXYSeries & | operator<<(const QPointF &point) |
Señales
| void | bestFitLineColorChanged(const QColor &color) |
| void | bestFitLineVisibilityChanged(bool visible) |
| void | clicked(const QPointF &point) |
| void | colorChanged(QColor color) |
| void | doubleClicked(const QPointF &point) |
| void | hovered(const QPointF &point, bool state) |
(since 6.2) void | lightMarkerChanged(const QImage &lightMarker) |
| void | markerSizeChanged(qreal size) |
| void | penChanged(const QPen &pen) |
| void | pointAdded(int index) |
| void | pointLabelsClippingChanged(bool clipping) |
| void | pointLabelsColorChanged(const QColor &color) |
| void | pointLabelsFontChanged(const QFont &font) |
| void | pointLabelsFormatChanged(const QString &format) |
| void | pointLabelsVisibilityChanged(bool visible) |
| void | pointRemoved(int index) |
| void | pointReplaced(int index) |
| void | pointsRemoved(int index, int count) |
| void | pointsReplaced() |
| void | pressed(const QPointF &point) |
| void | released(const QPointF &point) |
| void | selectedColorChanged(const QColor &color) |
| void | selectedPointsChanged() |
Descripción detallada
QXYSeries permite mostrar una línea de mejor ajuste en un gráfico. La línea de mejor ajuste es una línea que atraviesa el gráfico y expresa la relación entre los puntos.
Documentación sobre tipos de miembros
[since 6.2] enum class QXYSeries::PointConfiguration
Este valor de enumeración describe la configuración concreta de un punto.
| Constante | Valor | Descripción |
|---|---|---|
QXYSeries::PointConfiguration::Color | 0 | Este valor de enumeración se puede utilizar para cambiar el color de un punto. Si se utiliza junto con ` QXYSeries::setPointConfiguration`, el valor de la configuración debe ser un ` QColor` válido. |
QXYSeries::PointConfiguration::Size | 1 | Este valor de enumeración se puede utilizar para cambiar el tamaño de un punto. Si se utiliza junto con ` QXYSeries::setPointConfiguration`, el valor de la configuración debe ser un número, como ` qreal ` o ` int`. |
QXYSeries::PointConfiguration::Visibility | 2 | Este valor de enumeración se puede utilizar para ocultar o mostrar el punto. Si se utiliza junto con QXYSeries::setPointConfiguration, el valor de la configuración debe ser un valor booleano. |
QXYSeries::PointConfiguration::LabelVisibility | 3 | Este valor de enumeración se puede utilizar para ocultar o mostrar la etiqueta del punto. Si se utiliza junto con ` QXYSeries::setPointConfiguration`, el valor de la configuración debe ser un valor booleano. |
QXYSeries::PointConfiguration::LabelFormat (since Qt 6.5) | 4 | Este valor de enumeración se puede utilizar para establecer un texto de etiqueta personalizado por punto. Si se utiliza junto con ` QXYSeries::setPointConfiguration`, el valor de la configuración debe ser una cadena. Nota: Si se establece una cadena vacía como «LabelFormat», se ignorará y se utilizará la propiedad « pointLabelsFormat » de la serie. |
Esta enumeración se introdujo en Qt 6.2.
Véase también pointLabelsFormat y setPointConfiguration().
Documentación de la propiedad
[since 6.2] bestFitLineColor : QColor
Esta propiedad contiene el color de la línea de mejor ajuste.
Esta enumeración se introdujo en Qt 6.2.
Funciones de acceso:
| QColor | bestFitLineColor() const |
| void | setBestFitLineColor(const QColor &color) |
Señal de notificación:
| void | bestFitLineColorChanged(const QColor &color) |
Véase también bestFitLineEquation y bestFitLineVisible.
[since 6.2] bestFitLineVisible : bool
Esta propiedad determina la visibilidad de la línea de mejor ajuste.
Esta propiedad está e false e por defecto.
Esta enumeración se introdujo en Qt 6.2.
Funciones de acceso:
| bool | bestFitLineVisible() const |
| void | setBestFitLineVisible(bool visible = true) |
Señal de notificador:
| void | bestFitLineVisibilityChanged(bool visible) |
Véase también bestFitLineEquation.
color : QColor
Esta propiedad contiene el color de la serie.
Se trata del color de la línea (pluma) en el caso de QLineSeries o QSplineSeries, y del color de relleno (pincel) en el caso de QScatterSeries o QAreaSeries.
Funciones de acceso:
| virtual QColor | color() const |
| virtual void | setColor(const QColor &color) |
Señal de notificación:
| void | colorChanged(QColor color) |
Véase también pen() y brush().
pointLabelsClipping : bool
Esta propiedad controla el recorte de las etiquetas de los puntos de datos.
Esta propiedad está configurad true e de forma predeterminada. Las etiquetas situadas en el borde del área de representación se recortan cuando el recorte está activado.
Funciones de acceso:
| bool | pointLabelsClipping() const |
| void | setPointLabelsClipping(bool enabled = true) |
Señal de notificación:
| void | pointLabelsClippingChanged(bool clipping) |
Véase también pointLabelsVisible.
pointLabelsColor : QColor
Esta propiedad determina el color que se utiliza para las etiquetas de los puntos de datos. Por defecto, el color es el del pincel definido en el tema para las etiquetas.
Funciones de acceso:
| QColor | pointLabelsColor() const |
| void | setPointLabelsColor(const QColor &color) |
Señal de notificador:
| void | pointLabelsColorChanged(const QColor &color) |
Véase también pointLabelsFormat.
pointLabelsFont : QFont
Esta propiedad contiene la fuente utilizada para las etiquetas de los puntos de datos.
Funciones de acceso:
| QFont | pointLabelsFont() const |
| void | setPointLabelsFont(const QFont &font) |
Señal de notificación:
| void | pointLabelsFontChanged(const QFont &font) |
Véase también pointLabelsFormat.
pointLabelsFormat : QString
Esta propiedad define el formato utilizado para mostrar las etiquetas con los puntos de datos.
QXYSeries Admite las siguientes etiquetas de formato:
| @index | El índice del punto de datos en la serie. [desde la versión 6.5] |
| @xPoint | La coordenada x del punto de datos. |
| @yPoint | La coordenada y del punto de datos. |
Por ejemplo, el siguiente uso de las etiquetas de formato generaría etiquetas que muestran el punto de datos entre paréntesis y separados por una coma (x, y):
series->setPointLabelsFormat("@index: (@xPoint, @yPoint)");Por defecto, el formato de las etiquetas está establecido en « @xPoint, @yPoint ». Las etiquetas se muestran en el área del gráfico, y las que se encuentran en el borde de dicha área quedan cortadas. Si los puntos están muy próximos entre sí, las etiquetas pueden solaparse.
Funciones de acceso:
| QString | pointLabelsFormat() const |
| void | setPointLabelsFormat(const QString &format) |
Señal de notificación:
| void | pointLabelsFormatChanged(const QString &format) |
Véase también pointLabelsVisible, pointLabelsFont y pointLabelsColor.
pointLabelsVisible : bool
Esta propiedad controla la visibilidad de las etiquetas de los puntos de datos.
Esta propiedad está configurad false e de forma predeterminada.
Funciones de acceso:
| bool | pointLabelsVisible() const |
| void | setPointLabelsVisible(bool visible = true) |
Señal del notificador:
| void | pointLabelsVisibilityChanged(bool visible) |
Véase también « pointLabelsFormat » y « pointLabelsClipping ».
pointsVisible : bool
Esta propiedad indica si los puntos de datos son visibles y deben representarse.
Funciones de acceso:
| bool | pointsVisible() const |
| void | setPointsVisible(bool visible = true) |
[since 6.2] selectedColor : QColor
Esta propiedad contiene el color de los puntos seleccionados.
Este es el color de relleno (pincel) de los puntos marcados como seleccionados. Si no se especifica, se utiliza como valor por defecto el valor de « QXYSeries::color ».
Esta enumeración se introdujo en Qt 6.2.
Funciones de acceso:
| virtual QColor | color() const |
| void | setSelectedColor(const QColor &color) |
Señal de notificador:
| void | selectedColorChanged(const QColor &color) |
Véase también color.
Documentación de las funciones miembro
[virtual noexcept] QXYSeries::~QXYSeries()
Elimina la serie. Las series añadidas a las instancias de QChart son propiedad de estas, y se eliminan cuando se eliminan las instancias de QChart.
void QXYSeries::append(qreal x, qreal y)
Añade a la serie el punto de datos con las coordenadas x y y.
void QXYSeries::append(const QList<QPointF> &points)
Añade a la serie la lista de puntos de datos especificada por ` points `.
Esta es una función sobrecargada.
void QXYSeries::append(const QPointF &point)
Añade el punto de datos point a la serie.
Esta es una función sobrecargada.
const QPointF &QXYSeries::at(int index) const
Devuelve el punto de datos situado en la posición especificada por ` index ` en la serie interna de puntos.
[signal] void QXYSeries::bestFitLineColorChanged(const QColor &color)
Esta señal se emite cuando el color utilizado para la línea de mejor ajuste cambia a color.
Nota: Señalde notificación para la propiedad « bestFitLineColor ».
[since 6.2] QPair<qreal, qreal> QXYSeries::bestFitLineEquation(bool &ok) const
Devuelve un par de números, siendo el primero el factor de pendiente y el segundo el punto de intersección de una función lineal que representa la línea de mejor ajuste.
Estos factores se calculan mediante el método de mínimos cuadrados a partir de los puntos pasados a la serie.
El parámetro « ok » se utiliza para indicar un error estableciendo su valor en « false » y para indicar un éxito estableciendo su valor en « true ».
Esta función se introdujo en Qt 6.2.
Véase también ` QXYSeries::bestFitLineVisible()`.
[signal] void QXYSeries::bestFitLineVisibilityChanged(bool visible)
Esta señal se emite cuando la visibilidad de la línea de mejor ajuste cambia a « visible ».
Nota: Señalde notificación para la propiedad « bestFitLineVisible ».
QBrush QXYSeries::brush() const
Devuelve el pincel utilizado para rellenar los puntos de datos de la serie.
Véase también setBrush().
void QXYSeries::clear()
Elimina todos los puntos de la serie.
Véase también pointsRemoved().
[since 6.2] void QXYSeries::clearPointConfiguration(const int index)
Elimina la configuración de un punto situado en index y restaura el aspecto predeterminado derivado de los ajustes de la serie.
Nota: No afectaa la configuración de otros puntos.
Esta función se introdujo en Qt 6.2.
Véase también clearPointsConfiguration() y setPointConfiguration().
[since 6.2] void QXYSeries::clearPointConfiguration(const int index, const QXYSeries::PointConfiguration key)
Elimina la propiedad de configuración identificada por key del punto situado en index y restaura el aspecto predeterminado derivado de la configuración de la serie.
Elimina el tipo de configuración, como el color o el tamaño, especificado por key del punto situado en index con personalizaciones de configuración, lo que permite que dicha propiedad de configuración se represente según el valor predeterminado especificado en las propiedades de la serie.
Nota: No afectaa la configuración de otros puntos.
Esta función se introdujo en Qt 6.2.
Véase también clearPointsConfiguration() y setPointConfiguration().
[since 6.2] void QXYSeries::clearPointsConfiguration()
Elimina la configuración de todos los puntos de la serie y restaura el aspecto predeterminado derivado de los ajustes de la serie.
Esta función se introdujo en Qt 6.2.
Véase también setPointConfiguration().
[since 6.2] void QXYSeries::clearPointsConfiguration(const QXYSeries::PointConfiguration key)
Elimina la propiedad de configuración identificada por « key » de todos los puntos y restaura el aspecto predeterminado derivado de la configuración de la serie.
Elimina el tipo de configuración, como el color o el tamaño, especificado por key de todos los puntos con personalizaciones de configuración, lo que permite que dicha propiedad de configuración se represente según el valor por defecto especificado en las propiedades de la serie.
Esta función se introdujo en Qt 6.2.
Véase también clearPointsConfiguration() y setPointConfiguration().
[signal] void QXYSeries::clicked(const QPointF &point)
Esta señal se emite cuando el usuario activa un evento del ratón al hacer clic en el punto point del gráfico.
Véase también pressed(), released() y doubleClicked().
[since 6.2] void QXYSeries::colorBy(const QList<qreal> &sourceData, const QLinearGradient &gradient = QLinearGradient())
Establece el color de los puntos según una lista de valores pasada como parámetro. Los valores de sourceData se ordenan y se asignan a gradient.
Si la serie tiene un QColorAxis asociado, se utilizará un degradado procedente de dicho eje.
Esta función se introdujo en Qt 6.2.
Véase también setPointConfiguration(), pointConfiguration() y QColorAxis.
[signal] void QXYSeries::colorChanged(QColor color)
Esta señal se emite cuando el color de la línea (pluma) cambia a color.
Nota: Señalde notificación para la propiedad « color ».
int QXYSeries::count() const
Devuelve el número de puntos de datos de una serie.
[since 6.2] void QXYSeries::deselectAllPoints()
Deselecciona todos los puntos de la serie.
Nota: Emite QXYSeries::selectedPointsChanged
Esta función se introdujo en Qt 6.2.
Véase también setPointSelected().
[since 6.2] void QXYSeries::deselectPoint(int index)
Deselecciona el punto situado en la coordenada dada index.
Nota: Emite QXYSeries::selectedPointsChanged
Esta función se introdujo en Qt 6.2.
Véase también setPointSelected().
[since 6.2] void QXYSeries::deselectPoints(const QList<int> &indexes)
Marca como deseleccionados varios elementos de una lista « indexes ».
Nota: Emite QXYSeries::selectedPointsChanged
Esta función se introdujo en Qt 6.2.
Véase también ` setPointSelected()`.
[signal] void QXYSeries::doubleClicked(const QPointF &point)
Esta señal se emite cuando el usuario hace doble clic en el punto de datos point del gráfico. El point es el punto en el que se activó la primera pulsación.
Véanse también pressed(), released() y clicked().
[signal] void QXYSeries::hovered(const QPointF &point, bool state)
Esta señal se emite cuando se pasa el ratón por encima del punto point en el gráfico. Cuando el ratón se desplaza sobre el punto, state cambia a true, y cuando el ratón se aleja de nuevo, cambia a false.
void QXYSeries::insert(int index, const QPointF &point)
Inserta el punto de datos point en la serie, en la posición especificada por index.
Véase también pointAdded().
[since 6.2] bool QXYSeries::isPointSelected(int index)
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.
Esta función se introdujo en Qt 6.2.
Véase también selectedPoints(), setPointSelected() y setSelectedColor().
[since 6.2] const QImage &QXYSeries::lightMarker() const
Obtiene la imagen utilizada para dibujar marcadores en cada punto de la serie.
El valor por defecto es QImage(), lo que significa que no se dibujará ningún marcador de luz.
Los marcadores de luz visualizan los puntos de datos de esta serie y, como tales, son una alternativa a setPointsVisible(true). Ambas funciones se pueden activar de forma independiente entre sí.
A diferencia de los elementos de QScatterSeries, los marcadores luminosos no están representados por QGraphicsItem, sino que simplemente se dibujan (no se crean objetos). Sin embargo, las señales de eventos del ratón de QXYSeries se comportan de la misma manera, lo que significa que obtendrás el valor exacto del dominio del punto si haces clic, pulsas o pasas el cursor por encima del marcador luminoso. Si haces clic en la línea, seguirás obteniendo el valor intermedio del dominio. Los marcadores luminosos se sitúan por encima de la línea, tanto en lo que respecta al dibujo como a los eventos.
Esta función se introdujo en Qt 6.2.
Véase también QXYSeries::setLightMarker().
[signal, since 6.2] void QXYSeries::lightMarkerChanged(const QImage &lightMarker)
Esta señal se emite cuando la imagen del marcador luminoso cambia a lightMarker.
Esta función se introdujo en Qt 6.2.
Véase también QXYSeries::setLightMarker().
[since 6.2] qreal QXYSeries::markerSize() const
Obtiene el tamaño del marcador utilizado para representar los puntos de la serie.
El tamaño por defecto depende del tipo específico de « QXYSeries ». QScatterSeries tiene un valor por defecto de 15,0; QLineSeries tiene un valor por defecto igual al tamaño del trazo de la serie multiplicado por 1,5.
Esta función se introdujo en Qt 6.2.
Véase también setMarkerSize() y QScatterSeries::markerSize.
[signal] void QXYSeries::markerSizeChanged(qreal size)
Esta señal se emite cuando el tamaño del marcador cambia a size.
QPen QXYSeries::pen() const
Devuelve el lápiz utilizado para dibujar el contorno de los puntos de datos de la serie.
Véase también setPen().
[signal] void QXYSeries::penChanged(const QPen &pen)
Esta señal se emite cuando el bolígrafo cambia a « pen ».
[signal] void QXYSeries::pointAdded(int index)
Esta señal se emite cuando se añade un punto en la posición especificada por index.
Véanse también append() y insert().
[since 6.2] QHash<QXYSeries::PointConfiguration, QVariant> QXYSeries::pointConfiguration(const int index) const
Devuelve un mapa que representa la configuración de un punto en index.
Con la configuración de puntos puedes modificar diversos aspectos del aspecto de cada punto.
Esta función se introdujo en Qt 6.2.
Véase también setPointConfiguration().
[signal] void QXYSeries::pointLabelsClippingChanged(bool clipping)
Esta señal se emite cuando el recorte de las etiquetas de los puntos de datos cambia a « clipping ».
Nota: Señalde notificación para la propiedad « pointLabelsClipping ».
[signal] void QXYSeries::pointLabelsColorChanged(const QColor &color)
Esta señal se emite cuando el color utilizado para las etiquetas de los puntos de datos cambia a color.
Nota: Señalde notificación para la propiedad « pointLabelsColor ».
[signal] void QXYSeries::pointLabelsFontChanged(const QFont &font)
Esta señal se emite cuando la fuente utilizada para las etiquetas de los puntos de datos cambia a « font ».
Nota: Señalde notificación para la propiedad « pointLabelsFont ».
[signal] void QXYSeries::pointLabelsFormatChanged(const QString &format)
Esta señal se emite cuando el formato de las etiquetas de los puntos de datos cambia a format.
Nota: Señalde notificación para la propiedad « pointLabelsFormat ».
[signal] void QXYSeries::pointLabelsVisibilityChanged(bool visible)
Esta señal se emite cuando la visibilidad de las etiquetas de los puntos de datos cambia a « visible ».
Nota: Señalde notificación para la propiedad « pointLabelsVisible ».
[signal] void QXYSeries::pointRemoved(int index)
Esta señal se emite cuando se elimina un punto de la posición especificada por index.
Véase también remove().
[signal] void QXYSeries::pointReplaced(int 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.
[since 6.2] QXYSeries::PointsConfigurationHash QXYSeries::pointsConfiguration() const
Devuelve un mapa en el que las claves son los índices de los puntos y los valores, la configuración de dichos puntos.
Esta función se introdujo en Qt 6.2.
Véase también setPointsConfiguration(), setPointConfiguration() y pointConfiguration().
[signal] void QXYSeries::pointsRemoved(int index, int count)
Esta señal se emite cuando se eliminan el número de puntos especificado en count, comenzando por la posición indicada en index.
Véanse también removePoints() y clear().
[signal] void QXYSeries::pointsReplaced()
Esta señal se emite cuando todos los puntos se sustituyen por otros puntos.
Véase también replace().
[signal] void QXYSeries::pressed(const QPointF &point)
Esta señal se emite cuando el usuario pulsa sobre el punto de datos point en el gráfico y mantiene pulsado el botón del ratón.
Véase también clicked(), released() y doubleClicked().
[signal] void QXYSeries::released(const QPointF &point)
Esta señal se emite cuando el usuario suelta el botón del ratón sobre el punto de datos especificado por point.
Véanse también pressed(), clicked() y doubleClicked().
void QXYSeries::remove(const QPointF &point)
Elimina el dato point de la serie.
Véase también pointRemoved().
void QXYSeries::remove(int index)
Elimina de la serie el punto situado en la posición especificada por index.
Véase también pointRemoved().
void QXYSeries::remove(qreal x, qreal y)
Elimina de la serie el punto cuyas coordenadas son x y y.
Véase también pointRemoved().
void QXYSeries::removePoints(int index, int count)
Elimina el número de puntos especificado en count de la serie a partir de la posición indicada en index.
Véase también pointsRemoved().
void QXYSeries::replace(const QList<QPointF> &points)
Sustituye los puntos actuales por los puntos especificados en 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 QXYSeries::pointsReplaced() cuando se han sustituido los puntos.
Véase también ` pointsReplaced()`.
void QXYSeries::replace(const QPointF &oldPoint, const QPointF &newPoint)
Sustituye el punto indicado en oldPoint por el indicado en newPoint.
Véase también pointReplaced().
void QXYSeries::replace(int index, const QPointF &newPoint)
Sustituye el punto situado en la posición especificada por index por el punto especificado por newPoint.
Véase también pointReplaced().
void QXYSeries::replace(int 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.
Véase también pointReplaced().
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.
Véase también pointReplaced().
[since 6.2] void QXYSeries::selectAllPoints()
Marca todos los puntos de la serie como seleccionados,
Nota: Emite QXYSeries::selectedPointsChanged
Esta función se introdujo en Qt 6.2.
Véase también setPointSelected().
[since 6.2] void QXYSeries::selectPoint(int index)
Las marcas indican que index es la opción seleccionada.
Nota: Emite QXYSeries::selectedPointsChanged
Esta función se introdujo en Qt 6.2.
Véase también setPointSelected().
[since 6.2] void QXYSeries::selectPoints(const QList<int> &indexes)
Marca como seleccionados varios elementos de una lista « indexes ».
Nota: Emite QXYSeries::selectedPointsChanged
Esta función se introdujo en Qt 6.2.
Véase también setPointSelected().
[signal] void QXYSeries::selectedColorChanged(const QColor &color)
Esta señal se emite cuando el color de los puntos seleccionados cambia a color.
Nota: Señalde notificación para la propiedad « selectedColor ».
[since 6.2] const QImage &QXYSeries::selectedLightMarker() const
Devuelve la imagen utilizada para dibujar marcadores en los puntos de las series seleccionadas.
El valor por defecto es QImage(), lo que significa que se dibujará el marcador habitual « lightMarker »().
Esto equivale a ` selectedColor ` si prefieres marcadores claros en lugar de puntos normales, pero aún así quieres distinguir los puntos seleccionados.
Esta función se introdujo en Qt 6.2.
Véase también setSelectedLightMarker(), lightMarker(), selectedColor y setPointSelected().
[since 6.2] QList<int> 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.
Esta función se introdujo en Qt 6.2.
Véase también setPointSelected() y pointsVisible().
[signal] void QXYSeries::selectedPointsChanged()
Esta señal se emite cuando cambia la selección de puntos.
[virtual] void QXYSeries::setBrush(const QBrush &brush)
Establece el pincel utilizado para dibujar puntos en el gráfico en « brush ». Si no se define el pincel, se utiliza el pincel de la configuración del tema del gráfico.
Véase también brush() y QChart::setTheme().
[since 6.2] void QXYSeries::setLightMarker(const QImage &lightMarker)
Establece la imagen que se utiliza para dibujar marcadores en cada punto de la serie como valor de ` lightMarker`.
El valor por defecto es un `default-QImage()` (`QImage::isNull()` == `true`), lo que significa que no se dibujará ningún marcador de luz. Se puede restablecer el valor por defecto (desactivado) llamando a esta función con un ` QImage ` nulo (`QImage()`).
Los marcadores luminosos visualizan los puntos de datos de esta serie y, como tales, son una alternativa a ` setPointsVisible(true)`. Si se establece un marcador luminoso con este método, no se muestran los puntos visibles definidos con ` setPointsVisible(true) `.
A diferencia de los elementos de QScatterSeries, los marcadores luminosos no están representados por QGraphicsItem, sino que simplemente se dibujan (no se crean objetos). Sin embargo, las señales de eventos del ratón de QXYSeries se comportan de la misma manera, lo que significa que obtendrás el valor exacto del dominio del punto si haces clic, pulsas o pasas el cursor por encima del marcador luminoso. Si haces clic en la línea, seguirás obteniendo el valor intermedio del dominio. Los marcadores luminosos se sitúan por encima de la línea, tanto en lo que respecta al trazado como a los eventos.
Esta función se introdujo en Qt 6.2.
Véase también QXYSeries::lightMarker().
[since 6.2] void QXYSeries::setMarkerSize(qreal size)
Establece el valor de « size » del marcador utilizado para representar los puntos de la serie.
El tamaño por defecto es 15,0.
Esta función se introdujo en Qt 6.2.
Véase también QScatterSeries::markerSize.
[virtual] void QXYSeries::setPen(const QPen &pen)
Establece el trazo utilizado para dibujar puntos en el gráfico como « pen ». Si no se define el trazo, se utiliza el trazo del tema del gráfico.
Véase también pen() y QChart::setTheme().
[since 6.2] void QXYSeries::setPointConfiguration(const int index, const QHash<QXYSeries::PointConfiguration, QVariant> &configuration)
Permite personalizar el aspecto de un punto situado en index con el configuration deseado.
Con la configuración de los puntos puedes modificar diversos aspectos del aspecto de cada punto.
La configuración de un punto se representa como un mapa hash con claves QXYSeries::pointConfiguration y valores QVariant. Por ejemplo:
QLineSeries *series = new QLineSeries();
series->setName("Customized series");
series->setPointsVisible(true);
*series << QPointF(0, 6) << QPointF(2, 4) << QPointF(3, 6) << QPointF(7, 4) << QPointF(10, 5)
<< QPointF(11, 1) << QPointF(13, 3) << QPointF(17, 6) << QPointF(18, 3)
<< QPointF(20, 2);
QChart *chart = new QChart();
chart->addSeries(series);
chart->createDefaultAxes();
QHash<QXYSeries::PointConfiguration, QVariant> conf;
conf[QXYSeries::PointConfiguration::Color] = QColor(Qt::red);
conf[QXYSeries::PointConfiguration::Size] = 8;
conf[QXYSeries::PointConfiguration::LabelVisibility] = true;
series->setPointConfiguration(4, conf);
conf.remove(QXYSeries::PointConfiguration::Color);
conf[QXYSeries::PointConfiguration::LabelFormat] = "This Point";
series->setPointConfiguration(6, conf);En este ejemplo, se puede ver una QLineSeries predeterminada con 10 puntos y con la configuración modificada de dos de ellos. Ambos puntos modificados son visiblemente más grandes que los demás, con un aspecto derivado de la configuración de la serie. Por defecto, los puntos no tienen etiquetas, pero el punto del índice 4 tiene una etiqueta gracias a los valores de configuración QXYSeries::PointConfiguration::LabelVisibility y QXYSeries::PointConfiguration::LabelFormat. El punto del índice 6 tiene una etiqueta personalizada «This Point» gracias al valor de configuración QXYSeries::PointConfiguration::LabelFormat. A continuación se muestra un ejemplo de un gráfico creado de esta manera:

Esta función se introdujo en Qt 6.2.
Véase también pointConfiguration(), pointsConfiguration() y clearPointsConfiguration().
[since 6.2] void QXYSeries::setPointConfiguration(const int index, const QXYSeries::PointConfiguration key, const QVariant &value)
Permite personalizar un aspecto concreto de la configuración de un punto.
Nota: El concepto de configuraciónde puntos ofrece una forma flexible de configurar diversos aspectos de la apariencia de un punto. Por lo tanto, los valores deben tener un tipo elástico, como « QVariant ». Consulte QXYSeries::PointConfiguration para ver qué valor de « value » debe pasarse para determinados « key ».
Esta función se introdujo en Qt 6.2.
Véase también pointsConfiguration().
[since 6.2] void QXYSeries::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
Esta función se introdujo en Qt 6.2.
Véase también isPointSelected(), setPointSelected() y setSelectedColor().
[since 6.2] void QXYSeries::setPointsConfiguration(const QHash<int, QHash<QXYSeries::PointConfiguration, QVariant>> &pointsConfiguration)
Permite personalizar la configuración de varios puntos tal y como se especifica en pointsConfiguration.
Esta función se introdujo en Qt 6.2.
Véase también pointsConfiguration().
[since 6.2] void QXYSeries::setSelectedLightMarker(const QImage &selectedLightMarker)
Establece la imagen que se utiliza para dibujar marcadores en los puntos de la serie seleccionada como ` selectedLightMarker`.
El valor por defecto es QImage(), lo que significa que se dibujarán los marcadores habituales lightMarker().
Esto equivale a ` selectedColor ` si prefieres marcadores claros en lugar de puntos normales, pero aún así quieres distinguir los puntos seleccionados.
Esta función se introdujo en Qt 6.2.
Véase también selectedLightMarker(), lightMarker(), selectedColor y setPointSelected().
[since 6.2] void QXYSeries::sizeBy(const QList<qreal> &sourceData, const qreal minSize, const qreal maxSize)
Establece el tamaño de los puntos según una lista de valores pasada como parámetro. Los valores de sourceData se ordenan y se asignan a un tamaño de punto comprendido entre minSize y maxSize.
Nota: Si la longitud de sourceData es menor que el número de puntos de la serie, el tamaño de los puntos al final de la serie se mantendrá igual.
Esta función se introdujo en Qt 6.2.
Véase también setPointConfiguration() y pointConfiguration().
[since 6.2] void QXYSeries::toggleSelection(const QList<int> &indexes)
Cambia el estado de selección de los puntos en una « indexes » determinada al estado opuesto. Hace que
Nota: Emite QXYSeries::selectedPointsChanged
Esta función se introdujo en Qt 6.2.
Véase también setPointSelected().
QXYSeries &QXYSeries::operator<<(const QList<QPointF> &points)
Operador de flujo para añadir a la serie la lista de puntos de datos especificada por points.
Véase también ` append()`.
QXYSeries &QXYSeries::operator<<(const QPointF &point)
Operador de flujo para añadir el punto de datos point a la serie.
Véase también append().
© 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.