이 페이지에서

QAreaSeries Class

QAreaSeries 클래스는 데이터를 면적 차트로 표시합니다. 더 보기...

Header: #include <QAreaSeries>
In QML: AreaSeries
Inherits: QAbstractSeries
Status: Deprecated

이 클래스는 더 이상 사용되지 않습니다. 새로운 코드에서는 이 클래스를 사용하지 않는 것을 강력히 권장합니다.

속성

공개 함수

QAreaSeries(QObject *parent = nullptr)
QAreaSeries(QLineSeries *upperSeries, QLineSeries *lowerSeries = nullptr)
virtual ~QAreaSeries()
QColor borderColor() const
QBrush brush() const
QColor color() const
QLineSeries *lowerSeries() const
QPen pen() const
bool pointLabelsClipping() const
QColor pointLabelsColor() const
QFont pointLabelsFont() const
QString pointLabelsFormat() const
bool pointLabelsVisible() const
bool pointsVisible() const
void setBorderColor(const QColor &color)
void setBrush(const QBrush &brush)
void setColor(const QColor &color)
void setLowerSeries(QLineSeries *series)
void setPen(const QPen &pen)
void setPointLabelsClipping(bool enabled = true)
void setPointLabelsColor(const QColor &color)
void setPointLabelsFont(const QFont &font)
void setPointLabelsFormat(const QString &format)
void setPointLabelsVisible(bool visible = true)
void setPointsVisible(bool visible = true)
void setUpperSeries(QLineSeries *series)
QLineSeries *upperSeries() const

재구현된 공용 함수

virtual QAbstractSeries::SeriesType type() const override

신호

void borderColorChanged(QColor color)
void clicked(const QPointF &point)
void colorChanged(QColor color)
void doubleClicked(const QPointF &point)
void hovered(const QPointF &point, bool state)
void pointLabelsClippingChanged(bool clipping)
void pointLabelsColorChanged(const QColor &color)
void pointLabelsFontChanged(const QFont &font)
void pointLabelsFormatChanged(const QString &format)
void pointLabelsVisibilityChanged(bool visible)
void pressed(const QPointF &point)
void released(const QPointF &point)

상세 설명

면적 시리즈는 정량적 데이터를 표시하는 데 사용됩니다. 이 시리즈는 경계선 사이의 면적을 색상으로 강조한다는 점에서 선 시리즈를 기반으로 합니다. 면적 시리즈는 선 시리즈를 기반으로 하므로, QAreaSeries 생성자에는 면적의 상단 경계를 정의하는 QLineSeries 인스턴스가 필요합니다. 영역 차트는 기본적으로 플롯 영역의 하단을 하단 경계로 사용하여 그려집니다. 플롯 영역의 하단 대신 다른 선을 하단 경계로 지정할 수도 있습니다. 이 경우, QAreaSeries는 두 개의 ` QLineSeries ` 인스턴스로 초기화되어야 합니다.

참고: 하한값이 상한값보다 큰 경우, ‘상한’과 ‘하한’이라는용어가 오해를 불러일으킬 수 있습니다. 중요한 점은 이 두 경계선 사이의 영역이 채워진다는 것입니다.

간단한 면적 차트를 만드는 방법은 ‘위젯이 포함된 차트 갤러리’를 참조하십시오.

영역 차트 예시 스크린샷

속성 설명서

borderColor : QColor

이 속성은 시계의 선(펜) 색상을 지정합니다. 이 속성은 펜 색상을 수정하기 위한 편의 속성입니다.

액세스 함수:

QColor borderColor() const
void setBorderColor(const QColor &color)

알림 신호:

void borderColorChanged(QColor color)

QAreaSeries::pen()도 참조하십시오 .

color : QColor

이 속성은 시리즈의 채우기(브러시) 색상을 지정합니다. 이 속성은 브러시의 색상을 수정하기 위한 편의 속성입니다.

액세스 함수:

QColor color() const
void setColor(const QColor &color)

알림 신호:

void colorChanged(QColor color)

QAreaSeries::brush()도 참조하십시오 .

[read-only] lowerSeries : QLineSeries*

이 속성은 면 시리즈의 경계를 정의하는 데 사용되는 두 선 시리즈 중 더 낮은 쪽을 저장합니다.

참고: ` QAreaSeries `가 `lowerSeries` 없이 생성된경우 , 이 값은 `null`입니다.

액세스 함수:

QLineSeries *lowerSeries() const

pointLabelsClipping : bool

이 속성은 데이터 포인트 레이블에 대한 클리핑을 설정합니다. 기본값은 True입니다. 클리핑이 활성화되면 플롯 영역 가장자리에 있는 레이블이 잘립니다.

