BarSet QML Type
막대 그래프에서 한 세트의 막대를 나타냅니다. 더 보기...
| Import Statement: | import QtGraphs |
| In C++: | QBarSet |
- 상속된 멤버를 포함한 모든 멤버 목록
- BarSet은 Qt Graphs 2D용 QML 유형의 일부입니다.
속성
- borderColor : color
- borderWidth : real
- color : color
- count : int
- label : string
- labelColor : color
- selectedBars : list
- selectedColor : color
- values : list<variant>
신호
- borderColorChanged(color)
- borderWidthChanged(real width)
- colorChanged(color)
- countChanged()
- labelChanged()
- labelColorChanged(color)
- selectedBarsChanged(list<int> indexes)
- selectedColorChanged(color color)
- update()
- updatedBars()
- valueAdded(int index, int count)
- valueChanged(int index)
- valueRemoved(int index, int count)
- valuesAdded(int index, int count)
- valuesChanged()
- valuesRemoved(int index, int count)
방법
- void append(list<real> values)
- void append(real value)
- real at(int index)
- void clear()
- int count()
- void deselectAllBars()
- void deselectBar(int index)
- void deselectBars(list<int> indexes)
- void insert(int index, real value)
- bool isBarSelected(int index)
- void remove(int index, int count)
- void replace(int index, real value)
- void selectAllBars()
- void selectBar(int index)
- void selectBars(list<int> indexes)
- void setBarSelected(int index, bool selected)
- real sum()
- void toggleSelection(list<int> indexes)
상세 설명
막대 세트는 각 카테고리에 대해 하나의 데이터 값을 포함합니다. 집합의 첫 번째 값은 첫 번째 카테고리에, 두 번째 값은 두 번째 카테고리에 속하는 것으로 가정합니다. 집합의 값이 카테고리의 수보다 적은 경우 누락된 값은 집합의 끝에 있는 것으로 간주합니다. 집합의 중간에 누락된 값이 있는 경우 숫자 값 0이 사용됩니다. 0 값 집합에 대한 레이블은 표시되지 않습니다.
BarSeries 을참조하세요 .
속성 문서
borderColor : color
막대의 테두리 색상을 설정합니다.
borderWidth : real
기본적으로 너비는 -1이며, 테두리 너비는 테마에 의해 정의됩니다.
color : color
막대의 채우기 색상을 설정합니다.
count : int [read-only]
막대 세트의 값 수입니다.
label : string
막대 세트의 레이블입니다.
labelColor : color
막대의 텍스트(레이블) 색상을 설정합니다.
selectedBars : list [read-only]
현재 선택된 막대의 인덱스입니다.
selectedColor : color
선택한 세트의 채우기 색상입니다.
values : list<variant>
막대 세트의 값입니다. 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)];
신호 문서
borderColorChanged(color)
이 신호는 막대 세트의 테두리 색상이 color 로 변경될 때 발생합니다.
참고: 해당 핸들러는 onBorderColorChanged 입니다.
borderWidthChanged(real width)
이 신호는 바셋의 테두리 너비가 변경될 때 발생합니다. 새 너비는 width 입니다.
참고: 해당 핸들러는 onBorderWidthChanged 입니다.
colorChanged(color)
이 신호는 막대 세트의 채우기 색이 color 로 변경될 때 발생합니다.
참고: 해당 핸들러는 onColorChanged 입니다.
countChanged()
이 신호는 바셋의 값 수가 변경될 때 발생합니다.
참고: 해당 핸들러는 onCountChanged 입니다.
labelChanged()
이 신호는 막대 세트의 레이블이 변경될 때 발생합니다.
참고: 해당 핸들러는 onLabelChanged 입니다.
label도 참조하세요 .
labelColorChanged(color)
이 신호는 막대 세트의 텍스트(레이블) 색상이 color 로 변경될 때 발생합니다.
참고: 해당 핸들러는 onLabelColorChanged 입니다.
selectedBarsChanged(list<int> indexes)
이 신호는 선택한 막대가 변경될 때 발생합니다. indexes 는 선택한 막대 인덱스 목록입니다.
참고: 해당 핸들러는 onSelectedBarsChanged 입니다.
selectedColorChanged(color color)
이 신호는 선택한 막대 색상이 변경될 때 방출됩니다. 새 색상은 color 입니다.
참고: 해당 핸들러는 onSelectedColorChanged 입니다.
update()
이 신호는 바셋이 업데이트될 때 발생합니다.
참고: 해당 핸들러는 onUpdate 입니다.
updatedBars()
이 신호는 이 세트의 막대가 업데이트될 때 발생합니다.
참고: 해당 핸들러는 onUpdatedBars 입니다.
valueAdded(int index, int count)
이 신호는 막대 세트에 새 값이 추가될 때 발생합니다. index 은 처음 삽입된 값의 위치를 나타내고 count 은 삽입된 값의 수를 나타냅니다.
참고: 해당 핸들러는 onValueAdded 입니다.
valueChanged(int index)
이 신호는 index 에 지정된 위치의 값이 수정될 때 발생합니다.
참고: 해당 핸들러는 onValueChanged 입니다.
valueRemoved(int index, int count)
이 신호는 막대 세트에서 값이 제거될 때 발생합니다. index 은 제거된 첫 번째 값의 위치를 나타내고 count 은 제거된 값의 수를 나타냅니다.
참고: 해당 핸들러는 onValueRemoved 입니다.
valuesAdded(int index, int count)
이 신호는 막대 세트에 새 값이 추가될 때 발생합니다. index 은 처음 삽입된 값의 위치를 나타내고 count 은 삽입된 값의 수를 나타냅니다.
참고: 해당 핸들러는 onValuesAdded 입니다.
valuesChanged()
이 신호는 막대 세트의 값이 변경될 때 발생합니다.
참고: 해당 핸들러는 onValuesChanged 입니다.
valuesRemoved(int index, int count)
이 신호는 막대 세트에서 값이 제거될 때 발생합니다. index 은 제거된 첫 번째 값의 위치를 나타내고 count 은 제거된 값의 수를 나타냅니다.
참고: 해당 핸들러는 onValuesRemoved 입니다.
메서드 문서
void append(list<real> values)
values 에 지정된 실제 값 목록을 막대 집합의 끝에 추가합니다.
append()도 참조하세요 .
void append(real value)
value 에 지정된 새 값을 막대 집합의 끝에 추가합니다.
real at(int index)
막대 집합에서 index 에 지정된 값을 반환합니다. 인덱스가 범위를 벗어난 경우 0.0이 반환됩니다.
void clear()
집합에서 모든 값을 제거합니다.
int count()
막대 집합의 값 개수를 반환합니다.
void deselectAllBars()
세트의 모든 막대를 선택 해제합니다.
참고: BarSet::selectedBarsChanged 을 내보냅니다.
setBarSelected()도 참조하세요 .
void deselectBar(int index)
index 에서 막대를 선택 해제합니다.
참고: BarSet::selectedBarsChanged 을 내보냅니다.
setBarSelected()도 참조하세요 .
void deselectBars(list<int> indexes)
indexes 목록에서 전달된 여러 개의 막대를 선택 취소된 것으로 표시합니다.
참고: BarSet::selectedBarsChanged 를 내보냅니다.
setBarSelected()도 참조하세요 .
void insert(int index, real value)
index 으로 지정한 위치에 value 을 삽입합니다. 삽입된 값 다음에 오는 값은 한 위치 위로 이동합니다.
remove()도 참조하세요 .
bool isBarSelected(int index)
지정된 index 의 막대가 선택된 막대 중 하나이면 true, 그렇지 않으면 false 을 반환합니다.
참고: 선택된 막대는 BarSet::setSelectedColor를 사용하여 지정한 경우 선택한 색을 사용하여 그려집니다.
selectedBars, setBarSelected() 및 selectedColor 를참조하세요 .
void remove(int index, int count)
index 에 지정된 값으로 시작하는 바 세트에서 count 에 지정된 값의 개수를 제거합니다.
count 을 생략하면 index 에 지정된 값만 제거됩니다.
void replace(int index, real value)
index 에 지정된 위치에 설정된 막대에 value 에 지정된 값을 추가합니다.
void selectAllBars()
세트의 모든 막대를 선택한 것으로 표시합니다.
참고: BarSet::selectedBarsChanged 을 내보냅니다.
setBarSelected()도 참조하세요 .
void selectBar(int index)
index 막대를 선택한 것으로 표시합니다.
참고: BarSet::selectedBarsChanged 을 전송합니다.
setBarSelected()도 참조하세요 .
void selectBars(list<int> indexes)
indexes 목록에서 전달된 여러 막대를 선택한 것으로 표시합니다.
참고: BarSet::selectedBarsChanged 를 내보냅니다.
setBarSelected()도 참조하세요 .
void setBarSelected(int index, bool selected)
index 에 있는 막대를 selected 에서 지정한 대로 선택 또는 선택 취소된 것으로 표시합니다.
참고: 선택된 막대는 지정된 경우 선택한 색상을 사용하여 그려집니다. BarSet::selectedBarsChanged 을 내보냅니다.
isBarSelected() 및 selectedColor 을참조하세요 .
real sum()
막대 집합의 모든 값의 합계를 반환합니다.
void toggleSelection(list<int> indexes)
지정된 indexes 에서 막대의 선택 상태를 반대쪽 막대로 변경합니다.
참고: BarSet::selectedBarsChanged 을 반환합니다.
setBarSelected()도 참조하세요 .
© 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.