이 페이지에서

PieSlice QML Type

파이 차트 시리즈의 단일 슬라이스를 나타냅니다. 더 보기...

Import Statement: import QtCharts 2.12
In C++: QPieSlice
Status: Deprecated

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

속성

신호

상세 설명

파이 차트의 한 조각에는 값과 레이블이 있습니다. 이 조각이 파이 시리즈에 추가되면, ‘ PieSeries ’ 유형은 시리즈 내 모든 조각의 합계에 비해 해당 조각이 차지하는 비율을 계산하여 차트에서 조각의 실제 크기를 결정합니다.

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

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

PieSlice 유형은 PieSeries 유형의 자식 요소로 사용해야 합니다. 예:

또는 PieSeries.append() 메서드를 사용하여 파이 시리즈에 슬라이스를 추가할 수도 있습니다.

이 경우, PieSeries.at() 또는 PieSeries.find 를 사용하여 개별 PieSlice 인스턴스의 속성에 접근할 수 있습니다.

PieSeries도 참조하십시오 .

속성 문서

angleSpan : real [read-only]

슬라이스의 각도 범위. 전체 원은 360도이며, 0도는 12시 방향을 가리킵니다. 슬라이스가 시리즈에 추가되면 자동으로 업데이트됩니다.

borderColor : color

슬라이스 테두리를 그리는 데 사용되는 색상(펜 색상).

borderWidth도 참조하십시오 .

borderWidth : int

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

borderColor도 참조하십시오 .

brushFilename : string

슬라이스의 브러시로 사용되는 파일의 이름입니다.

color : color

슬라이스의 채우기(브러시) 색상.

explodeDistanceFactor : real

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

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

기본값은 0.15입니다.

exploded도 참조하십시오 .

exploded : bool

조각이 파이에서 분리되어 있는지 여부.

explodeDistanceFactor도 참조하십시오 .

label : string

슬라이스의 레이블입니다.

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

labelArmLengthFactor : real

라벨 암의 길이입니다. 이 계수는 파이 반경에 상대적인 값입니다. 예를 들어:

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

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

labelVisible도 참조하십시오 .

labelColor : color

슬라이스 레이블을 그리는 데 사용되는 색상입니다.

labelFont : font

슬라이스 레이블에 사용되는 글꼴입니다.

자세한 내용은 font 을 참조하십시오.

labelVisible 및 labelPosition도 참조하십시오 .

labelPosition : enumeration

슬라이스 레이블의 위치를 설명합니다.

상수설명
PieSlice.LabelOutside라벨은 슬라이스 외부에 위치하며, 암을 통해 해당 슬라이스와 연결됩니다. 이것이 기본값입니다.
PieSlice.LabelInsideHorizontal라벨은 슬라이스 중앙에 위치하며 수평으로 배치됩니다.
PieSlice.LabelInsideTangential라벨은 슬라이스 내부에서 중앙에 위치하며, 슬라이스 호의 접선과 평행이 되도록 회전됩니다.
PieSlice.LabelInsideNormal라벨은 슬라이스 내부에 중앙 정렬되며, 슬라이스 호의 법선과 평행하도록 회전됩니다.

labelVisible도 참조하십시오 .

labelVisible : bool

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

percentage : real [read-only]

시리즈 내 모든 슬라이스의 합계에 대한 해당 슬라이스의 비율입니다. 실제 값은 0.0에서 1.0 사이입니다. 슬라이스가 시리즈에 추가되면 자동으로 업데이트됩니다.

startAngle : real [read-only]

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

value : real

슬라이스의 값.

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

신호 문서

clicked()

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

이에 대응하는 신호 핸들러는 onClicked() 입니다.

참고: 해당 핸들러는 onClicked 입니다.

doubleClicked()

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

이에 해당하는 신호 핸들러는 onDoubleClicked() 입니다.

참고: 이에 해당하는핸들러는 onDoubleClicked 입니다.

hovered(bool state)

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

이에 해당하는 신호 핸들러는 onHovered() 입니다.

참고: 해당 핸들러는 onHovered 입니다.

pressed()

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

이에 대응하는 신호 핸들러는 onPressed() 입니다.

참고: 해당 핸들러는 onPressed 입니다.

released()

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

이에 해당하는 신호 핸들러는 onReleased() 입니다.

참고: 해당 핸들러는 onReleased 입니다.

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