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.
| Constante | Valor | Descripción |
|---|---|---|
QScatterSeries::MarkerShapeCircle | 0 | El marcador es un círculo. Este es el valor por defecto. |
QScatterSeries::MarkerShapeRectangle | 1 | El marcador es un rectángulo. |
QScatterSeries::MarkerShapeRotatedRectangle | 2 | El marcador es un rectángulo girado. |
QScatterSeries::MarkerShapeTriangle | 3 | El marcador es un triángulo. |
QScatterSeries::MarkerShapeStar | 4 | El marcador es una estrella. |
QScatterSeries::MarkerShapePentagon | 5 | El 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.