PieSlice QML Type

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

• 상속된 멤버를 포함한 모든 멤버 목록
• PieSlice는 Qt Graphs 2D용 QML 유형에 속합니다.

속성

• angleSpan : real
• borderColor : color
• borderWidth : real
• color : color
• explodeDistanceFactor : real
• exploded : bool
• label : string
• labelArmLengthFactor : real
• labelColor : color
• labelFont : font
• labelPosition : enumeration
• labelVisible : bool
• percentage : real
• startAngle : real
• subSlicesCount : int
• subSlicesSum : real
• value : real

신호

• angleSpanChanged()
• borderColorChanged()
• borderWidthChanged()
• colorChanged()
• explodeDistanceFactorChanged()
• explodedChanged()
• labelArmLengthFactorChanged()
• labelChanged()
• labelColorChanged()
• labelFontChanged()
• labelFontChanged()
• labelPositionChanged()
• labelVisibleChanged()
• percentageChanged()
• startAngleChanged()
• subSlicesAdded(list<PieSlice> slices)
• subSlicesCountChanged(qsizetype count)
• subSlicesRemoved(list<PieSlice> slices)
• subSlicesSumChanged(qreal sum)
• valueChanged()

방법

• 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(PieSlice oldSlice, PieSlice newSlice)
• bool replace(int index, PieSlice slice)
• bool replaceAll(list<PieSlice> slices)
• bool take(PieSlice slice)

자세한 설명

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

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

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

파이슬라이스 유형은 PieSeries 유형의 하위 유형으로 사용해야 합니다. 예를 들어

PieSeries {
    PieSlice {
        label: "example"
        value: 1
    }
}

또는 PieSeries.append() 메서드를 사용하여 파이 시리즈에 슬라이스를 추가할 수 있습니다.

이 경우 PieSeries.at() 또는 PieSeries.find()를 사용하여 개별 PieSlice 인스턴스의 속성에 액세스할 수 있습니다.

파이 슬라이스는 하위 슬라이스를 포함할 수 있습니다.

PieSeries {
    PieSlice {
        label: "example"
        value: 1
        color: "orange"
        exploded: true
        PieSlice {
            label: "example2"
            value: 2
            color: "red"
        }
        PieSlice {
            label: "example3"
            value: 3
            color: "yellow"
            exploded: true
        }
    }
    PieSlice {
        label: "example4"
        value: 4
        color: "green"
    }
}

PieSeries 를참조하세요 .

속성 문서

angleSpan : real [read-only]

슬라이스의 폭을 도 단위로 나타냅니다. 전체 파이는 360도이며, 0도는 12시 방향입니다. 슬라이스가 시리즈에 추가되면 자동으로 업데이트됩니다.

borderColor : color

슬라이스 테두리를 그리는 데 사용되는 색상입니다.

borderWidth 를참조하세요 .

borderWidth : real

슬라이스 테두리의 너비입니다. 슬라이스 테두리 너비를 수정하기 위한 편의 속성입니다.

borderColor 를참조하세요 .

color : color

슬라이스의 채우기 색상입니다.

explodeDistanceFactor : real

슬라이스가 파이에서 얼마나 멀리 떨어져 폭발할지 결정합니다.

• 1.0은 거리가 반경과 같음을 의미합니다.
• 0.5는 거리가 반경의 절반임을 의미합니다.

기본적으로 거리는 0.15입니다.

exploded 를참조하세요 .

exploded : bool

슬라이스가 파이에서 분리되었는지 여부.

explodeDistanceFactor도 참조하세요 .

label : string

슬라이스의 레이블입니다.

labelArmLengthFactor : real

레이블 암의 길이입니다. 이 계수는 파이 반경에 상대적입니다. 예를 들어

• 1.0은 길이가 반경과 같음을 의미합니다.
• 0.5는 길이가 반경의 절반임을 의미합니다.

기본적으로 팔 길이는 0.15입니다.

