이 페이지에서

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)

상세 설명

산점도 데이터는 차트 상에 점의 집합으로 표시됩니다. 각 점에 대해 수평축과 수직축상의 위치를 결정하는 두 개의 값이 지정됩니다.

세 개의 시계열 데이터를 원, 사각형, 별 모양의 마커로 표시하여 그래프 전체에 흩뿌려진 형태로 나타낸 산점도

다음 코드 예제는 기본적인 산점도를 만드는 방법을 보여줍니다:

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.