Back to Qt.io
Contact Us Blog Download Qt

PieModelMapper QML Type

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

Import Statement: import QtGraphs
In C++: QPieModelMapper

속성

신호

상세 설명

모델 매퍼를 사용하면 QAbstractItemModel 클래스에서 파생된 데이터 모델을 그래프의 데이터 소스로 사용할 수 있습니다. 모델 매퍼는 데이터 모델과 PieSeries 사이의 연결을 만드는 데 사용됩니다.

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

다음 QML 예에서는 4개의 슬라이스로 파이 계열을 만듭니다(모델에 행이 5개 이상 있다고 가정). 각 슬라이스는 열 1에서 레이블을, 열 2에서 값을 가져옵니다.

PieModelMapper {
    series: pieSeries
    model: customModel
    labelsSection: 1
    valuesSection: 2
    firstRow: 1
    rowCount: 4
    orientation: Qt.Vertical
}

속성 문서

count : qsizetype

파이 계열의 데이터로 매핑되는 모델의 열 또는 행 수입니다. 기본값은 -1입니다(모델의 행 수에 의해 제한되는 수).

orientation 를참조하세요 .


first : qsizetype

첫 번째 슬라이스 값을 포함하는 모델의 열 또는 행입니다. 기본값은 0입니다.

orientation도 참조하십시오 .


labelsSection : qsizetype

파이 슬라이스의 레이블과 동기화된 상태로 유지되는 모델의 열 또는 행입니다. 기본값은 -1(잘못된 매핑)입니다.

orientation도 참조하세요 .


model : model

매퍼에서 사용하는 QAbstractItemModel 기반 모델입니다. 모델을 구현하여 QML에 노출해야 합니다.

참고: 모델은 행 또는 열 추가 및 제거와 셀의 데이터 수정을 지원해야 합니다.


orientation : orientation

모델매퍼에게 모델에서 데이터를 매핑하는 방법을 알려줍니다. Qt.Vertical 을 사용하는 경우 모델의 각 행은 파이 슬라이스를 정의하고 모델의 열은 파이 슬라이스의 레이블 또는 값을 정의합니다. 방향이 Qt.Horizontal 으로 설정된 경우 모델의 각 열은 파이 슬라이스를 정의하고 모델의 행은 파이 슬라이스의 레이블 또는 값을 정의합니다.

기본값은 다음과 같습니다. Qt.Vertical


series : PieSeries

매퍼에서 사용하는 파이 계열입니다. 매퍼 요소를 PieSeries 의 하위 요소로 정의하는 경우 이 속성을 정의하지 않은 상태로 둡니다. 시리즈가 매퍼로 설정되면 시리즈의 모든 데이터가 삭제됩니다. 새 시리즈를 지정하면 이전 시리즈의 연결이 끊어지지만 해당 데이터는 보존됩니다.


valuesSection : qsizetype

파이의 슬라이스 값과 동기화된 상태로 유지되는 모델의 열 또는 행입니다. 기본값은 -1(잘못된 매핑)입니다.

orientation 를참조하세요 .


신호 문서

countChanged()

이 신호는 카운트가 변경될 때 발생합니다.

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


firstChanged()

이 신호는 첫 번째 슬라이스가 변경될 때 발생합니다.

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


labelsSectionChanged()

이 신호는 레이블 섹션이 변경될 때 발생합니다.

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


modelChanged()

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

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


orientationChanged()

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

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


seriesChanged()

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

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


valuesSectionChanged()

이 신호는 값 섹션이 변경될 때 발생합니다.

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


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