BarSeries QML Type

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

• 상속된 멤버를 포함한 모든 멤버 목록
• BarSeries는 2D용Qt Graphs 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()
• clicked(int index, BarSet barset)
• doubleClicked(int index, BarSet barset)
• pressed(int index, BarSet barset)
• released(int index, BarSet barset)

방법

• bool append(BarSet barset)
• BarSet at(int index)
• Barset at(int index)
• void clear()
• int find(BarSet barset)
• BarSet insert(int index, BarSet barset)
• bool remove(BarSet barset)
• bool remove(int index)
• void 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 컴포넌트입니다. 각 막대에 대해 이 컴포넌트의 인스턴스가 생성됩니다. 이 컴포넌트가 정의되지 않은 경우, 막대에 대한 기본 사각형 시각화 방식이 사용됩니다.

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

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

barSets : list<BarSet> [read-only]

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

barWidth : real

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

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

barsType : enumeration

막대 시리즈의 유형:

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

데이터 값 레이블의 위치:

labelsVisible 및 labelsFormat도 참조하십시오 .

labelsPrecision : real

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

기본값은 6입니다.

labelsVisible : bool

막대형 시리즈에서 레이블의 표시 여부입니다. 레이블의 기본 표시 여부는 ‘ false ’입니다.

‘ barDelegate’ 항목도 참조하십시오 .

seriesColors : list<color>

이 시리즈의 모든 객체에 사용될 기본 색상 목록입니다.

시리즈 수가 색상 수보다 많을 경우, 색상 목록은 순환되어 목록의 첫 번째 색상부터 다시 시작됩니다. 이 옵션이 설정되지 않은 경우(기본값), GraphsTheme::seriesColors 의 색상이 사용됩니다.

Signal 문서

barsetsAdded()

이 신호는 시리즈에 막대 집합이 추가될 때 발생합니다.

barsetsRemoved()

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

clicked(int index, BarSet barset)

이 신호는 사용자가 barset 로 지정된 바 세트 내에서 index 로 지정된 바를 클릭하거나 탭할 때 발생합니다.

doubleClicked(int index, BarSet barset)

이 신호는 사용자가 barset 로 지정된 막대 세트 내에서 index 로 지정된 막대를 더블 클릭하거나 더블 탭할 때 발생합니다. 이 신호는 항상 clicked 이후에 발생합니다.

pressed(int index, BarSet barset)

이 신호는 사용자가 ` barset `로 지정된 바 세트 내에서 ` index `로 지정된 바를 클릭하거나 탭한 후 마우스 버튼이나 제스처를 계속 누르고 있을 때 발생합니다.

released(int index, BarSet barset)

이 신호는 사용자가 barset 로 지정된 바 세트 내의 index 로 지정된 바에서 이전에 눌렀던 마우스 버튼이나 제스처를 놓을 때 발생합니다.

메서드 문서

bool append(BarSet barset)

barset 로 지정된 막대 집합을 막대 시계에 추가하고, 해당 집합의 소유권을 인수합니다. 집합이 null이거나 이미 해당 시계에 속해 있는 경우, 추가되지 않습니다.

추가에 성공하면 true 를 반환합니다.

insert()도 참조하십시오 .

BarSet at(int index)

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

Barset at(int index)

시리즈에서 ` index `로 지정된 막대 집합을 반환합니다. 그렇지 않은 경우 ` null `를 반환합니다.

void clear()

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

int find(BarSet barset)

시리즈에서 ` barset `로 지정된 막대 세트의 인덱스를 반환합니다. 해당 항목이 없으면 ` -1 `를 반환합니다.

BarSet insert(int index, BarSet barset)

barset 로 지정된 막대 집합을 index 로 지정된 위치의 시리즈에 삽입합니다. 해당 집합이 null 이거나 이미 해당 시리즈에 속해 있는 경우, 집합은 추가되지 않습니다. 삽입에 성공하면 true 를 반환합니다.

append()도 참조하십시오 .

bool remove(BarSet barset)

barset 로 지정된 막대 집합을 시리즈에서 제거합니다. 성공하면 true 를 반환하고, 그렇지 않으면 false 를 반환합니다.

bool remove(int index)

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

void 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 를 반환합니다.