이 페이지에서

QPieSeries Class

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

Header: #include <QPieSeries>
In QML: PieSeries
Inherits: QAbstractSeries
Status: Deprecated

이 클래스는 더 이상 사용되지 않습니다. 새로운 코드에서는 이 클래스를 사용하지 않는 것이 좋습니다.

속성

공개 함수

QPieSeries(QObject *parent = nullptr)
virtual ~QPieSeries()
bool append(QPieSlice *slice)
bool append(const QList<QPieSlice *> &slices)
QPieSlice *append(const QString &label, qreal value)
void clear()
int count() const
qreal holeSize() const
qreal horizontalPosition() const
bool insert(int index, QPieSlice *slice)
bool isEmpty() const
qreal pieEndAngle() const
qreal pieSize() const
qreal pieStartAngle() const
bool remove(QPieSlice *slice)
void setHoleSize(qreal holeSize)
void setHorizontalPosition(qreal relativePosition)
void setLabelsPosition(QPieSlice::LabelPosition position)
void setLabelsVisible(bool visible = true)
void setPieEndAngle(qreal angle)
void setPieSize(qreal relativeSize)
void setPieStartAngle(qreal startAngle)
void setVerticalPosition(qreal relativePosition)
QList<QPieSlice *> slices() const
qreal sum() const
bool take(QPieSlice *slice)
qreal verticalPosition() const
QPieSeries &operator<<(QPieSlice *slice)

재구현된 공용 함수

virtual QAbstractSeries::SeriesType type() const override

신호

void added(const QList<QPieSlice *> &slices)
void clicked(QPieSlice *slice)
void countChanged()
void doubleClicked(QPieSlice *slice)
void hovered(QPieSlice *slice, bool state)
void pressed(QPieSlice *slice)
void released(QPieSlice *slice)
void removed(const QList<QPieSlice *> &slices)
void sumChanged()

상세 설명

파이 시리즈는 ` QPieSlice ` 객체로 정의된 슬라이스로 구성됩니다. `QPieSeries` 객체는 시리즈 내 모든 슬라이스의 합계와 비교하여 각 슬라이스의 백분율을 계산함으로써 차트에서 슬라이스의 실제 크기를 결정하므로, 슬라이스에는 어떤 값이든 지정할 수 있습니다.

차트상의 파이 크기와 위치는 0.0에서 1.0 사이의 상대적 값을 사용하여 제어됩니다. 이 값들은 실제 차트 직사각형과 관련이 있습니다.

기본적으로 파이는 전체 파이로 정의됩니다. 시리즈의 시작 각도와 각도 범위를 설정하여 부분 파이를 만들 수 있습니다. 전체 파이는 360도이며, 0도는 12시 방향에 위치합니다.

QPieSeries 사용 방법을 알아보려면 ‘위젯이 포함된 차트 갤러리’를 참조하십시오.

한 조각이 분리되어 나와 있고 ‘Joe’라고 표시된 원형 차트

단백질, 지방, 기타, 탄수화물 조각으로 구성된 레몬 글레이즈 영양 정보 도넛 차트. 지방 부분이 특히 눈에 띄게 부풀어 올랐다.

QPieSlice 및 QChart도 참조하십시오 .

속성 문서

[read-only] count : int

이 속성은 시리즈의 슬라이스 수를 나타냅니다.

액세스 함수:

int count() const

알림 신호:

void countChanged()

endAngle : qreal

이 속성은 파이의 끝 지점 각도를 나타냅니다.

원형 차트의 전체 각도는 360도이며, 0도는 12시 방향에 해당합니다.

기본값은 360입니다.

액세스 함수:

qreal pieEndAngle() const
void setPieEndAngle(qreal angle)

holeSize : qreal

이 속성은 도넛 구멍의 크기를 나타냅니다.

이 값은 차트 사각형을 기준으로 하므로, 다음과 같습니다.

  • 0.0은 최소 크기(구멍 없이 그려진 전체 파이 차트)입니다.
  • 1.0은 차트에 들어갈 수 있는 최대 크기입니다(도넛의 너비가 없음).

이 속성을 설정하면, 구멍의 크기가 파이 차트의 크기를 초과하지 않도록 필요에 따라 ' size ' 속성이 조정됩니다.

기본값은 0.0입니다.

액세스 함수:

qreal holeSize() const
void setHoleSize(qreal holeSize)

horizontalPosition : qreal

이 속성은 파이 차트의 수평 위치를 지정합니다.