액세스 함수:

bool pointLabelsClipping() const
void setPointLabelsClipping(bool enabled = true)

알림 신호:

void pointLabelsClippingChanged(bool clipping)

pointLabelsVisible도 참조하십시오 .

pointLabelsColor : QColor

이 속성은 데이터 포인트 레이블에 사용되는 색상을 지정합니다. 기본적으로 이 색상은 테마에서 레이블용으로 정의된 브러시의 색상입니다.

액세스 함수:

QColor pointLabelsColor() const
void setPointLabelsColor(const QColor &color)

알림 신호:

void pointLabelsColorChanged(const QColor &color)

참조: QAreaSeries::pointLabelsFormat.

pointLabelsFont : QFont

이 속성은 데이터 포인트 레이블에 사용되는 글꼴을 지정합니다.

액세스 함수:

QFont pointLabelsFont() const
void setPointLabelsFont(const QFont &font)

알림 신호:

void pointLabelsFontChanged(const QFont &font)

QAreaSeries::pointLabelsFormat도 참조하십시오 .

pointLabelsFormat : QString

이 속성은 시리즈 데이터 포인트와 함께 레이블을 표시할 때 사용되는 서식을 지정합니다.

QAreaSeries 다음과 같은 서식 태그를 지원합니다:

@xPoint데이터 포인트의 x값
@yPoint데이터 포인트의 y 값

예를 들어, 다음처럼 포맷 태그를 사용하면 괄호 안에 쉼표로 구분된 데이터 포인트 (x, y)가 포함된 레이블이 생성됩니다:

series->setPointLabelsFormat("(@xPoint, @yPoint)");

기본적으로 레이블 형식은 ` @xPoint, @yPoint`로 설정되어 있습니다. 레이블은 플롯 영역 내에 표시되며, 플롯 영역 가장자리에 위치한 레이블은 잘립니다. 데이터 포인트가 서로 가까이 위치해 있으면 레이블이 겹칠 수 있습니다.

액세스 함수:

QString pointLabelsFormat() const
void setPointLabelsFormat(const QString &format)

알림 신호:

void pointLabelsFormatChanged(const QString &format)

QAreaSeries::pointLabelsVisible, QAreaSeries::pointLabelsFont 및 QAreaSeries::pointLabelsColor도 참조하십시오 .

pointLabelsVisible : bool

이 속성은 데이터 포인트 레이블의 표시 여부를 결정합니다. 기본값은 False입니다.

액세스 함수:

bool pointLabelsVisible() const
void setPointLabelsVisible(bool visible = true)

알림 신호:

void pointLabelsVisibilityChanged(bool visible)

QAreaSeries::pointLabelsFormat 및 QAreaSeries::pointLabelsClipping도 참조하십시오 .

[read-only] upperSeries : QLineSeries*

이 속성은 영역 시리즈의 경계를 정의하는 데 사용되는 두 개의 선 시리즈 중 위쪽에 있는 시리즈를 나타냅니다.

액세스 함수:

QLineSeries *upperSeries() const

멤버 함수 설명서

[explicit] QAreaSeries::QAreaSeries(QObject *parent = nullptr)

parent 객체를 사용하여 상한 또는 하한 시리즈가 없는 영역 시리즈 객체를 생성합니다.

[explicit] QAreaSeries::QAreaSeries(QLineSeries *upperSeries, QLineSeries *lowerSeries = nullptr)

upperSeries 선과 lowerSeries 선 사이에 걸쳐지는 면적 시계열 객체를 생성합니다. 생성자에 lowerSeries 가 전달되지 않으면, 대신 x축이 하한으로 사용됩니다.

QAreaSeries는 상단 또는 하단 시리즈를 소유하지 않으며, 소유권은 호출자에게 남아 있습니다. 시리즈 객체가 QChartView 또는 QChart에 추가되면 인스턴스 소유권이 이전됩니다.

[virtual noexcept] QAreaSeries::~QAreaSeries()

객체를 삭제합니다.

[signal] void QAreaSeries::borderColorChanged(QColor color)

이 신호는 선(펜) 색상이 color 로 변경될 때 발생합니다.

참고: 속성 borderColor 에 대한알림 신호입니다.

QBrush QAreaSeries::brush() const

이 시리즈의 선을 그리는 데 사용된 브러시를 반환합니다.

setBrush()도 참조하십시오 .

[signal] void QAreaSeries::clicked(const QPointF &point)

사용자가 영역 차트에서 ‘ point ’을 클릭하여 이 신호를 발생시킵니다.

