AbstractBarSeries QML Type

모든 막대형 시리즈 유형을 포괄하는 추상 상위 유형입니다. 더 보기...

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

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

속성

• axisX : AbstractAxis
• axisXTop : AbstractAxis
• axisY : AbstractAxis
• axisYRight : AbstractAxis
• barWidth : real
• count : int
• labelsAngle : real
• labelsFormat : string
• labelsPosition : enumeration
• labelsPrecision : real
• labelsVisible : bool

신호

• barsetsAdded()
• barsetsRemoved()
• clicked(int index, BarSet barset)
• doubleClicked(int index, BarSet barset)
• hovered(bool status, int index, BarSet barset)
• pressed(int index, BarSet barset)
• released(int index, BarSet barset)

방법

• BarSet append(string label, VariantList values)
• BarSet at(int index)
• void clear()
• BarSet insert(int index, string label, VariantList values)
• bool remove(BarSet barset)

상세 설명

막대 차트에서 막대는 각 범주별로 하나의 데이터 값을 포함하는 막대 집합으로 정의됩니다. 막대의 위치는 범주에 의해 지정되고, 높이는 데이터 값에 의해 결정됩니다. 여러 막대 집합을 포함하는 막대 시계열은 동일한 범주에 속하는 막대들을 그룹으로 묶습니다. 막대의 표시 방식은 막대 차트 생성에 선택된 유형( BarSeries, StackedBarSeries, PercentBarSeries, HorizontalBarSeries, HorizontalStackedBarSeries 또는 HorizontalPercentBarSeries)에 따라 결정됩니다.

메인 막대 차트 축에 BarCategoryAxis 유형 대신 ValueAxis 유형을 사용하는 경우, 막대들은 범주의 인덱스 값을 기준으로 그룹화됩니다.

다음 QML 코드 예제는 BarSeries 및 BarCategoryAxis 유형을 사용하여 간단한 막대 차트를 만드는 방법을 보여줍니다:

ChartView {
    title: "Bar Chart"
    anchors.fill: parent
    legend.alignment: Qt.AlignBottom
    antialiasing: true

    BarSeries {
        id: mySeries
        axisX: BarCategoryAxis { categories: ["2007", "2008", "2009", "2010", "2011", "2012" ] }
        BarSet { label: "Bob"; values: [2, 2, 3, 4, 5, 6] }
        BarSet { label: "Susan"; values: [5, 1, 2, 4, 1, 7] }
        BarSet { label: "James"; values: [3, 5, 8, 13, 5, 8] }
    }
}

속성 문서

axisX : AbstractAxis

시리즈에 사용되는 x축입니다. axisX와 axisXTop 를 모두 지정하지 않으면, 해당 시리즈에 대해 BarCategoryAxis가 생성됩니다.

axisXTop항목도 참조하십시오 .

axisXTop : AbstractAxis

차트 뷰 위에 그려진 시리즈에 사용되는 x축입니다.

axisX항목도 참조하십시오 .

axisY : AbstractAxis

시리즈에 사용되는 y축입니다. axisY와 axisYRight 를 모두 정의하지 않으면, 시리즈에 대해 ValueAxis가 생성됩니다.

axisYRight항목도 참조하십시오 .

axisYRight : AbstractAxis

차트 뷰의 오른쪽에 그려진, 해당 계열에 사용되는 y축입니다.

axisY항목도 참조하십시오 .

barWidth : real

너비의 단위는 x축의 단위입니다. 막대의 최소 너비는 0이며, 음수 값은 0으로 처리됩니다. 너비를 0으로 설정하면 x축의 배율과 관계없이 화면상의 막대 너비가 1픽셀이 됩니다. 0보다 넓은 막대는 x축 배율을 사용하여 크기가 조정됩니다.

count : int [read-only]

막대 그래프 시리즈에 포함된 막대 세트의 개수.

labelsAngle : real

값 레이블의 각도(도 단위).

labelsFormat : string

막대형 시리즈에서 레이블을 표시하는 데 사용되는 형식입니다.

QAbstractBarSeries::labelsFormat, labelsVisible 및 labelsPosition도 참조하십시오 .

labelsPosition : enumeration

데이터 값 레이블의 위치:

labelsVisible 및 labelsFormat도 참조하십시오 .

labelsPrecision : real

값 레이블에 표시되는 유효 자릿수의 최대 개수입니다.

기본값은 6입니다.

labelsVisible : bool

막대형 시리즈에서 레이블의 표시 여부.

Signal 문서

barsetsAdded()

이 신호는 시리즈에 막대 집합이 추가될 때 발생합니다.

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

barsetsRemoved()

이 신호는 시리즈에서 막대 세트가 제거될 때 발생합니다.

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

clicked(int index, BarSet barset)

이 신호는 사용자가 barset 로 지정된 바 세트에서 index 로 지정된 바를 클릭할 때 발생합니다.

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

doubleClicked(int index, BarSet barset)

이 신호는 사용자가 barset 로 지정된 막대 세트 내에서 index 로 지정된 막대를 더블 클릭할 때 발생합니다.

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

hovered(bool status, int index, BarSet barset)

이 신호는 barset 로 지정된 막대 세트 중 index 로 지정된 막대 위로 마우스를 올렸을 때 발생합니다. 마우스가 막대 위로 이동하면 status 가 true 로 바뀌고, 마우스가 다시 멀어지면 false 로 바뀝니다.

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

pressed(int index, BarSet barset)

이 신호는 사용자가 barset 로 지정된 바 세트 내에서 index 로 지정된 바를 클릭한 후 마우스 버튼을 누른 상태로 유지할 때 발생합니다.

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

released(int index, BarSet barset)

이 신호는 사용자가 barset 로 지정된 바 세트 내의 index 로 지정된 바에서 마우스 버튼을 놓을 때 발생합니다.

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

메서드 설명서

BarSet append(string label, VariantList values)

인덱스에 ` label ` 및 ` values `이 포함된 새로운 막대 세트를 추가합니다. ` values `은 실수 값의 목록입니다.

예를 들어:

myBarSeries.append("set 1", [0, 0.2, 0.2, 0.5, 0.4, 1.5, 0.9]);

BarSet at(int index)

index 에 설정된 막대를 반환합니다. 인덱스가 유효하지 않은 경우 null을 반환합니다.

void clear()

시리즈에서 모든 바 세트를 제거합니다.

BarSet insert(int index, string label, VariantList values)

index 에 label 및 values 를 포함한 새로운 막대 세트를 추가합니다. values 는 실수 값의 목록이거나 XYPoint 유형의 목록일 수 있습니다.

인덱스 값이 0 이하인 경우, 새로운 막대 세트가 막대 시계열의 맨 앞에 추가됩니다. 인덱스 값이 막대 시계열에 포함된 막대 세트의 개수보다 크거나 같은 경우, 새로운 막대 세트가 막대 시계열의 맨 뒤에 추가됩니다.

append()도 참조하십시오 .

bool remove(BarSet barset)

barset 로 지정된 막대 집합을 시리즈에서 제거합니다. 성공하면 true 를 반환하고, 그렇지 않으면 false 를 반환합니다.