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) |
詳細な説明
散布図のデータは、チャート上の点の集合として表示されます。各点について、横軸と縦軸上の位置を決定する 2 つの値が指定されます。

以下のコードスニペットは、基本的な散布図の作成方法を示しています。
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 」の通知 シグナルです。
[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.