BarModelMapper QML Type

바 시리즈용 모델 매퍼. 더 보기...

Import Statement:	`import QtGraphs`
In C++:	QBarModelMapper

상속된 멤버를 포함한 모든 멤버 목록
BarModelMapper는 Qt Graphs 2D용 QML 유형에 포함되어 있습니다.

속성

count : qsizetype
first : qsizetype
firstBarSetSection : qsizetype
lastBarSetSection : qsizetype
model : model
orientation : orientation
series : BarSeries

신호

상세 설명

BarModelMapper 유형을 사용하면 QAbstractItemModel 클래스에서 파생된 데이터 모델을 그래프의 데이터 소스로 사용할 수 있습니다. 모델 매퍼는 데이터 모델과 QBarSeries 사이의 연결을 만드는 데 사용됩니다. 데이터 모델을 구현하고 이를 QML에 노출해야 합니다.

모델 및 막대 시리즈 속성 모두 데이터를 조작하는 데 사용할 수 있습니다. 모델 매퍼는 막대 시리즈와 데이터 모델을 동기화 상태로 유지합니다.

모델 매퍼는 막대 시리즈의 모든 막대 집합이 동일한 크기를 갖도록 합니다. 따라서 막대 세트에서 값을 추가하거나 제거하면 막대 시리즈의 모든 막대 세트에서 동일한 변경이 이루어집니다.

다음 QML 코드 조각은 세 개의 막대 세트가 있는 막대 시리즈를 만듭니다(모델에 열이 4개 이상 있다고 가정). 각 막대 세트에는 행 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

매퍼에서 사용하는 막대 시리즈입니다. 시리즈가 매퍼로 설정되면 시리즈의 모든 데이터가 삭제됩니다. 새 시리즈가 지정되면 이전 시리즈의 연결은 끊어지지만 해당 데이터는 보존됩니다.

신호 문서

countChanged()

이 신호는 행 또는 열의 수가 변경될 때 발생합니다.

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

firstBarSetSectionChanged()

이 신호는 첫 번째 막대 세트 섹션이 변경될 때 발생합니다.

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

firstChanged()

이 신호는 첫 번째 행 또는 열이 변경될 때 발생합니다.

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

lastBarSetSectionChanged()

이 신호는 마지막 막대 세트 섹션이 변경될 때 발생합니다.

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

modelChanged()

이 신호는 매퍼가 연결된 모델이 변경될 때 발생합니다.

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

orientationChanged()

이 신호는 방향이 변경될 때 발생합니다.

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

orientationChanged()

이 신호는 방향이 변경될 때 발생합니다.

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

seriesChanged()

이 신호는 매퍼가 연결된 바 시리즈가 변경될 때 발생합니다.

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

© 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.