QAreaSeries Class

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

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

속성

공용 함수

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* const

이 속성은 면적 계열 경계를 정의하는 데 사용되는 두 개의 선 계열 중 아래쪽 계열을 보유합니다.

참고: QAreaSeries 가 lowerSeries 없이 구성된 경우 이 속성은 null입니다.

함수에 액세스합니다:

QLineSeries *lowerSeries() const

pointLabelsClipping : bool

이 속성은 데이터 요소 레이블에 대한 클리핑을 유지합니다. 기본적으로 참입니다. 클리핑이 활성화되면 플롯 영역 가장자리에 있는 레이블이 잘립니다.

함수에 액세스합니다:

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::pointLabelsFormatQAreaSeries::pointLabelsClipping참조하세요 .

[read-only] upperSeries : QLineSeries* const

이 속성은 영역 계열 경계를 정의하는 데 사용되는 두 선 계열 중 위쪽 계열을 보유합니다.

함수에 액세스합니다:

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 이 되고 시리즈에서 멀어지면 거짓으로 바뀝니다.

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 를 반환합니다.

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