QScatterSeries Class
QScatterSeries 类用于在散点图中展示数据。更多内容...
| Header: | #include <QScatterSeries> |
| In QML: | ScatterSeries |
| Inherits: | QXYSeries |
| Status: | Deprecated |
该类已弃用。我们强烈建议不要在新代码中使用它。
公共类型
| enum | MarkerShape { MarkerShapeCircle, MarkerShapeRectangle, MarkerShapeRotatedRectangle, MarkerShapeTriangle, MarkerShapeStar, MarkerShapePentagon } |
属性
- borderColor : QColor
- brush : QBrush
- markerShape : MarkerShape
- markerSize : qreal
公共函数
| 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) |
重新实现的公共函数
| virtual void | setBrush(const QBrush &brush) override |
| virtual void | setPen(const QPen &pen) override |
| virtual QAbstractSeries::SeriesType | type() const override |
信号
| void | borderColorChanged(QColor color) |
| void | colorChanged(QColor color) |
| void | markerShapeChanged(QScatterSeries::MarkerShape shape) |
| void | markerSizeChanged(qreal size) |
详细说明
散点数据在图表上以一组点的形式显示。对于每个点，需指定两个值，用于确定其在横轴和纵轴上的位置。
以下代码片段演示了如何创建一个基本的散点图：
QScatterSeries* series = new QScatterSeries();
series->append(0, 6);
series->append(2, 4);
...
chart->addSeries(series);有关更多信息，请参阅“带小部件的图表示例库”和“创建散点图”。
成员类型文档
enum QScatterSeries::MarkerShape
此枚举值描述了渲染标记项时使用的形状。
| 常量 | 值 | 描述 |
|---|---|---|
QScatterSeries::MarkerShapeCircle | 0 | 标记为圆形。这是默认值。 |
QScatterSeries::MarkerShapeRectangle | 1 | 标记为矩形。 |
QScatterSeries::MarkerShapeRotatedRectangle | 2 | 标记为一个旋转的矩形。 |
QScatterSeries::MarkerShapeTriangle | 3 | 标记为三角形。 |
QScatterSeries::MarkerShapeStar | 4 | 标记为星形。 |
QScatterSeries::MarkerShapePentagon | 5 | 标记为五边形。 |
属性文档
borderColor : QColor
该属性用于指定绘制标记边框时使用的颜色。
这是一个用于修改笔色的便捷属性。
访问函数：
| QColor | borderColor() const |
| void | setBorderColor(const QColor &color) |
通知信号：
| void | borderColorChanged(QColor color) |
另请参阅 QScatterSeries::pen()。
brush : QBrush
该属性存储用于绘制散点图系列标记的画笔。
该画笔可以是一张图像，例如使用QPainterPath 生成的图像。
访问函数：
| QBrush | brush() const |
| virtual void | setBrush(const QBrush &brush) override |
markerShape : MarkerShape
该属性存储用于渲染该系列中各点的标记的形状。
默认形状为MarkerShapeCircle 。
访问函数：
| QScatterSeries::MarkerShape | markerShape() const |
| void | setMarkerShape(QScatterSeries::MarkerShape shape) |
通知信号：
| void | markerShapeChanged(QScatterSeries::MarkerShape shape) |
另请参阅 MarkerShape 。
markerSize : qreal
该属性存储用于渲染该系列中数据点的标记的大小。
访问函数：
| qreal | markerSize() const |
| void | setMarkerSize(qreal size) |
通知信号：
| void | markerSizeChanged(qreal size) |
另请参阅 QXYSeries::setMarkerSize 。
成员函数文档
[explicit] QScatterSeries::QScatterSeries(QObject *parent = nullptr)
创建一个作为parent 子节点的系列对象。
[virtual noexcept] QScatterSeries::~QScatterSeries()
删除散点图数据系列。
注意：将 数据列添加 到 QChart 后，其所有权将转移至图表。
[signal] void QScatterSeries::borderColorChanged(QColor color)
当线条（笔）颜色变为color 时，会发出此信号。
注意： 这是属性borderColor 的Notifier 信号。
[signal] void QScatterSeries::colorChanged(QColor color)
当填充（画笔）颜色变为color 时，会发出此信号。
[signal] void QScatterSeries::markerShapeChanged(QScatterSeries::MarkerShape shape)
当标记形状变为shape 时，会发出此信号。
注意： 这是属性markerShape的通知器 信号。
[signal] void QScatterSeries::markerSizeChanged(qreal size)
当标记大小变为size 时，会触发此信号。
注意： 这是属性markerSize的通知器 信号。
[override virtual] void QScatterSeries::setBrush(const QBrush &brush)
重写了：QXYSeries::setBrush(const QBrush &brush)。
另请参阅 brush()。
[override virtual] void QScatterSeries::setPen(const QPen &pen)
重写了：QXYSeries::setPen(const QPen &pen)。
[override virtual] QAbstractSeries::SeriesType QScatterSeries::type() const
重新实现了属性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.