이 값은 차트 사각형을 기준으로 하므로,

  • 0.0은 절대 좌측을 나타냅니다.
  • 1.0은 절대적인 오른쪽 끝입니다.

기본값은 0.5(중앙)입니다.

액세스 함수:

qreal horizontalPosition() const
void setHorizontalPosition(qreal relativePosition)

verticalPosition도 참조하십시오 .

size : qreal

이 속성은 파이 크기를 나타냅니다.

이 값은 차트 사각형을 기준으로 하므로, 다음과 같습니다:

  • 0.0은 최소 크기(파이 차트가 그려지지 않음)입니다.
  • 1.0은 차트에 들어갈 수 있는 최대 크기입니다.

이 속성을 설정할 때, 구멍 크기가 파이 크기보다 커지지 않도록 필요에 따라 ` holeSize ` 속성이 조정됩니다.

기본값은 0.7입니다.

액세스 함수:

qreal pieSize() const
void setPieSize(qreal relativeSize)

startAngle : qreal

이 속성은 파이의 시작 각도를 나타냅니다.

원형 차트의 전체 각도는 360도이며, 0도는 12시 방향에 해당합니다.

기본값은 0입니다.

액세스 함수:

qreal pieStartAngle() const
void setPieStartAngle(qreal startAngle)

[read-only] sum : qreal

이 속성은 모든 슬라이스의 합계를 저장합니다.

이 시리즈는 포함된 모든 슬라이스의 합계를 추적합니다.

액세스 함수:

qreal sum() const

알림 신호:

void sumChanged()

verticalPosition : qreal

이 속성은 파이 차트의 수직 위치를 지정합니다.

이 값은 차트 사각형을 기준으로 하므로, 다음과 같습니다.

  • 0.0은 절대 상단입니다.
  • 1.0은 절대 하단입니다.

기본값은 0.5(중앙)입니다.

액세스 함수:

qreal verticalPosition() const
void setVerticalPosition(qreal relativePosition)

horizontalPosition도 참조하십시오 .

멤버 함수 문서

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

parent 의 자식인 시리즈 객체를 생성합니다.

[virtual noexcept] QPieSeries::~QPieSeries()

파이 시리즈와 그 조각들을 제거합니다.

[signal] void QPieSeries::added(const QList<QPieSlice *> &slices)

slices 에 지정된 슬라이스가 시퀀스에 추가되면 이 신호가 발생합니다.

append() 및 insert()도 참조하십시오 .

bool QPieSeries::append(QPieSlice *slice)

slice 로 지정된 슬라이스를 시퀀스 끝에 추가합니다. 슬라이스의 소유권은 시퀀스로 이전됩니다.

추가 작업이 성공하면 true 를 반환합니다.

bool QPieSeries::append(const QList<QPieSlice *> &slices)

slices 로 지정된 슬라이스 배열을 시퀀스에 추가합니다. 슬라이스의 소유권은 시퀀스로 이전됩니다.

추가 작업이 성공하면 true 를 반환합니다.

QPieSlice *QPieSeries::append(const QString &label, qreal value)

지정된 ` value ` 및 ` label `을 가진 단일 슬라이스를 시퀀스에 추가합니다. 슬라이스의 소유권은 시퀀스로 이전됩니다. ` value `이 ` NaN`, ` Inf` 또는 ` -Inf `인 경우 `null`을 반환하며, 시퀀스에 아무것도 추가하지 않습니다.

void QPieSeries::clear()

시리즈에서 모든 슬라이스를 삭제합니다.

[signal] void QPieSeries::clicked(QPieSlice *slice)

slice 로 지정된 슬라이스를 클릭하면 이 신호가 발생합니다.

QPieSlice::clicked()도 참조하십시오 .

int QPieSeries::count() const

이 시리즈에 포함된 슬라이스의 개수를 반환합니다.

참고: count 속성에 대한게터 함수입니다.

[signal] void QPieSeries::countChanged()

이 신호는 슬라이스 수가 변경될 때 발생합니다.

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

count도 참조하십시오 .

[signal] void QPieSeries::doubleClicked(QPieSlice *slice)

slice 로 지정된 슬라이스를 더블 클릭하면 이 신호가 발생합니다.

QPieSlice::doubleClicked()도 참조하십시오 .

[signal] void QPieSeries::hovered(QPieSlice *slice, bool state)

이 신호는 slice 로 지정된 슬라이스 위에 마우스를 올렸을 때 발생합니다. 마우스가 슬라이스 위로 이동하면 state 가 true 로 바뀌고, 마우스가 다시 슬라이스에서 멀어지면 false 로 바뀝니다.

