Back to Qt.io
Contact Us Blog Download Qt

PieSeries QML Type

데이터를 원형 차트로 표시합니다. 더 보기...

Import Statement: import QtCharts 2.8
In C++: QPieSeries
Inherits:

AbstractSeries

속성

신호

방법

  • PieSlice append(string label, real value)
  • PieSlice at(int index)
  • clear()
  • PieSlice find(string label)
  • bool remove(PieSlice slice)

상세 설명

파이 시리즈는 PieSlice 유형을 사용하여 정의된 슬라이스로 구성됩니다. 파이 시리즈 유형은 시리즈의 모든 슬라이스의 합과 비교하여 슬라이스의 백분율을 계산하여 차트에서 슬라이스의 실제 크기를 결정하므로 슬라이스는 임의의 값을 가질 수 있습니다.

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

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

다음 QML 예제는 간단한 원형 차트를 만드는 방법을 보여줍니다.

ChartView {
    id: chart
    title: "Top-5 car brand shares in Finland"
    anchors.fill: parent
    legend.alignment: Qt.AlignBottom
    antialiasing: true

    property variant othersSlice: 0

    PieSeries {
        id: pieSeries
        PieSlice { label: "Volkswagen"; value: 13.5 }
        PieSlice { label: "Toyota"; value: 10.9 }
        PieSlice { label: "Ford"; value: 8.6 }
        PieSlice { label: "Skoda"; value: 8.2 }
        PieSlice { label: "Volvo"; value: 6.8 }
    }

    Component.onCompleted: {
        // You can also manipulate slices dynamically, like append a slice or set a slice exploded
        othersSlice = pieSeries.append("Others", 52.0);
        pieSeries.find("Volkswagen").exploded = true;
    }
}


PieSlice 및 ChartView 을참조하세요 .

속성 문서

count : int [read-only]

계열의 슬라이스 수입니다.


endAngle : real

파이의 끝 각도입니다.

전체 파이는 360도이며, 여기서 0도는 12시 방향입니다.

기본값은 360입니다.


holeSize : real

도넛 구멍 크기입니다.

이 값은 차트 직사각형을 기준으로 합니다:

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

이 속성을 설정할 때 필요한 경우 구멍 크기가 파이 크기보다 크지 않도록 size 속성이 조정됩니다.

기본값은 0.0입니다.


horizontalPosition : real

파이의 가로 위치입니다.

이 값은 차트 사각형에 상대적인 값입니다:

  • 0.0은 절대 왼쪽입니다.
  • 1.0은 절대 오른쪽입니다.

기본값은 0.5(가운데)입니다.

verticalPosition 를참조하세요 .


size : real

파이 크기.

이 값은 차트 사각형에 상대적인 값입니다:

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

이 속성을 설정할 때 필요한 경우 holeSize 속성을 조정하여 구멍 크기가 파이 크기보다 크지 않도록 합니다.

기본값은 0.7입니다.


startAngle : real

파이의 시작 각도입니다.

전체 파이는 360도이며 0도는 12시 방향입니다.

기본값은 0입니다.


sum : real [read-only]

모든 슬라이스의 합계입니다.

이 계열은 보유하고 있는 모든 슬라이스의 합계를 추적합니다.


verticalPosition : real

파이의 세로 위치입니다.

이 값은 차트 직사각형을 기준으로 합니다:

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

기본값은 0.5(가운데)입니다.

horizontalPosition 를참조하세요 .


신호 문서

added(list<PieSlice> slices)

이 신호는 slices 에 지정된 슬라이스가 시리즈에 추가될 때 발신됩니다.

해당 신호 핸들러는 onAdded 입니다.

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


clicked(PieSlice slice)

slice 에 지정된 슬라이스가 클릭될 때 이 신호가 발생합니다.

해당 신호 핸들러는 onClicked 입니다.

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


doubleClicked(PieSlice slice)

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

해당 신호 핸들러는 onDoubleClicked 입니다.

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


hovered(PieSlice slice, bool state)

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

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

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


pressed(PieSlice slice)

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

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

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


released(PieSlice slice)

이 신호는 사용자가 slice 에 지정된 슬라이스를 마우스로 누르고 있다가 놓을 때 발생합니다.

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

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


removed(list<PieSlice> slices)

이 신호는 slices 에서 지정한 슬라이스가 시리즈에서 제거될 때 발생합니다.

해당 신호 핸들러는 onRemoved 입니다.

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


sliceAdded(PieSlice slice)

이 신호는 slice 에서 지정한 슬라이스가 시리즈에 추가될 때 발생합니다.

해당 신호 핸들러는 onSliceAdded 입니다.

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


sliceRemoved(PieSlice slice)

이 신호는 slice 에서 지정한 슬라이스가 계열에서 제거될 때 발생합니다.

해당 신호 핸들러는 onSliceRemoved 입니다.

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


메서드 문서

PieSlice append(string label, real value)

레이블이 label, 값이 value 인 새 슬라이스를 파이에 추가합니다.


PieSlice at(int index)

index 에 지정된 위치에 슬라이스를 반환합니다. 인덱스가 유효하지 않으면 null을 반환합니다.


clear()

파이에서 모든 슬라이스를 제거합니다.


PieSlice find(string label)

label 레이블이 있는 첫 번째 슬라이스를 반환합니다. 레이블을 찾을 수 없으면 null을 반환합니다.


bool remove(PieSlice slice)

slice 으로 지정된 슬라이스를 파이에서 제거합니다. 제거에 성공하면 true, 그렇지 않으면 false 을 반환합니다.


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