Back to Qt.io
Contact Us Blog Download Qt
이 페이지에서

QPieSlice Class

QPieSlice 클래스는 파이 시리즈의 단일 슬라이스를 나타냅니다. 더 보기...

Header: #include <QPieSlice>
In QML: PieSlice
Inherits: QObject
Status: Deprecated

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

공개 유형

enum LabelPosition { LabelOutside, LabelInsideHorizontal, LabelInsideTangential, LabelInsideNormal }

속성

공개 함수

QPieSlice(QObject *parent = nullptr)
QPieSlice(QString label, qreal value, QObject *parent = nullptr)
virtual ~QPieSlice()
qreal angleSpan() const
QColor borderColor()
int borderWidth()
QBrush brush() const
QColor color()
qreal explodeDistanceFactor() const
bool isExploded() const
bool isLabelVisible() const
QString label() const
qreal labelArmLengthFactor() const
QBrush labelBrush() const
QColor labelColor()
QFont labelFont() const
QPieSlice::LabelPosition labelPosition()
QPen pen() const
qreal percentage() const
QPieSeries *series() const
void setBorderColor(QColor color)
void setBorderWidth(int width)
void setBrush(const QBrush &brush)
void setColor(QColor color)
void setExplodeDistanceFactor(qreal factor)
void setExploded(bool exploded = true)
void setLabel(QString label)
void setLabelArmLengthFactor(qreal factor)
void setLabelBrush(const QBrush &brush)
void setLabelColor(QColor color)
void setLabelFont(const QFont &font)
void setLabelPosition(QPieSlice::LabelPosition position)
void setLabelVisible(bool visible = true)
void setPen(const QPen &pen)
void setValue(qreal value)
qreal startAngle() const
qreal value() const

신호

void angleSpanChanged()
void borderColorChanged()
void borderWidthChanged()
void brushChanged()
void clicked()
void colorChanged()
void doubleClicked()
void hovered(bool state)
void labelBrushChanged()
void labelChanged()
void labelColorChanged()
void labelFontChanged()
void labelVisibleChanged()
void penChanged()
void percentageChanged()
void pressed()
void released()
void startAngleChanged()
void valueChanged()

상세 설명

파이 슬라이스에는 값과 레이블이 있습니다. 슬라이스가 파이 시리즈에 추가되면, ` QPieSeries ` 객체는 시리즈 내 모든 슬라이스의 합계에 대한 해당 슬라이스의 비율을 계산하여 차트에서 슬라이스의 실제 크기를 결정합니다.

기본적으로 레이블은 숨겨져 있습니다. 레이블이 표시되는 경우, 슬라이스 외부에 위치하여 선으로 슬라이스와 연결되거나, 슬라이스 내부 중앙에 수평으로 또는 슬라이스 호의 접선이나 법선과 평행하게 배치될 수 있습니다.

기본적으로 슬라이스의 시각적 모양은 테마에 의해 설정되지만, 슬라이스 속성을 지정하여 테마를 재정의할 수 있습니다. 그러나 슬라이스를 사용자 정의한 후 테마를 변경하면 모든 사용자 정의 내용이 사라집니다.

파이 차트에서 사용자 상호작용을 지원하기 위해, 사용자가 파이 조각을 클릭하거나 마우스를 올려놓을 때 몇 가지 기본 신호가 발생합니다.

QPieSeries도 참조하십시오 .

멤버 유형 문서

enum QPieSlice::LabelPosition

이 열거형은 슬라이스 레이블의 위치를 나타냅니다.

상수값설명
QPieSlice::LabelOutside0라벨은 암을 통해 연결된 슬라이스 바깥쪽에 위치합니다. 이것이 기본값입니다.
QPieSlice::LabelInsideHorizontal1라벨은 슬라이스 중앙에 위치하며 수평으로 배치됩니다.
QPieSlice::LabelInsideTangential2라벨은 슬라이스 내부에서 중앙에 위치하며, 슬라이스 호의 접선과 평행하도록 회전됩니다.
QPieSlice::LabelInsideNormal3라벨은 슬라이스 중앙에 위치하며, 슬라이스 호의 법선과 평행이 되도록 회전됩니다.

속성 설명서

[read-only] angleSpan : qreal

이 속성은 슬라이스의 각도 범위를 도 단위로 저장합니다. 원형 다이어그램 전체는 360도이며, 0도는 12시 방향에 해당합니다. 슬라이스가 시리즈에 추가되면 자동으로 업데이트됩니다.

액세스 함수:

qreal angleSpan() const

알림 신호:

void angleSpanChanged()

borderColor : QColor

