En esta página

QScatterSeries Class

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

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

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
virtual QColor color() const override
QScatterSeries::MarkerShape markerShape() const
qreal markerSize() const
void setBorderColor(const QColor &color)
virtual void setColor(const QColor &color) override
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 de dispersión se muestran como una colección 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.

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, consulte Galería de gráficos con widgets y Creación de gráficos de dispersión.

Documentación de tipos de miembros

enum QScatterSeries::MarkerShape

Este valor enum describe la forma utilizada al representar los elementos de marcador.

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 contiene el color utilizado para dibujar los bordes del marcador.

Es una propiedad de conveniencia para modificar el color de la pluma.

Funciones de acceso:

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

Señal del notificador:

void borderColorChanged(QColor color)

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

brush : QBrush

Esta propiedad contiene el pincel utilizado para dibujar los marcadores de las series de dispersión.

El pincel puede ser una imagen que se puede crear utilizando QPainterPath, por ejemplo.

Funciones de acceso:

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

color : QColor

Esta propiedad contiene el color utilizado para rellenar los marcadores de la serie.

Es una propiedad de conveniencia para modificar el color del pincel.

Funciones de acceso:

virtual QColor color() const override
virtual void setColor(const QColor &color) override

Señal del notificador:

void colorChanged(QColor color)

Véase también QScatterSeries::brush().

markerShape : MarkerShape

Esta propiedad contiene la forma del marcador utilizado para representar los puntos de la serie.

La forma por defecto es MarkerShapeCircle.

Funciones de acceso:

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

Señal del notificador:

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 del notificador:

void markerSizeChanged(qreal size)

Véase también QXYSeries::setMarkerSize.

Documentación de las funciones miembro

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

Construye un objeto serie hijo de parent.

[virtual noexcept] QScatterSeries::~QScatterSeries()

Elimina la serie de dispersión.

Nota: Al añadir la serie a QChart se transfiere la propiedad al gráfico.

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

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

Nota: Señal notificadora para la propiedad borderColor.

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

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

Nota: Señal notificadora para la propiedad color.

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

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

Nota: Señal notificadora 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ñal notificadora 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.