QPieSlice::hovered()도 참조하십시오 .

bool QPieSeries::insert(int index, QPieSlice *slice)

slice 로 지정된 슬라이스를 index 로 지정된 위치에 있는 슬라이스 바로 앞에 시퀀스에 삽입합니다. 슬라이스의 소유권은 시퀀스로 전달됩니다.

삽입에 성공하면 true 를 반환합니다.

bool QPieSeries::isEmpty() const

시리즈가 비어 있으면 ` true `를 반환합니다.

qreal QPieSeries::pieEndAngle() const

파이 차트의 끝 각도를 반환합니다.

파이 전체는 360도이며, 0도는 12시 방향에 해당합니다.

참고: 속성 endAngle 에 대한게터 함수입니다.

setPieEndAngle(), pieStartAngle(), setPieStartAngle()도 참조하십시오 .

[signal] void QPieSeries::pressed(QPieSlice *slice)

이 신호는 사용자가 slice 로 지정된 슬라이스를 클릭하고 마우스 버튼을 누른 상태로 유지할 때 발생합니다.

QPieSlice::pressed()도 참조하십시오 .

[signal] void QPieSeries::released(QPieSlice *slice)

이 신호는 사용자가 slice 로 지정된 슬라이스에서 마우스 버튼을 놓을 때 발생합니다.

QPieSlice::released()도 참조하십시오 .

bool QPieSeries::remove(QPieSlice *slice)

slice 로 지정된 단일 슬라이스를 시퀀스에서 제거하고 영구적으로 삭제합니다.

이 호출 후에는 해당 포인터를 참조할 수 없습니다.

제거가 성공하면 true 를 반환합니다.

[signal] void QPieSeries::removed(const QList<QPieSlice *> &slices)

slices 로 지정된 슬라이스가 시퀀스에서 제거되면 이 신호가 발생합니다.

remove()도 참조하십시오 .

void QPieSeries::setLabelsPosition(QPieSlice::LabelPosition position)

모든 슬라이스 레이블의 위치를 position 로 설정합니다.

참고: 이 함수는 시리즈의 현재 슬라이스에만 영향을 미칩니다. 새로운 슬라이스가 추가되면 레이블의 기본 위치는 QPieSlice::LabelOutside 입니다.

QPieSlice::labelPosition() 및 QPieSlice::setLabelPosition()도 참조하십시오 .

void QPieSeries::setLabelsVisible(bool visible = true)

모든 슬라이스 레이블의 표시 상태를 ‘ visible ’로 설정합니다.

참고: 이 함수는 시리즈의 현재 슬라이스에만 영향을 미칩니다. 새로운 슬라이스가 추가되면 레이블의 기본 표시 상태는 ' false'입니다.

QPieSlice::isLabelVisible() 및 QPieSlice::setLabelVisible()도 참조하십시오 .

void QPieSeries::setPieEndAngle(qreal angle)

파이의 끝 각도를 설정합니다.

파이 차트의 전체 각도는 360도이며, 0도는 12시 방향에 해당합니다.

angle 시작 각도보다 커야 합니다.

참고: endAngle 속성에 대한설정 함수입니다.

pieEndAngle(), pieStartAngle(), setPieStartAngle()도 참조하십시오 .

QList<QPieSlice *> QPieSeries::slices() const

이 시리에 속하는 슬라이스 목록을 반환합니다.

qreal QPieSeries::sum() const

이 시퀀스에 포함된 모든 슬라이스 값의 합계를 반환합니다.

참고: sum 속성에 대한게터 함수입니다.

QPieSlice::value(), QPieSlice::setValue(), QPieSlice::percentage()도 참조하십시오 .

[signal] void QPieSeries::sumChanged()

이 신호는 모든 슬라이스의 합이 변경될 때 발생합니다.

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

sum도 참조하십시오 .

bool QPieSeries::take(QPieSlice *slice)

시리즈에서 ` slice`로 지정된 단일 슬라이스를 가져옵니다. 슬라이스 객체는 삭제되지 않습니다.

참고: 시리즈는 슬라이스의 부모 객체로 유지됩니다. 완전한 소유권을 확보하려면 부모 객체를 설정해야 합니다.

take 작업이 성공하면 true 를 반환합니다.

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

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

시리즈의 유형을 반환합니다.

QPieSeries &QPieSeries::operator<<(QPieSlice *slice)

slice 로 지정된 슬라이스를 시퀀스 끝에 추가하고, 시퀀스에 대한 참조를 반환합니다. 슬라이스의 소유권은 시퀀스로 이전됩니다.

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