이 속성은 슬라이스 테두리를 그리는 데 사용되는 색상을 지정합니다. 이는 슬라이스 펜을 수정하기 위한 편의 속성입니다.

액세스 함수:

QColor borderColor()
void setBorderColor(QColor color)

알림 신호:

void borderColorChanged()

pen 및 borderWidth도 참조하십시오 .

borderWidth : int

이 속성은 슬라이스 테두리의 너비를 지정합니다. 이는 슬라이스 펜을 수정하기 위한 편의 속성입니다.

액세스 함수:

int borderWidth()
void setBorderWidth(int width)

알림 신호:

void borderWidthChanged()

pen 및 borderColor도 참조하십시오 .

brush : QBrush

이 속성은 슬라이스를 채우는 데 사용되는 브러시를 저장합니다.

액세스 함수:

QBrush brush() const
void setBrush(const QBrush &brush)

알림 신호:

void brushChanged()

color : QColor

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

액세스 함수:

QColor color()
void setColor(QColor color)

알림 신호:

void colorChanged()

brush도 참조하십시오 .

explodeDistanceFactor : qreal

슬라이스가 파이에서 얼마나 멀리 떨어져 표시될지 결정합니다.

  • 1.0은 그 거리가 반지름과 같음을 의미합니다.
  • 0.5는 그 거리가 반지름의 절반임을 의미합니다.

기본값은 0.15입니다.

관련 함수:

qreal explodeDistanceFactor() const
void setExplodeDistanceFactor(qreal factor)

exploded도 참조하십시오 .

exploded : bool

이 속성은 슬라이스가 파이에서 분리되어 있는지 여부를 나타냅니다.

액세스 함수:

bool isExploded() const
void setExploded(bool exploded = true)

explodeDistanceFactor도 참조하십시오 .

label : QString

이 속성은 슬라이스의 레이블을 저장합니다.

참고: 이 문자열은 HTML 형식으로 작성될 수 있습니다.

액세스 함수:

QString label() const
void setLabel(QString label)

알림 신호:

void labelChanged()

labelVisible, labelBrush, labelFont 및 labelArmLengthFactor도 참조하십시오 .

labelArmLengthFactor : qreal

이 속성은 레이블 암의 길이를 나타냅니다. 이 값은 파이 반경에 대한 상대적 비율입니다. 예를 들어:

  • 1.0은 길이가 반지름과 같음을 의미합니다.
  • 0.5는 길이가 반지름의 절반임을 의미합니다.

기본적으로 아름 길이는 0.15입니다.

액세스 함수:

qreal labelArmLengthFactor() const
void setLabelArmLengthFactor(qreal factor)

label, labelVisible, labelBrush, labelFont도 참조하십시오 .

labelBrush : QBrush

이 속성은 슬라이스의 레이블과 레이블 암을 그리는 데 사용되는 브러시를 저장합니다.

액세스 함수:

QBrush labelBrush() const
void setLabelBrush(const QBrush &brush)

알림 신호:

void labelBrushChanged()

label, labelVisible, labelFont 및 labelArmLengthFactor도 참조하십시오 .

labelColor : QColor

이 속성은 슬라이스 레이블을 그리는 데 사용되는 색상을 저장합니다. 이는 슬라이스 레이블 브러시를 수정하기 위한 편의 속성입니다.

액세스 함수:

QColor labelColor()
void setLabelColor(QColor color)

알림 신호:

void labelColorChanged()

labelBrush도 참조하십시오 .

labelFont : QFont

이 속성은 레이블 텍스트를 그릴 때 사용되는 글꼴을 저장합니다.

액세스 함수:

QFont labelFont() const
void setLabelFont(const QFont &font)

알림 신호:

void labelFontChanged()

label, labelVisible 및 labelArmLengthFactor도 참조하십시오 .

labelPosition : LabelPosition

이 속성은 슬라이스 레이블의 위치를 지정합니다.

액세스 함수:

QPieSlice::LabelPosition labelPosition()
void setLabelPosition(QPieSlice::LabelPosition position)

label 및 labelVisible도 참조하십시오 .

labelVisible : bool

이 속성은 슬라이스 레이블의 표시 여부를 결정합니다. 기본적으로 레이블은 표시되지 않습니다.

액세스 함수:

bool isLabelVisible() const
void setLabelVisible(bool visible = true)

알림 신호:

void labelVisibleChanged()

label, labelBrush, labelFont 및 labelArmLengthFactor도 참조하십시오 .

pen : QPen

이 속성은 슬라이스 테두리를 그리는 데 사용된 펜을 저장합니다.

액세스 함수:

QPen pen() const
void setPen(const QPen &pen)

알림 신호:

void penChanged()

[read-only] percentage : qreal

