BarModelMapper QML Type
막대형 차트용 모델 매퍼. 더 보기...
| Import Statement: | import QtGraphs |
| In C++: | QBarModelMapper |
- 상속된 멤버를 포함한 모든 멤버 목록
- BarModelMapper는 2D용Qt Graphs QML 유형의 일부입니다.
속성
- count : qsizetype
- first : qsizetype
- firstBarSetSection : qsizetype
- lastBarSetSection : qsizetype
- model : model
- orientation : orientation
- series : BarSeries
신호
- countChanged()
- firstBarSetSectionChanged()
- firstChanged()
- lastBarSetSectionChanged()
- modelChanged()
- orientationChanged()
- orientationChanged()
- seriesChanged()
상세 설명
BarModelMapper 유형을 사용하면 QAbstractItemModel 클래스에서 파생된 데이터 모델을 그래프의 데이터 소스로 활용할 수 있습니다. 모델 매퍼는 데이터 모델과 QBarSeries 간의 연결을 생성하는 데 사용됩니다. 데이터 모델을 구현하고 이를 QML에 노출해야 합니다.
데이터를 조작하는 데 모델 및 막대 시리즈 속성을 모두 사용할 수 있습니다. 모델 매퍼는 막대 시리즈와 데이터 모델이 서로 동기화되도록 유지합니다.
모델 매퍼는 막대 시리즈 내의 모든 막대 세트가 동일한 크기를 갖도록 보장합니다. 따라서 막대 세트에 값을 추가하거나 제거하면 막대 시리즈의 모든 막대 세트에 동일한 변경 사항이 적용됩니다.
다음 QML 코드 예제는 세 개의 막대 세트로 구성된 막대 시리즈를 생성합니다(모델에 최소 네 개의 열이 있다고 가정). 각 막대 세트는 1행부터 시작하는 데이터를 포함합니다. 막대 세트의 이름은 열 머리글로 정의됩니다.
BarSeries {
BarModelMapper {
model: myCustomModel // QAbstractItemModel derived implementation
firstBarSetColumn: 1
lastBarSetColumn: 3
firstRow: 1
orientation: Qt.Vertical
}
}속성 문서
count : qsizetype
막대형 차트의 데이터로 매핑되는 모델의 행 또는 열 수입니다. 기본값은 -1 이며, 이는 최소값이기도 합니다. 개수는 모델의 행/열 수에 의해 제한됩니다.
orientation도 참조하십시오 .
first : qsizetype
막대 시리즈에서 막대 집합의 첫 번째 값이 포함된 모델의 행 또는 열입니다. 기본값은 0입니다.
orientation도 참조하십시오 .
firstBarSetSection : qsizetype
첫 번째 막대 세트의 데이터 소스로 사용되는 모델의 섹션입니다. 기본값은 -1(유효하지 않은 매핑)입니다.
orientation도 참조하십시오 .
lastBarSetSection : qsizetype
마지막 막대 집합의 데이터 소스로 사용되는 모델의 섹션입니다. 기본값은 -1(유효하지 않은 매핑)입니다.
orientation도 참조하십시오 .
model : model
매퍼에서 사용하는 데이터 모델입니다. 이 모델을 구현하고 QML에서 사용할 수 있도록 노출해야 합니다.
참고: 이 모델은 행이나 열을 추가 및 제거하고, 셀 내의 데이터를 수정하는 기능을 지원해야 합니다.
orientation : orientation
모델맵퍼에 모델의 데이터를 매핑하는 방법을 지정합니다. ‘ Qt.Vertical ’을 사용할 경우, 모델의 각 열이 막대 세트를 정의하고, 모델의 각 행이 범주를 정의합니다. 방향이 ‘ Qt.Horizontal ’로 설정되면, 모델의 각 행이 막대 세트를 정의하고, 모델의 각 열이 범주를 정의합니다.
series : BarSeries
매퍼에서 사용하는 막대 차트 시리즈입니다. 이 시리즈가 매퍼에 설정되면 시리즈 내의 모든 데이터는 삭제됩니다. 새로운 시리즈가 지정되면 기존 시리즈와의 연결은 끊어지지만, 데이터는 그대로 유지됩니다.
Signal 문서
countChanged()
이 신호는 행이나 열의 개수가 변경될 때 발생합니다.
참고: 해당 핸들러는 onCountChanged 입니다.
firstBarSetSectionChanged()
이 신호는 첫 번째 막대 세션이 변경될 때 발생합니다.
참고: 해당 핸들러는 onFirstBarSetSectionChanged 입니다.
firstChanged()
이 신호는 첫 번째 행이나 열이 변경될 때 발생합니다.
참고: 해당 핸들러는 onFirstChanged 입니다.
lastBarSetSectionChanged()
이 신호는 마지막 막대 설정 구간이 변경될 때 발생합니다.
참고: 해당 핸들러는 onLastBarSetSectionChanged 입니다.
modelChanged()
이 신호는 매퍼가 연결된 모델이 변경될 때 발생합니다.
참고: 이에 해당하는핸들러는 onModelChanged 입니다.
orientationChanged()
이 신호는 방향이 변경될 때 발생합니다.
참고: 해당 핸들러는 onOrientationChanged 입니다.
orientationChanged()
이 신호는 방향이 변경될 때 발생합니다.
참고: 해당 핸들러는 onOrientationChanged 입니다.
seriesChanged()
이 신호는 매퍼가 연결된 막대 차트 시리즈가 변경될 때 발생합니다.
참고: 해당 핸들러는 onSeriesChanged 입니다.
© 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.