PieSlice QML Type

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

Import Statement: import QtCharts 2.8
In C++: QPieSlice

속성

신호

자세한 설명

파이 슬라이스에는 값과 레이블이 있습니다. 슬라이스가 파이 계열에 추가되면 PieSeries 유형은 계열의 모든 슬라이스의 합계와 비교하여 해당 슬라이스의 백분율을 계산하여 차트에서 슬라이스의 실제 크기를 결정합니다.

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

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

파이슬라이스 유형은 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 을 참조하십시오.

labelVisiblelabelPosition도 참조하십시오 .


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)

이 신호는 마우스를 슬라이스 위에 가져가면 발생합니다. 마우스가 슬라이스 위로 이동하면 statetrue 으로 바뀌고 마우스가 다시 멀어지면 false 으로 바뀝니다.

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

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


pressed()

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

해당 신호 핸들러는 onPressed() 입니다.

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


released()

이 신호는 사용자가 슬라이스를 마우스 누른 상태에서 손을 떼면 발생합니다.

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

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


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