pressed, released 및 doubleClicked도 참조하십시오 .

[signal] void QAreaSeries::colorChanged(QColor color)

이 신호는 채우기(브러시) 색상이 color 로 변경될 때 발생합니다.

참고: 속성 color 에 대한알림 신호입니다.

[signal] void QAreaSeries::doubleClicked(const QPointF &point)

이 신호는 사용자가 영역 차트에서 point 을 더블클릭하여 첫 번째 클릭을 유발할 때 발생합니다.

pressed, released 및 clicked도 참조하십시오 .

[signal] void QAreaSeries::hovered(const QPointF &point, bool state)

이 신호는 사용자가 마우스 커서를 시리즈 위로 가져가거나 시리즈에서 멀리 이동할 때 발생합니다. ` point `는 호버 이벤트의 발생 위치(좌표)를 나타냅니다. ` state `는 커서가 시리즈 위로 이동해 있을 때는 ` true `이며, 시리즈에서 멀어지면 `false `로 바뀝니다.

QPen QAreaSeries::pen() const

이 시퀀스의 선을 그리는 데 사용된 펜을 반환합니다.

setPen()도 참조하십시오 .

[signal] void QAreaSeries::pointLabelsClippingChanged(bool clipping)

이 신호는 데이터 포인트 레이블의 클리핑이 ‘ clipping ’로 변경될 때 발생합니다.

참고: 속성 ` pointLabelsClipping`에 대한알림 신호입니다.

[signal] void QAreaSeries::pointLabelsColorChanged(const QColor &color)

이 신호는 데이터 포인트 레이블에 사용된 색상이 ‘ color ’로 변경될 때 발생합니다.

참고: 속성 pointLabelsColor 에 대한알림 신호입니다.

[signal] void QAreaSeries::pointLabelsFontChanged(const QFont &font)

이 신호는 데이터 포인트 레이블에 사용되는 글꼴이 ‘ font ’로 변경될 때 발생합니다.

참고: 속성 ` pointLabelsFont`에 대한알림 신호입니다.

[signal] void QAreaSeries::pointLabelsFormatChanged(const QString &format)

이 신호는 데이터 포인트 레이블의 ` format ` 속성이 변경될 때 발생합니다.

참고: 속성 ` pointLabelsFormat`에 대한알림 신호입니다.

[signal] void QAreaSeries::pointLabelsVisibilityChanged(bool visible)

이 신호는 데이터 포인트 레이블의 가시성이 ‘ visible ’로 변경될 때 발생합니다.

참고: pointLabelsVisible 속성에 대한알림 신호입니다.

bool QAreaSeries::pointsVisible() const

이 시리즈에 대해 점이 그려지는지 여부를 반환합니다.

setPointsVisible()도 참조하십시오 .

[signal] void QAreaSeries::pressed(const QPointF &point)

이 신호는 사용자가 영역 차트에서 point 로 지정된 지점을 클릭할 때 발생합니다.

clicked, released 및 doubleClicked도 참조하십시오 .

[signal] void QAreaSeries::released(const QPointF &point)

이 신호는 사용자가 영역 차트의 ‘ point ’에서 트리거된 누름 동작을 손을 떼면 발생합니다.

pressed, clicked 및 doubleClicked도 참조하십시오 .

void QAreaSeries::setBrush(const QBrush &brush)

영역을 채우는 데 사용되는 brush 를 설정합니다.

brush()도 참조하십시오 .

void QAreaSeries::setLowerSeries(QLineSeries *series)

영역 차트의 하위 계열로 사용할 series 을 설정합니다.

lowerSeries()도 참조하십시오 .

void QAreaSeries::setPen(const QPen &pen)

영역의 윤곽선을 그리는 데 사용되는 pen 를 설정합니다.

pen()도 참조하십시오 .

void QAreaSeries::setPointsVisible(bool visible = true)

데이터 포인트가 ‘ visible ’인지, 즉 선 위에 표시되어야 하는지 여부를 결정합니다.

pointsVisible()도 참조하십시오 .

void QAreaSeries::setUpperSeries(QLineSeries *series)

영역 차트의 상단 시리즈로 사용할 series 를 설정합니다. 상단 시리즈가 null인 경우, 하단 시리즈가 있더라도 영역 차트는 그려지지 않습니다.

upperSeries()도 참조하십시오 .

[override virtual] QAbstractSeries::SeriesType QAreaSeries::type() const

QAbstractSeries::type 속성에 대한 액세스 함수를 재구현합니다.

QAbstractSeries::SeriesTypeArea 를 반환합니다.

© 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.