BarSeries QML Type

데이터를 막대 그래프로 표시합니다. 더 보기...

Import Statement:	`import QtGraphs`
In C++:	QBarSeries
Inherits:	AbstractSeries

상속된 멤버를 포함한 모든 멤버 목록
BarSeries는 Qt Graphs 2D용 QML 유형의 일부입니다.

속성

barDelegate : Component
barSets : list<BarSet>
barWidth : real
barsType : enumeration
borderColors : list<color>
count : int
labelsAngle : real
labelsFormat : string
labelsMargin : real
labelsPosition : enumeration
labelsPrecision : real
labelsVisible : bool
seriesColors : list<color>

신호

barsetsAdded()
barsetsRemoved()

방법

BarSet at(int index)
Barset at(int index)
clear()
int find(BarSet barset)
BarSet insert(int index, string label, VariantList values)
bool remove(BarSet barset)
bool remove(int index)
removeMultiple(int index, int count)
bool replace(list<BarSet> sets)
bool replace(BarSet oldSet, BarSet newSet)
bool replace(int index, BarSet barset)

상세 설명

기본적으로 카테고리별로 그룹화된 일련의 막대로 데이터를 그리며, 각 막대 세트에서 카테고리당 하나의 막대가 시리즈에 추가됩니다. 또한 가로 막대와 그룹화된 막대를 스택 형태로 지원합니다.

속성 문서

barDelegate : Component

각 막대를 시각화하는 데 사용되는 사용자 지정 QML 컴포넌트입니다. 이 컴포넌트의 인스턴스는 각 막대에 대해 생성됩니다. 정의되지 않은 경우 막대에 대한 기본 사각형 시각화가 사용됩니다.

이 컴포넌트에 사용할 수 있는 동적 속성은 다음과 같습니다:

유형	이름	설명
color	바 색상	막대의 채우기 색상입니다. 이 값은 GraphsTheme 또는 BarSet 가 색상을 재정의하는 경우 BarSet::color 에서 가져옵니다.
color	바테두리색	바의 테두리 색상입니다. 이 값은 GraphsTheme 또는 BarSet 가 색상을 재정의하는 경우 BarSet::borderColor 에서 가져옵니다.
real	바 테두리 너비	바 테두리의 너비입니다. 이 값은 GraphsTheme 또는 BarSet 가 너비를 재정의하는 경우 BarSet::borderWidth 에서 가져옵니다.
real	barValue	막대의 값입니다. 이 값은 BarSet::values 에서 가져옵니다.
문자열	바 레이블	막대의 레이블입니다. 이 값은 BarSet::label 에서 가져옵니다.
bool	barSelected	이 값은 바가 선택된 경우, 즉 바 인덱스가 BarSet::selectedBars 에 있을 때 참입니다.

이 중 하나를 사용하려면 정의된 이름의 속성을 사용자 정의 컴포넌트에 추가하세요. 예: "property color barColor" 및 "property real barValue".

barSets : list<BarSet> [read-only]

시리즈에 추가된 세트 목록입니다.

barWidth : real

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

기본적으로 바 너비는 0.5입니다(바는 사용 가능한 너비의 50%를 차지합니다). 유효한 값의 범위는 0.0(0%)에서 1.0(100%)입니다.

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

barsType : enumeration

막대 시리즈의 유형입니다:

상수	설명
`BarSeries.BarsType.Groups`	막대 세트는 카테고리별로 그룹화됩니다. 이것이 기본값입니다.
`BarSeries.BarsType.Stacked`	막대 세트는 범주별로 서로 겹쳐서 쌓입니다.
`BarSeries.BarsType.StackedPercent`	막대 세트는 카테고리별로 서로 겹쳐서 쌓입니다. 세그먼트 크기는 스택에 있는 모든 세그먼트의 총 값과 비교한 세그먼트 값의 백분율에 해당합니다.

borderColors : list<color>

계열의 모든 개체에 사용할 테두리 색상 목록입니다.

계열이 색상보다 많으면 색상 목록이 래핑되고 목록의 첫 번째 색상으로 다시 시작됩니다. 이 옵션을 설정하지 않으면(기본값) GraphsTheme::borderColors 의 색상이 사용됩니다.

count : int [read-only]

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

labelsAngle : real

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

labelsFormat : string

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

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

labelsMargin : real

값 레이블의 여백(픽셀 단위)입니다.

이 측면 여백은 labelsPosition 이 LabelsPosition.Center 이 아닌 다른 값으로 설정된 경우에 사용됩니다. 기본값은 0 입니다.

labelsPosition : enumeration

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

상수	설명
`BarSeries.LabelsPosition.Center`	레이블은 막대 중앙에 위치합니다.
`BarSeries.LabelsPosition.InsideEnd`	레이블은 막대 상단의 막대 내부에 있습니다.
`BarSeries.LabelsPosition.InsideBase`	레이블은 하단의 막대 내부에 있습니다.
`BarSeries.LabelsPosition.OutsideEnd`	레이블은 상단의 막대 외부에 있습니다.

labelsVisible 및 labelsFormat 을참조하십시오 .

labelsPrecision : real

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

기본값은 6입니다.

labelsVisible : bool

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

seriesColors : list<color>

계열의 모든 개체에 사용할 기본 색상 목록입니다.

색상보다 시리즈가 많은 경우 색상 목록이 래핑되고 목록의 첫 번째 색상으로 다시 시작됩니다. 이 값을 설정하지 않으면(기본값) GraphsTheme::seriesColors 의 색상이 사용됩니다.

신호 문서

barsetsAdded()

이 신호는 막대 세트가 계열에 추가될 때 발생합니다.

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

barsetsRemoved()

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

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

메서드 문서

BarSet at(int index)

index 에 설정된 막대를 반환합니다. 인덱스가 유효하지 않으면 null을 반환합니다.

Barset at(int index)

시리즈에서 index 에 지정된 막대 세트를 반환합니다. 그렇지 않으면 null 을 반환합니다.

clear()

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

int find(BarSet barset)

시리즈에서 barset 에 지정된 막대 세트의 인덱스를 반환합니다. 찾을 수 없는 경우 -1 을 반환합니다.

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

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

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

append()도 참조하십시오 .

bool remove(BarSet barset)

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

bool remove(int index)

index 으로 지정된 막대 집합을 계열에서 제거합니다. 제거에 성공하면 true, 그렇지 않으면 false 을 반환합니다.

removeMultiple(int index, int count)

index 및 count 에 지정된 바 세트의 범위를 제거합니다. 한 세트 제거에 실패하더라도 호출은 모든 세트를 순회합니다.

bool replace(list<BarSet> sets)

현재 모든 바 세트를 sets 로 완전히 바꿉니다. 크기가 일치할 필요는 없습니다. sets 에 설정된 막대 중 하나라도 유효하지 않은 경우 false를 반환합니다.

bool replace(BarSet oldSet, BarSet newSet)

oldSet 에 지정된 바 세트를 newSet으로 바꿉니다. 제거에 성공하면 true, 그렇지 않으면 false 을 반환합니다. oldSet 이 성공하면 삭제됩니다.

bool replace(int index, BarSet barset)

시리즈에서 index 에 지정된 위치에 설정된 바를 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.