AbstractBarSeries QML Type
모든 막대 시리즈 유형에 대한 추상적인 상위 유형입니다. 더 보기...
| Import Statement: | import QtCharts 2.11 |
| In C++: | QAbstractBarSeries |
| Inherits: | |
| Inherited By: | BarSeries, HorizontalBarSeries, HorizontalPercentBarSeries, HorizontalStackedBarSeries, PercentBarSeries, and StackedBarSeries |
속성
- 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축입니다. 축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을 반환합니다.
void clear()
시리즈에서 모든 막대 세트를 제거합니다.
BarSet insert(int index, string label, VariantList values)
index 에 label 및 values 이 포함된 새 막대 집합을 추가합니다. values 은 실제 값의 목록이거나 XYPoint 유형 목록일 수 있습니다.
인덱스 값이 0보다 작거나 같으면 새 막대 세트가 막대 시리즈 앞에 추가됩니다. 인덱스 값이 막대 시리즈의 막대 세트 수보다 크거나 같으면 새 막대 세트가 막대 시리즈에 추가됩니다.
append()도 참조하세요 .
bool remove(BarSet barset)
barset 에 지정된 막대 집합을 시리즈에서 제거합니다. 성공하면 true, 그렇지 않으면 false 을 반환합니다.
© 2026 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.