QPieSlice Class
QPieSlice 클래스는 파이 계열의 단일 슬라이스를 나타냅니다. 더 보기...
공용 유형
| 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::LabelOutside | 0 | 레이블은 암으로 연결된 슬라이스 외부에 위치합니다. 이것이 기본값입니다. |
QPieSlice::LabelInsideHorizontal | 1 | 레이블은 슬라이스 내에서 중앙에 위치하며 수평으로 배치됩니다. |
QPieSlice::LabelInsideTangential | 2 | 레이블은 슬라이스 내에서 중앙에 위치하며 슬라이스 호의 접선과 평행이 되도록 회전합니다. |
QPieSlice::LabelInsideNormal | 3 | 레이블은 슬라이스 내에서 중앙에 위치하며 슬라이스 호의 법선과 평행이 되도록 회전됩니다. |
속성 문서
[read-only] angleSpan : const 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 : const qreal
이 속성은 계열의 모든 슬라이스의 합계와 비교한 슬라이스의 백분율을 보유합니다. 실제 값의 범위는 0.0에서 1.0입니다. 슬라이스가 시리즈에 추가되면 자동으로 업데이트됩니다.
기능에 액세스합니다:
| qreal | percentage() const |
알림 신호:
| void | percentageChanged() |
value 및 QPieSeries::sum 을참조하세요 .
[read-only] startAngle : const 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.
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도 참조하세요 .
© 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.
