PieSeries QML Type

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

• 상속된 멤버를 포함한 모든 멤버 목록
• PieSeries는 2D용Qt Graphs QML 유형의 일부입니다.

속성

• angleSpanLabelVisibility : enumeration (since 6.10)
• angleSpanVisibleLimit : real (since 6.10)
• count : int
• endAngle : real
• holeSize : real
• horizontalPosition : real
• pieSize : real
• sliceData : list<real> (since 6.12)
• sliceLabels : list<string> (since 6.12)
• startAngle : real
• sum : real
• verticalPosition : real

신호

• added(list<PieSlice> slices)
• angleSpanLabelVisibilityChanged(LabelVisibility visibility) (since 6.10)
• angleSpanVisibleLimitChanged(real limit) (since 6.10)
• clicked(PieSlice slice)
• countChanged()
• doubleClicked(PieSlice slice)
• endAngleChanged()
• holeSizeChanged()
• horizontalPositionChanged()
• pieSizeChanged()
• pressed(PieSlice slice)
• released(PieSlice slice)
• removed(list<PieSlice> slices)
• sliceDataChanged(list<real> sliceData) (since 6.12)
• sliceLabelsChanged(list<string> sliceLabels) (since 6.12)
• startAngleChanged()
• sumChanged()
• verticalPositionChanged()

방법

• PieSlice append(string label, real value)
• PieSlice at(int index)
• void 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 ` 유형을 사용하여 정의된 슬라이스로 구성됩니다. `PieSeries` 유형은 시리즈 내 모든 슬라이스의 합계 대비 각 슬라이스의 비율을 계산하여 그래프에서 슬라이스의 실제 크기를 결정하므로, 슬라이스에는 어떤 값이든 지정할 수 있습니다.

그래프상의 파이 크기와 위치는 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 가 설정되지 않은 경우에는 효과가 없습니다.

이 속성은 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은 최소 파이 크기(파이 차트가 그려지지 않음)입니다.
• 1.0은 그래프에 들어갈 수 있는 최대 파이 크기입니다.

이 속성을 설정할 때, 구멍의 크기가 파이 크기보다 크지 않도록 필요에 따라 ` holeSize ` 속성이 조정됩니다.

기본값은 0.7입니다.

sliceData : list<real> [since 6.12]

선언적 파이 슬라이스 값.

이 속성을 사용하면 파이 슬라이스에 선언적으로 값을 지정할 수 있습니다. 이 속성이 설정되면, pieseries는 각 값에 대해 자동으로 파이 슬라이스를 생성합니다. 슬라이스의 레이블은 ` sliceLabels`에서 지정할 수 있습니다.

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

sliceLabels도 참조하십시오 .

sliceLabels : list<string> [since 6.12]

선언적 파이 슬라이스 레이블.

이 속성은 파이 슬라이스에 선언적으로 레이블을 지정하는 데 사용할 수 있습니다. 이 속성이 설정되면, pieseries는 선언적으로 생성된 파이 슬라이스에 레이블을 설정합니다. 레이블은 sliceData 에 있는 값의 순서와 동일해야 합니다. 선언적인 파이 슬라이스가 충분하지 않은 경우, 나머지 레이블은 무시됩니다.

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

sliceData도 참조하십시오 .

startAngle : real

원의 시작 각도.

원형 파이의 전체 각도는 360도이며, 0도는 12시 방향에 해당합니다.

기본값은 0입니다.

sum : real [read-only]

모든 슬라이스의 합.

이 시퀀스는 포함된 모든 슬라이스의 합계를 추적합니다.

verticalPosition : real

파이 차트의 수직 위치.

이 값은 그래프 사각형을 기준으로 한 상대적 값이므로,

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

기본값은 0.5(중앙)입니다.

horizontalPosition도 참조하십시오 .

Signal 문서

added(list<PieSlice> slices)

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

[since 6.10] angleSpanLabelVisibilityChanged(LabelVisibility visibility)

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

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

[since 6.10] angleSpanVisibleLimitChanged(real limit)

이 신호는 각도 범위 제한이 변경되었을 때 발신됩니다. limit 매개변수에는 새로운 제한값이 저장됩니다.

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

clicked(PieSlice slice)

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

countChanged()

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

count도 참조하십시오 .

doubleClicked(PieSlice slice)

이 신호는 slice 를 더블 클릭하거나 더블 탭했을 때 발생합니다. 이 신호는 항상 clicked 이후에 발생합니다.

endAngleChanged()

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

endAngle도 참조하십시오 .

holeSizeChanged()

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

holeSize도 참조하십시오 .

horizontalPositionChanged()

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

horizontalPosition도 참조하십시오 .

pieSizeChanged()

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

pieSize도 참조하십시오 .

pressed(PieSlice slice)

사용자가 slice 를 클릭하거나 탭한 후 마우스 버튼이나 제스처를 누른 상태로 유지할 때 이 신호가 발생합니다.

released(PieSlice slice)

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

removed(list<PieSlice> slices)

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

[since 6.12] sliceDataChanged(list<real> sliceData)

이 신호는 슬라이스 데이터가 변경되었을 때 발생합니다. sliceData 매개변수는 슬라이스 데이터를 저장합니다.

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

[since 6.12] sliceLabelsChanged(list<string> sliceLabels)

이 신호는 슬라이스 데이터가 변경되었을 때 발생합니다. sliceLabels 매개변수는 슬라이스 데이터를 포함합니다.

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

startAngleChanged()

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

startAngle도 참조하십시오 .

sumChanged()

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

sum도 참조하십시오 .

verticalPositionChanged()

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

verticalPosition도 참조하십시오 .

메서드 문서

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

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