이 속성은 해당 슬라이스가 시리즈 내 모든 슬라이스의 합계에 차지하는 비율을 나타냅니다. 실제 값의 범위는 0.0에서 1.0 사이입니다. 슬라이스가 시리즈에 추가되면 자동으로 업데이트됩니다.

액세스 함수:

qreal percentage() const

알림 신호:

void percentageChanged()

관련 항목: value 및 QPieSeries::sum.

[read-only] startAngle : qreal

이 속성은 해당 슬라이스가 속한 시리즈 내에서 이 슬라이스의 시작 각도를 나타냅니다. 전체 원은 360도이며, 0도는 12시 방향에 해당합니다. 슬라이스가 시리즈에 추가되면 자동으로 업데이트됩니다.

액세스 함수:

qreal startAngle() const

알림 신호:

void startAngleChanged()

value : qreal

이 속성은 슬라이스의 값을 저장합니다.

참고: 음수값은 양수 값으로 변환됩니다.

액세스 함수:

qreal value() const
void setValue(qreal value)

알림 신호:

void valueChanged()

percentage() 및 QPieSeries::sum()도 참조하십시오 .

멤버 함수 문서

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

parent 를 부모로 하는 빈 슬라이스를 생성합니다.

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

QPieSlice::QPieSlice(QString label, qreal value, QObject *parent = nullptr)

지정된 value, label 및 parent 를 사용하여 빈 슬라이스를 생성합니다.

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

[virtual noexcept] QPieSlice::~QPieSlice()

슬라이스를 제거합니다. 슬라이스가 시리즈에 추가된 경우에는 제거해서는 안 됩니다.

[signal] void QPieSlice::angleSpanChanged()

이 신호는 슬라이스의 각도 범위가 변경될 때 발생합니다.

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

angleSpan도 참조하십시오 .

[signal] void QPieSlice::borderColorChanged()

이 신호는 슬라이스 테두리 색상이 변경될 때 발생합니다.

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

pen 및 borderColor도 참조하십시오 .

[signal] void QPieSlice::borderWidthChanged()

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

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

pen 및 borderWidth도 참조하십시오 .

[signal] void QPieSlice::brushChanged()

슬라이스를 채우는 데 사용되는 브러시가 변경되면 이 신호가 발생합니다.

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

brush도 참조하십시오 .

[signal] void QPieSlice::clicked()

이 신호는 슬라이스를 클릭했을 때 발생합니다.

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

[signal] void QPieSlice::colorChanged()

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

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

brush도 참조하십시오 .

[signal] void QPieSlice::doubleClicked()

사용자가 슬라이스를 더블 클릭하면 이 신호가 발생합니다.

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

[signal] void QPieSlice::hovered(bool state)

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

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

[signal] void QPieSlice::labelBrushChanged()

이 신호는 슬라이스의 레이블 브러시가 변경될 때 발생합니다.

참고: 속성 labelBrush 에 대한Notifier 신호입니다.

labelBrush도 참조하십시오 .

[signal] void QPieSlice::labelChanged()

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

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

label도 참조하십시오 .

[signal] void QPieSlice::labelColorChanged()

이 신호는 슬라이스 레이블의 색상이 변경될 때 발생합니다.

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

labelColor도 참조하십시오 .

[signal] void QPieSlice::labelFontChanged()

이 신호는 슬라이스의 레이블 글꼴이 변경될 때 발생합니다.

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

labelFont도 참조하십시오 .

[signal] void QPieSlice::labelVisibleChanged()

이 신호는 슬라이스 레이블의 표시 상태가 변경될 때 발생합니다.

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

labelVisible도 참조하십시오 .

[signal] void QPieSlice::penChanged()

슬라이스 테두리를 그리는 데 사용되는 펜이 변경되면 이 신호가 발생합니다.

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

pen도 참조하십시오 .

[signal] void QPieSlice::percentageChanged()

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

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

percentage도 참조하십시오 .

[signal] void QPieSlice::pressed()

사용자가 슬라이스를 클릭한 후 마우스 버튼을 누르고 있을 때 이 신호가 발생합니다.

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

[signal] void QPieSlice::released()

사용자가 슬라이스에서 마우스 버튼을 놓으면 이 신호가 발생합니다.

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

QPieSeries *QPieSlice::series() const

이 슬라이스가 속한 시리얼을 반환합니다.

QPieSeries::append()도 참조하십시오 .

[signal] void QPieSlice::startAngleChanged()

이 신호는 슬라이스의 시작 각도가 변경될 때 발생합니다.

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

startAngle도 참조하십시오 .

[signal] void QPieSlice::valueChanged()

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

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

value도 참조하십시오 .

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