BarSet QML Type
막대 차트에서 하나의 막대 세트를 나타냅니다. 더 보기...
| Import Statement: | import QtCharts 2.12 |
| In C++: | QBarSet |
| Status: | Deprecated |
이 유형은 더 이상 권장되지 않습니다. 새로운 코드에서는 이 유형을 사용하지 않는 것을 강력히 권장합니다.
속성
- borderColor : color
- borderWidth : real
- brushFilename : string
- color : color
- count : int
- label : string
- labelColor : color
- labelFont : font
- values : list<var>
신호
- clicked(int index)
- doubleClicked(int index)
- pressed(int index)
- released(int index)
- valueChanged(int index)
- valuesAdded(int index, int count)
- valuesRemoved(int index, int count)
방법
- void append(real value)
- real at(int index)
- void remove(int index, int count)
- void replace(int index, real value)
상세 설명
막대형 데이터 세트는 각 범주마다 하나의 데이터 값을 포함합니다. 세트의 첫 번째 값은 첫 번째 범주에, 두 번째 값은 두 번째 범주에 속하는 것으로 간주되며, 이와 같은 방식으로 이어집니다. 세트의 값 개수가 범주 수보다 적은 경우, 누락된 값은 세트의 끝에 위치한 것으로 간주됩니다. 집합 중간에 누락된 값이 있는 경우, 숫자 0이 사용됩니다. 0값으로 구성된 집합의 레이블은 표시되지 않습니다.
AbstractBarSeries, BarSeries, StackedBarSeries, PercentBarSeries, HorizontalBarSeries, HorizontalStackedBarSeries 및 HorizontalPercentBarSeries도 참조하십시오 .
속성 문서
borderColor : color
막대 세트의 선(펜) 색상.
borderWidth : real
테두리 선의 너비입니다. 기본값은 2.0입니다.
brushFilename : string
해당 세트의 브러시로 사용되는 파일의 이름.
color : color
막대 세트의 채우기(브러시) 색상입니다.
count : int
막대 집합에 포함된 값의 개수.
label : string
바 세트의 라벨.
labelColor : color
막대 그룹의 텍스트(라벨) 색상.
labelFont : font
막대 그래프 세트의 레이블을 그리는 데 사용되는 글꼴입니다.
자세한 내용은 font 을 참조하십시오.
values : list<var>
막대 세트의 값입니다. 값으로 real 또는 point 유형의 목록을 설정할 수 있습니다.
실수(real) 유형의 목록을 값으로 설정하면, 이 목록이 바로 막대 집합의 값을 정의합니다.
점(point) 유형의 목록을 값으로 설정하는 경우, 점의 x-좌표가 막대 집합 내에서 해당 점의 0을 기준으로 한 인덱스를 지정합니다. 막대 집합의 크기는 가장 큰 x좌표 값 + 1입니다. 0과 가장 큰 값 사이의 x좌표에 해당하는 점이 누락된 경우, 해당 점의 값은 0으로 설정됩니다.
예를 들어, 다음 막대 집합들은 동일한 값을 가집니다:
myBarSet1.values = [5, 0, 1, 5];
myBarSet2.values = [Qt.point(0, 5), Qt.point(2, 1), Qt.point(3, 5)];신호 문서
clicked(int index)
이 신호는 사용자가 바 세트 내에서 ` index `로 지정된 바를 클릭할 때 발생합니다.
이에 해당하는 신호 핸들러는 onClicked 입니다.
참고: 해당 핸들러는 onClicked 입니다.
doubleClicked(int index)
이 신호는 사용자가 바 세트 내에서 ` index `로 지정된 바를 더블 클릭할 때 발생합니다.
이에 대응하는 신호 핸들러는 ` onDoubleClicked`입니다.
참고: 해당핸들러는 ` onDoubleClicked`입니다.
pressed(int index)
이 신호는 사용자가 바 세트 내에서 index 로 지정된 바를 클릭한 후 마우스 버튼을 누른 상태로 유지할 때 발생합니다.
이에 대응하는 신호 핸들러는 onPressed 입니다.
참고: 해당 핸들러는 onPressed 입니다.
released(int index)
이 신호는 사용자가 바 세트 내에서 ` index `로 지정된 바에 대한 마우스 클릭을 해제할 때 발생합니다.
이에 대응하는 신호 핸들러는 onReleased 입니다.
참고: 이에 해당하는핸들러는 onReleased 입니다.
valueChanged(int index)
index 로 지정된 위치의 값이 변경되면 이 신호가 발생합니다.
이에 대응하는 신호 핸들러는 onValueChanged 입니다.
참고: 해당 핸들러는 onValueChanged 입니다.
valuesAdded(int index, int count)
이 신호는 막대 집합에 새로운 값이 추가될 때 발생합니다. index 는 처음 삽입된 값의 위치를 나타내며, count 는 삽입된 값의 개수입니다.
이에 대응하는 신호 핸들러는 onValuesAdded 입니다.
참고: 해당 핸들러는 onValuesAdded 입니다.
valuesRemoved(int index, int count)
이 신호는 막대 집합에서 값이 제거될 때 발생합니다. ` index `는 가장 먼저 제거된 값의 위치를 나타내며, ` count `는 제거된 값의 개수입니다.
이에 대응하는 신호 핸들러는 onValuesRemoved 입니다.
참고: 해당 핸들러는 onValuesRemoved 입니다.
메서드 문서
void append(real value)
value 로 지정된 새 값을 막대 집합의 끝에 추가합니다.
real at(int index)
바 세트에서 ` index `로 지정된 값을 반환합니다. 인덱스가 범위를 벗어날 경우 0.0이 반환됩니다.
void remove(int index, int count)
count 로 지정된 개수의 값을 index 로 지정된 값부터 시작하는 막대 집합에서 제거합니다.
count 를 생략하면 index 로 지정된 값만 제거됩니다.
void replace(int index, real value)
value 로 지정된 값을 index 로 지정된 위치에 설정된 막대에 더합니다.
© 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.