QXYSeries Class

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 éstas y se eliminan cuando se eliminan las instancias de QChart.

void QXYSeries::append(qreal x, qreal y)

Añade el punto de datos con las coordenadas x y y a la serie.

void QXYSeries::append(const QList<QPointF> &points)

Añade a la serie la lista de puntos de datos especificada por points.

void QXYSeries::append(const QPointF &point)

Añade el punto de datos point a la serie.

const QPointF &QXYSeries::at(int index) const

Devuelve el punto de datos 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.

[since 6.2] QPair<qreal, qreal> QXYSeries::bestFitLineEquation(bool &ok) const

Devuelve un par de números donde el primer número es un factor de pendiente y el segundo número es el intercepto de una función lineal para una línea de mejor ajuste.

Estos factores se calculan utilizando el método de mínimos cuadrados basado en los puntos pasados a la serie.

El parámetro ok se utiliza para informar de un fallo estableciendo su valor en false y para informar de 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.

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 por defecto derivado de la configuración de la serie.

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 en index y restaura el aspecto por defecto 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 en index con personalizaciones de configuración, lo que permite que esa propiedad de configuración se represente como la predeterminada especificada en las propiedades de la serie.

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 la configuración 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 por defecto derivado de la configuración de la serie.

Elimina el tipo de configuración, como color o tamaño, especificado por key de todos los puntos con personalizaciones de configuración, permitiendo que esa propiedad de configuración se renderice como la predeterminada especificada 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 de ratón haciendo 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 de acuerdo con una lista de valores. Los valores de sourceData se ordenan y se asignan a gradient.

Si la serie tiene un QColorAxis adjunto, entonces se usará un gradiente del eje.

Esta función se introdujo en Qt 6.2.

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

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 en 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 múltiples puntos pasados en una lista indexes como deseleccionados.

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. point es el punto en el que se ha producido la primera pulsación.

Véase 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 del gráfico. Cuando el ratón se mueve sobre el punto, state se convierte en true, y cuando el ratón se aleja de nuevo, se convierte en 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 en index está entre los puntos seleccionados y false en caso contrario.

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 pintará ningún marcador de luz.

Los marcadores luminosos visualizan los puntos de datos de esta serie y como tal son una alternativa a setPointsVisible(true). Ambas características pueden activarse independientemente la una de la otra.

A diferencia de los elementos de QScatterSeries, los marcadores luminosos no se representan mediante QGraphicsItem, sino que simplemente se pintan (no se crean objetos). Sin embargo, las señales de evento 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/presionas/sobresaltas el marcador de luz. Seguirás obteniendo el valor de dominio intermedio si haces clic en la línea. Los marcadores luminosos están por encima de la línea tanto en términos de pintura como de 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 del tamaño del lápiz de la serie * 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éase 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 cambiar varios 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.

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

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

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

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

[signal] void QXYSeries::pointRemoved(int index)

Esta señal se emite cuando un punto se retira 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 con los índices de los puntos como claves y la configuración de los puntos como valores.

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 elimina el número de puntos especificado por count a partir de la posición especificada por index.

Véase 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 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 la presión del ratón sobre el punto de datos especificado por point.

Véase también pressed(), clicked(), y doubleClicked().

void QXYSeries::remove(const QPointF &point)

Elimina el punto de datos 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 que tiene las coordenadas x y y.

Véase también pointRemoved().

void QXYSeries::removePoints(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.

Véase también pointsRemoved().

void QXYSeries::replace(const QList<QPointF> &points)

Sustituye los puntos actuales por los especificados en points.

Véase también pointsReplaced().

void QXYSeries::replace(const QPointF &oldPoint, const QPointF &newPoint)

Sustituye el punto especificado por oldPoint por el especificado por newPoint.

Véase también pointReplaced().

void QXYSeries::replace(int index, const QPointF &newPoint)

Sustituye el punto 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 en la posición especificada por index por el punto que tiene las coordenadas 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 hace nada 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)

Marca el punto en index como seleccionado.

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 múltiples puntos pasados en una lista indexes como seleccionados.

Esta función se introdujo en Qt 6.2.

Véase también setPointSelected().

[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 pintará lightMarker() normal.

Esto es equivalente a selectedColor si prefieres marcadores claros sobre puntos normales, pero aún 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 el pincel no está definido, 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 utilizada para dibujar marcadores en cada punto de la serie como el valor de lightMarker.

El valor por defecto es un default-QImage() (QImage::isNull() == true), lo que significa que no se pintará ningún marcador de luz. Puede restablecer el valor predeterminado (desactivado) llamando a esta función con un valor nulo QImage (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 mostrarán los puntos visibles establecidos con setPointsVisible(true).

A diferencia de los elementos de QScatterSeries, los marcadores luminosos no se representan con QGraphicsItem, sino que simplemente se pintan (no se crean objetos). Sin embargo, las señales de evento 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/presionas/sobresaltas el marcador de luz. Seguirás obteniendo el valor de dominio intermedio si haces clic en la línea. Los marcadores luminosos están por encima de la línea tanto en términos de pintura como de 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 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 la pluma utilizada para dibujar puntos en el gráfico en pen. Si la pluma no está definida, se utiliza la pluma 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 la dirección configuration deseada.

Con la configuración de puntos se pueden cambiar varios aspectos de la apariencia de cada punto.

La configuración de un punto se representa como un mapa hash con QXYSeries::pointConfiguration claves y QVariant valores. 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, puede ver un QLineSeries por defecto con 10 puntos y con la configuración cambiada de dos puntos. Ambos puntos cambiados son visiblemente más grandes que los otros con un aspecto derivado de la configuración de la serie. Por defecto, los puntos no tienen etiquetas, pero el punto en el í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 Este punto 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.

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 un punto en index como seleccionado o deseleccionado según se especifique en selected.

Esta función se introdujo en Qt 6.2.

Ver 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 múltiples 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 utilizada para dibujar marcadores en los puntos de la serie seleccionada en selectedLightMarker.

El valor por defecto es QImage(), lo que significa que se pintará lightMarker() normal.

Esto es un equivalente para selectedColor si prefieres marcadores claros sobre puntos normales, pero aún 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 de acuerdo con una lista de valores. Los valores de sourceData se ordenan y se asignan a un tamaño de punto que está entre minSize y maxSize.

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 indexes por el opuesto. Hace

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().