이 페이지에서

BarSet QML Type

막대 그래프에서 하나의 막대 세트를 나타냅니다. 더 보기...

Import Statement: import QtGraphs
In C++: QBarSet

속성

신호

방법

상세 설명

막대형 데이터 세트는 각 범주마다 하나의 데이터 값을 포함합니다. 세트의 첫 번째 값은 첫 번째 범주에, 두 번째 값은 두 번째 범주에 속하는 것으로 간주되며, 이와 같은 방식으로 이어집니다. 세트의 값 개수가 범주 수보다 적은 경우, 누락된 값은 세트의 맨 끝에 위치하는 것으로 간주됩니다. 집합 중간에 누락된 값이 있는 경우, 수치 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 ’ 유형의 목록을 설정할 수 있습니다.

실수(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)

bar 세트에서 ` 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)

count 로 지정된 개수의 값을 index 로 지정된 값부터 시작하는 막대 집합에서 제거합니다.

count 를 생략하면 index 로 지정된 값만 제거됩니다.

void replace(int index, real value)

value 로 지정된 값을 index 로 지정된 위치에 설정된 막대에 더합니다.

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)

selected 에 지정된 대로 index 에 있는 막대를 선택 또는 선택 해제 상태로 표시합니다.

참고: 선택된 막대는 지정된 경우 선택된 색상으로 그려집니다. 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.