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 에 대한알림 신호입니다.
[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.