PieSlice QML Type

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

• 상속된 멤버를 포함한 모든 멤버 목록
• PieSlice는 2D용Qt Graphs 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 ' 유형은 시리즈 내 모든 슬라이스의 합계 대비 해당 슬라이스의 비율을 계산하여 그래프에서 슬라이스의 실제 크기를 결정합니다.

기본적으로 레이블은 숨겨져 있습니다. 레이블이 표시되는 경우, 슬라이스 바깥쪽에 위치하여 선으로 연결되거나, 슬라이스 내부에 수평으로 중심을 맞추거나 슬라이스 호의 접선 또는 법선과 평행하게 배치될 수 있습니다.

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

PieSlice 유형은 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' 속성이 변경될 때 발생합니다.

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