Back to Qt.io
Contact Us Blog Download Qt

AbstractBarSeries QML Type

모든 막대 시리즈 유형에 대한 추상적인 상위 유형입니다. 더 보기...

Import Statement: import QtCharts 2.8
In C++: QAbstractBarSeries
Inherits:

AbstractSeries

Inherited By:

BarSeries, HorizontalBarSeries, HorizontalPercentBarSeries, HorizontalStackedBarSeries, PercentBarSeries, and StackedBarSeries

속성

신호

방법

  • BarSet append(string label, VariantList values)
  • BarSet at(int index)
  • 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축입니다. 축X와 axisXTop 를 모두 정의하지 않은 상태로 두면 시리즈에 대해 BarCategoryAxis 가 만들어집니다.

axisXTop 를참조하세요 .


axisXTop : AbstractAxis

차트 보기 위에 그려지는 시리즈에 사용되는 x축입니다.

참고: axisX 또는 axisXTop 중 하나만 제공할 수 있으며 둘 다 제공할 수는 없습니다.

axisX도 참조하십시오 .


axisY : AbstractAxis

시리즈에 사용되는 y축입니다. 축Y 및 axisYRight 를 모두 정의하지 않은 상태로 두면 시리즈에 대해 ValueAxis 가 만들어집니다.

axisYRight도 참조하십시오 .


axisYRight : AbstractAxis

차트 보기의 오른쪽에 그려지는 시리즈에 사용되는 y축입니다.

참고: axisY 또는 axisYRight 중 하나만 제공할 수 있으며 둘 다 제공할 수는 없습니다.

axisY도 참조하십시오 .


barWidth : real

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

참고: BarSeries 유형과 함께 사용하는 경우 이 값은 단일 막대의 너비가 아닌 막대 그룹의 너비를 지정합니다.


count : int [read-only]

막대 시리즈의 막대 세트 수입니다.


labelsAngle : real

값 레이블의 각도(도)입니다.


labelsFormat : string

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

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


labelsPosition : enumeration

데이터 값 레이블의 위치입니다:

상수설명
AbstractBarSeries.LabelsCenter레이블은 막대 중앙에 위치합니다.
AbstractBarSeries.LabelsInsideEnd레이블은 상단의 막대 내부에 있습니다.
AbstractBarSeries.LabelsInsideBase레이블은 하단의 막대 내부에 있습니다.
AbstractBarSeries.LabelsOutsideEnd레이블은 상단의 막대 외부에 있습니다.

labelsVisible 및 labelsFormat 을참조하십시오 .


labelsPrecision : real

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

기본값은 6입니다.


labelsVisible : bool

막대 시리즈에서 레이블의 가시성입니다.


신호 문서

barsetsAdded()

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

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

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


barsetsRemoved()

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

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

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


clicked(int index, BarSet barset)

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

해당 신호 핸들러는 onClicked 입니다.

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


doubleClicked(int index, BarSet barset)

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

해당 신호 핸들러는 onDoubleClicked 입니다.

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


hovered(bool status, int index, BarSet barset)

이 신호는 barset 으로 지정된 바 세트에서 index 으로 지정된 바 위로 마우스를 가져가면 발생합니다. 마우스가 막대 위로 이동하면 status 이 true 으로 바뀌고 마우스가 다시 멀어지면 false 으로 바뀝니다.

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

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


pressed(int index, BarSet barset)

이 신호는 사용자가 barset 으로 지정된 바 세트에서 index 으로 지정된 바를 클릭하고 마우스 버튼을 누르고 있을 때 발생합니다.

해당 신호 핸들러는 onPressed 입니다.

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


released(int index, BarSet barset)

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

해당 신호 핸들러는 onReleased 입니다.

참고: 해당 핸들러는 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을 반환합니다.


clear()

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


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

label 및 values 으로 구성된 새 막대 집합을 index 에 추가합니다. values 은 실제 값의 목록이거나 XYPoint 유형 목록일 수 있습니다.

인덱스 값이 0보다 작거나 같으면 새 막대 세트가 막대 시리즈 앞에 추가됩니다. 인덱스 값이 막대 시리즈의 막대 세트 수보다 크거나 같으면 새 막대 세트가 막대 시리즈에 추가됩니다.

append()도 참조하세요 .


bool remove(BarSet barset)

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


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