En esta página

QScatterSeries Class

La clase QScatterSeries muestra datos en gráficos de dispersión. Más información...

Header: #include <QScatterSeries>
In QML: ScatterSeries
Inherits: QXYSeries
Status: Deprecated

Esta clase está obsoleta. Recomendamos encarecidamente no utilizarla en código nuevo.

Tipos públicos

enum MarkerShape { MarkerShapeCircle, MarkerShapeRectangle, MarkerShapeRotatedRectangle, MarkerShapeTriangle, MarkerShapeStar, MarkerShapePentagon }

Propiedades

Funciones públicas

QScatterSeries(QObject *parent = nullptr)
virtual ~QScatterSeries()
QColor borderColor() const
QBrush brush() const
QScatterSeries::MarkerShape markerShape() const
qreal markerSize() const
void setBorderColor(const QColor &color)
void setMarkerShape(QScatterSeries::MarkerShape shape)
void setMarkerSize(qreal size)

Funciones públicas reimplementadas

virtual void setBrush(const QBrush &brush) override
virtual void setPen(const QPen &pen) override
virtual QAbstractSeries::SeriesType type() const override

Señales

void borderColorChanged(QColor color)
void colorChanged(QColor color)
void markerShapeChanged(QScatterSeries::MarkerShape shape)
void markerSizeChanged(qreal size)

Descripción detallada

Los datos del gráfico de dispersión se muestran como un conjunto de puntos en el gráfico. Para cada punto, se especifican dos valores que determinan su posición en el eje horizontal y en el eje vertical.

Gráfico de dispersión en el que se representan tres series mediante marcadores en forma de círculo, cuadrado y estrella repartidos por todo el gráfico

El siguiente fragmento de código ilustra cómo crear un gráfico de dispersión básico:

QScatterSeries* series = new QScatterSeries();
series->append(0, 6);
series->append(2, 4);
...
chart->addSeries(series);

Para obtener más información, consulta la Galería de gráficos con widgets y Creación de gráficos de dispersión.

Documentación sobre tipos de miembros

enum QScatterSeries::MarkerShape

Este valor de enumeración describe la forma que se utiliza al visualizar los marcadores.

ConstanteValorDescripción
QScatterSeries::MarkerShapeCircle0El marcador es un círculo. Este es el valor por defecto.
QScatterSeries::MarkerShapeRectangle1El marcador es un rectángulo.
QScatterSeries::MarkerShapeRotatedRectangle2El marcador es un rectángulo girado.
QScatterSeries::MarkerShapeTriangle3El marcador es un triángulo.
QScatterSeries::MarkerShapeStar4El marcador es una estrella.
QScatterSeries::MarkerShapePentagon5El marcador es un pentágono.

Documentación de propiedades

borderColor : QColor

Esta propiedad determina el color que se utiliza para dibujar los bordes del marcador.

Se trata de una propiedad de conveniencia para modificar el color del rotulador.

Funciones de acceso:

QColor borderColor() const
void setBorderColor(const QColor &color)

Señal de notificación:

void borderColorChanged(QColor color)

Véase también ` QScatterSeries::pen()`.

brush : QBrush

Esta propiedad contiene el pincel utilizado para dibujar los marcadores de la serie de dispersión.

El pincel puede ser una imagen creada, por ejemplo, con QPainterPath.

Funciones de acceso:

QBrush brush() const
virtual void setBrush(const QBrush &brush) override

markerShape : MarkerShape

Esta propiedad define la forma del marcador que se utiliza para representar los puntos de la serie.

La forma predeterminada es MarkerShapeCircle.

Funciones de acceso:

QScatterSeries::MarkerShape markerShape() const
void setMarkerShape(QScatterSeries::MarkerShape shape)

Señal de notificación:

void markerShapeChanged(QScatterSeries::MarkerShape shape)

Véase también MarkerShape.

markerSize : qreal

Esta propiedad contiene el tamaño del marcador utilizado para representar los puntos de la serie.

Funciones de acceso:

qreal markerSize() const
void setMarkerSize(qreal size)

Señal de notificación:

void markerSizeChanged(qreal size)

Véase también QXYSeries::setMarkerSize.

Documentación de las funciones de miembro

[explicit] QScatterSeries::QScatterSeries(QObject *parent = nullptr)

Crea un objeto de la serie que es un elemento secundario de parent.

[virtual noexcept] QScatterSeries::~QScatterSeries()

Elimina la serie de puntos.

Nota: Al añadir la serie a QChart, la propiedad pasa a recaer en el gráfico.

[signal] void QScatterSeries::borderColorChanged(QColor color)

Esta señal se emite cuando el color de la línea (del trazo) cambia a color.

Nota: Señalde notificación para la propiedad « borderColor ».

[signal] void QScatterSeries::colorChanged(QColor color)

Esta señal se emite cuando el color de relleno (del pincel) cambia a color.

[signal] void QScatterSeries::markerShapeChanged(QScatterSeries::MarkerShape shape)

Esta señal se emite cuando la forma del marcador cambia a shape.

Nota: Señalde notificación para la propiedad « markerShape ».

[signal] void QScatterSeries::markerSizeChanged(qreal size)

Esta señal se emite cuando el tamaño del marcador cambia a size.

Nota: Señalde notificación para la propiedad « markerSize ».

[override virtual] void QScatterSeries::setBrush(const QBrush &brush)

Reimplementa: QXYSeries::setBrush(const QBrush &brush).

Véase también brush().

[override virtual] void QScatterSeries::setPen(const QPen &pen)

Reimplementa: QXYSeries::setPen(const QPen &pen).

[override virtual] QAbstractSeries::SeriesType QScatterSeries::type() const

Reimplementa una función de acceso para la propiedad: QAbstractSeries::type.

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