PieSeries QML Type

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

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

• 상속된 멤버를 포함한 모든 멤버 목록

속성

• count : int
• endAngle : real
• holeSize : real
• horizontalPosition : real
• size : real
• startAngle : real
• sum : real
• verticalPosition : real

신호

• added(list<PieSlice> slices)
• clicked(PieSlice slice)
• doubleClicked(PieSlice slice)
• hovered(PieSlice slice, bool state)
• pressed(PieSlice slice)
• released(PieSlice slice)
• removed(list<PieSlice> slices)
• sliceAdded(PieSlice slice)
• sliceRemoved(PieSlice slice)

방법

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

상세 설명

파이 시리즈는 ` PieSlice ` 유형을 사용하여 정의된 슬라이스로 구성됩니다. `PieSeries` 유형은 시리즈 내 모든 슬라이스의 합계와 비교하여 각 슬라이스의 비율을 계산함으로써 차트에서 슬라이스의 실제 크기를 결정하므로, 슬라이스에는 어떤 값이든 지정할 수 있습니다.

차트상의 파이 크기와 위치는 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 입니다.

clicked(PieSlice slice)

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

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

doubleClicked(PieSlice slice)

slice 로 지정된 슬라이스를 더블 클릭하면 이 신호가 발생합니다.

이에 대응하는 신호 핸들러는 onDoubleClicked 입니다.

hovered(PieSlice slice, bool state)

이 신호는 slice 로 지정된 슬라이스 위에 마우스를 올렸을 때 발생합니다. 마우스가 슬라이스 위로 이동하면 state 이 true 로 변경되며, 마우스가 다시 슬라이스에서 멀어지면 false 로 변경됩니다.

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

pressed(PieSlice slice)

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

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

released(PieSlice slice)

이 신호는 사용자가 slice 로 지정된 슬라이스에서 마우스 버튼을 놓을 때 발생합니다.

이에 대응하는 신호 핸들러는 onReleased 입니다.

removed(list<PieSlice> slices)

slices 로 지정된 슬라이스가 시리즈에서 제거되면 이 신호가 발생합니다.

이에 대응하는 신호 핸들러는 onRemoved 입니다.

sliceAdded(PieSlice slice)

slice 로 지정된 슬라이스가 시퀀스에 추가되면 이 신호가 발생합니다.

이에 대응하는 신호 핸들러는 onSliceAdded 입니다.

sliceRemoved(PieSlice slice)

slice 로 지정된 슬라이스가 시리얼에서 제거되면 이 신호가 발생합니다.

이에 해당하는 신호 핸들러는 ` onSliceRemoved`입니다.

메서드 문서

PieSlice append(string label, real value)

label 라는 레이블과 value 이라는 값을 가진 새로운 슬라이스를 파이 차트에 추가합니다.

PieSlice at(int index)

index 로 지정된 위치의 슬라이스를 반환합니다. 인덱스가 유효하지 않은 경우 null을 반환합니다.

void clear()

파이에서 모든 조각을 제거합니다.

PieSlice find(string label)

label 라는 레이블을 가진 첫 번째 슬라이스를 반환합니다. 해당 레이블을 찾을 수 없는 경우 null을 반환합니다.

bool remove(PieSlice slice)

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