labelVisible 를참조하세요 .

labelColor : color

슬라이스 레이블을 그리는 데 사용되는 색상입니다.

labelFont : font

슬라이스 레이블에 사용되는 글꼴입니다.

자세한 내용은 font 을 참조하세요.

labelVisible 및 labelPosition도 참조하세요 .

labelPosition : enumeration

슬라이스 레이블의 위치를 설명합니다.

labelVisible 를참조하세요 .

labelVisible : bool

슬라이스 레이블의 가시성입니다. 기본적으로 레이블은 표시되지 않습니다.

percentage : real [read-only]

시리즈의 모든 슬라이스의 합계와 비교한 슬라이스의 백분율입니다. 실제 값의 범위는 0.0에서 1.0입니다. 슬라이스가 시리즈에 추가되면 자동으로 업데이트됩니다.

startAngle : real [read-only]

이 슬라이스가 속한 계열에서 이 슬라이스의 시작 각도입니다. 전체 파이는 360도이며, 0도는 12시 방향입니다. 슬라이스가 시리즈에 추가되면 자동으로 업데이트됩니다.

subSlicesCount : int [read-only]

슬라이스의 하위 슬라이스 수입니다.

subSlicesSum : real [read-only]

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

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

value : real

슬라이스의 값입니다.

신호 문서

angleSpanChanged()

이 신호는 슬라이스의 각도 범위가 변경될 때 발생합니다.

angleSpan도 참조하세요 .

borderColorChanged()

이 신호는 슬라이스 테두리 색상이 변경될 때 발생합니다.

borderColor도 참조하세요 .

borderWidthChanged()

이 신호는 슬라이스 테두리 너비가 변경될 때 발생합니다.

borderWidth도 참조하세요 .

colorChanged()

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

explodeDistanceFactorChanged()

이 신호는 폭발 거리 계수가 변경될 때 방출됩니다.

explodeDistanceFactor도 참조하세요 .

explodedChanged()

이 신호는 폭발된 프로퍼티가 변경될 때 발생합니다.

exploded도 참조하세요 .

labelArmLengthFactorChanged()

이 신호는 라벨 암 길이 계수가 변경될 때 방출됩니다.

labelArmLengthFactor도 참조하세요 .

labelChanged()

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

label도 참조하세요 .

labelColorChanged()

이 신호는 슬라이스 레이블 색상이 변경될 때 발생합니다.

labelColor도 참조하세요 .

labelFontChanged()

이 신호는 슬라이스의 레이블 글꼴이 변경될 때 발생합니다.

labelFont도 참조하세요 .

labelFontChanged()

이 신호는 레이블 글꼴이 변경될 때 발생합니다.

labelFont도 참조하세요 .

labelPositionChanged()

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

labelPosition도 참조하세요 .

labelVisibleChanged()

이 신호는 슬라이스 레이블의 가시성이 변경될 때 발생합니다.

labelVisible도 참조하세요 .

percentageChanged()

이 신호는 슬라이스의 백분율이 변경될 때 발생합니다.

percentage도 참조하세요 .

startAngleChanged()

이 신호는 슬라이스의 시작 각도가 변경될 때 발생합니다.

startAngle도 참조하세요 .

subSlicesAdded(list<PieSlice> slices)

이 신호는 slices 에서 지정한 하위 슬라이스가 슬라이스에 추가될 때 발생합니다.

subSlicesCountChanged(qsizetype count)

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

subSlicesCount도 참조하세요 .

subSlicesRemoved(list<PieSlice> slices)

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

subSlicesSumChanged(qreal sum)

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

subSlicesSum도 참조하세요 .

valueChanged()

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

value도 참조하세요 .

메서드 문서

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(PieSlice oldSlice, PieSlice newSlice)

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

bool replace(int index, PieSlice slice)

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

bool replaceAll(list<PieSlice> slices)

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

bool take(PieSlice slice)

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