En esta página

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:

QLineSeries and QScatterSeries

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.

ConstanteValorDescripción
QXYSeries::PointConfiguration::Color0Este 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::Size1Este 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::Visibility2Este 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::LabelVisibility3Este 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)4Este 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:

@indexEl índice del punto de datos en la serie. [desde la versión 6.5]
@xPointLa coordenada x del punto de datos.
@yPointLa 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.

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.

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 ».

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,

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.

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 ».

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:

Captura de pantalla en la que se ve un gráfico de líneas con dos puntos, uno rojo y otro azul

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

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.