このページでは

QScatterSeries Class

QScatterSeries クラスは、データを散布図で表示します。詳細...

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

このクラスは非推奨です。新しいコードでの使用は強く推奨しません。

パブリック型

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

プロパティ

パブリック関数

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 つの値が指定されます。

3つの系列を、円、四角、星形のマーカーとしてプロット上に散らして表示する散布図

以下のコードスニペットは、基本的な散布図の作成方法を示しています。

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

詳細については、「ウィジェットギャラリーのチャート」および「散布図の作成」を参照してください。

メンバ型のドキュメント

enum QScatterSeries::MarkerShape

この列挙値は、マーカーアイテムの描画に使用される形状を表します。

定数値説明
QScatterSeries::MarkerShapeCircle0マーカーは円です。これがデフォルト値です。
QScatterSeries::MarkerShapeRectangle1マーカーは長方形です。
QScatterSeries::MarkerShapeRotatedRectangle2マーカーは回転した長方形です。
QScatterSeries::MarkerShapeTriangle3マーカーは三角形です。
QScatterSeries::MarkerShapeStar4マーカーは星形です。
QScatterSeries::MarkerShapePentagon5マーカーは五角形です。

プロパティのドキュメント

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.