Back to Qt.io
Contact Us Blog Download Qt

PieSeries QML Type

데이터를 원형 그래프로 표시합니다. 더 보기...

Import Statement: import QtGraphs
In C++: QPieSeries
Inherits:

AbstractSeries

속성

신호

방법

  • PieSlice append(string label, real value)
  • PieSlice at(int index)
  • clear()
  • PieSlice find(string label)
  • bool remove(PieSlice slice)
  • bool remove(int index)
  • void removeMultiple(int index, int count)
  • bool replace(list<PieSlice> slices)
  • bool replace(PieSlice oldSlice, PieSlice newSlice)
  • bool replace(int index, PieSlice slice)
  • bool take(PieSlice slice)

상세 설명

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

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

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

다음 QML 예제는 간단한 파이 그래프를 만드는 방법을 보여줍니다.

import QtQuick
import QtGraphs

Item {
    id: mainView
    width: 1280
    height: 720

    GraphsView {
        anchors.fill: parent
        theme: GraphsTheme {
             colorScheme: GraphsTheme.ColorScheme.Dark
             theme: GraphsTheme.Theme.QtGreen
        }
        PieSeries {
            id: pieSeries
            PieSlice {
                value: 1
            }
            PieSlice {
                value: 2
            }
        }
    }
}

PieSlice 및 GraphsView 을참조하세요 .

속성 문서

angleSpanLabelVisibility : enumeration [since 6.10]

레이블 가시성을 위한 모드입니다.

angleSpanVisibleLimit 으로 설정된 각도 범위 제한 아래에 있는 경우 어떤 레이블을 숨길지 결정하는 모드입니다. angleSpanVisibleLimit 이 설정되지 않은 경우 아무 영향도 미치지 않습니다.

상수설명
PieSeries.LabelVisibility.None각도 스팬이 angleSpanVisibleLimit 보다 작은 슬라이스의 모든 레이블이 숨겨집니다.
PieSeries.LabelVisibility.FirstangleSpanVisibleLimit 보다 각도 스팬이 작은 연속된 슬라이스의 첫 번째 레이블을 제외한 모든 레이블이 숨겨집니다. 이것이 기본값입니다.
PieSeries.LabelVisibility.EvenangleSpanVisibleLimit 보다 각도 스팬이 작은 연속된 슬라이스의 다른 모든 레이블은 두 번째 레이블부터 숨겨집니다.
PieSeries.LabelVisibility.OddangleSpanVisibleLimit 보다 작은 각도 스팬을 가진 연속된 슬라이스의 다른 모든 레이블은 첫 번째 레이블부터 숨겨집니다.

이 속성은 Qt 6.10에 도입되었습니다.

angleSpanVisibleLimit 를참조하세요 .


angleSpanVisibleLimit : real [since 6.10]

레이블 가시성을 위한 각도 스팬 제한.

슬라이스 레이블의 가시성 제한으로 사용될 각도 스팬입니다. 각도 스팬이 이 값 미만인 슬라이스는 계열에 설정된 angleSpanLabelVisibility 에 따라 표시 여부가 변경됩니다. 기본값은 0 이며, 이는 angleSpanLabelVisibility 에 관계없이 슬라이스가 숨겨지지 않음을 의미합니다.

이 속성은 Qt 6.10에 도입되었습니다.

angleSpanLabelVisibility도 참조하십시오 .


count : int [read-only]

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


endAngle : real

파이의 끝 각도.

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

기본값은 360입니다.


holeSize : real

도넛 구멍 크기입니다.

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

기본값은 0.0입니다.


horizontalPosition : real

파이의 가로 위치.

이 값은 그래프 직사각형에 상대적인 값입니다:

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

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

verticalPosition 를참조하십시오 .


pieSize : real

파이 크기.

이 값은 그래프 직사각형에 상대적인 값입니다:

  • 0.0은 최소 pieSize(파이가 그려지지 않음)입니다.
  • 1.0은 그래프에 맞출 수 있는 최대 pieSize입니다.

이 속성을 설정할 때 필요한 경우 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 입니다.


[since 6.10] angleSpanLabelVisibilityChanged(LabelVisibility visibility)

이 신호는 각도 범위 제한 표시 모드가 변경되었을 때 발생합니다. visibility 매개변수는 새로운 표시 모드를 보유합니다.

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

이 신호는 Qt 6.10에 도입되었습니다.


[since 6.10] angleSpanVisibleLimitChanged(real limit)

이 신호는 각도 스팬 제한이 변경되었을 때 발생합니다. limit 매개변수는 새 제한을 보유합니다.

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

이 신호는 Qt 6.10에 도입되었습니다.


clicked(PieSlice slice)

이 신호는 slice 을 클릭하거나 탭할 때 발생합니다.

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


countChanged()

이 신호는 슬라이스 수가 변경될 때 발생합니다.

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

count도 참조하세요 .


doubleClicked(PieSlice slice)

slice 을 두 번 클릭하거나 두 번 탭하면 이 신호가 발생합니다. 이 신호는 항상 clicked 이후에 발생합니다.

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


endAngleChanged()

이 신호는 파이 끝 각도가 변경될 때 발생합니다.

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

endAngle 를참조하세요 .


holeSizeChanged()

이 신호는 도넛 구멍 크기가 변경될 때 발생합니다.

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

holeSize도 참조하십시오 .


horizontalPositionChanged()

이 신호는 수평 위치가 변경될 때 발생합니다.

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

horizontalPosition도 참조하세요 .


pieSizeChanged()

이 신호는 파이 크기가 변경될 때 발생합니다.

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

pieSize도 참조하세요 .


pressed(PieSlice slice)

이 신호는 사용자가 slice 을 클릭하거나 탭하고 마우스 버튼 또는 제스처를 누르고 있을 때 발생합니다.

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


released(PieSlice slice)

이 신호는 사용자가 이전에 누른 마우스 버튼이나 제스처를 slice 에서 놓을 때 발생합니다.

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


removed(list<PieSlice> slices)

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

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


startAngleChanged()

이 신호는 파이 시작 각도가 변경될 때 발생합니다.

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

startAngle도 참조하세요 .


sumChanged()

이 신호는 모든 슬라이스의 합이 변경될 때 발생합니다.

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

sum도 참조하세요 .


verticalPositionChanged()

이 신호는 수직 위치가 변경될 때 발생합니다.

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

verticalPosition도 참조 하세요.


메서드 문서

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 을 반환합니다.


bool remove(int index)

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


void removeMultiple(int index, int count)

index 및 count 에 지정된 범위의 슬라이스를 제거합니다. 한 슬라이스를 제거하지 못하더라도 호출은 모든 슬라이스를 순회합니다.


bool replace(list<PieSlice> slices)

현재 모든 슬라이스를 slices 로 완전히 바꿉니다. 크기가 일치할 필요는 없습니다. slices 의 PieSlice 중 하나라도 유효하지 않은 경우 false를 반환합니다.


bool replace(PieSlice oldSlice, PieSlice newSlice)

oldSlice 에 지정된 슬라이스를 newSlice로 바꿉니다. 제거에 성공하면 true, 그렇지 않으면 false 을 반환합니다. oldSlice 이 성공하면 삭제됩니다.


bool replace(int index, PieSlice slice)

index 의 파이에서 slice 에 지정된 슬라이스를 대체합니다. 교체에 성공하면 true 을 반환하고, 그렇지 않으면 false 을 반환합니다.


bool take(PieSlice slice)

시리즈에서 slice 로 지정된 단일 슬라이스를 가져옵니다. 슬라이스 객체는 삭제하지 않습니다. 성공하면 true 을 반환합니다.


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