이 페이지에서

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
    first: 1
    count: 4
    orientation: Qt.Vertical
}

속성 문서

count : qsizetype

파이 시리즈의 데이터로 매핑되는 모델의 열 또는 행 수입니다. 기본값은 -1입니다(모델의 행 수에 따라 제한됨).

orientation도 참조하십시오 .

first : qsizetype

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

orientation도 참조하십시오 .

labelsSection : qsizetype

파이 차트의 각 조각 레이블과 동기화되는 모델의 열 또는 행입니다. 기본값은 -1(잘못된 매핑)입니다.

orientation도 참조하십시오 .

model : model

매퍼에서 사용하는 ` QAbstractItemModel ` 기반 모델입니다. 이 모델을 구현하고 QML에서 사용할 수 있도록 노출해야 합니다.

참고: 이 모델은 행이나 열을 추가 및 제거하고, 셀 내의 데이터를 수정하는 기능을 지원해야 합니다.

orientation : orientation

모델맵퍼에게 모델의 데이터를 어떻게 매핑할지 지시합니다. Qt.Vertical 를 사용하는 경우, 모델의 각 행은 파이 조각을 정의하고, 모델의 각 열은 해당 파이 조각의 레이블 또는 값을 정의합니다. orientation이 Qt.Horizontal 로 설정된 경우, 모델의 각 열은 파이 조각을 정의하고, 모델의 각 행은 해당 파이 조각의 레이블 또는 값을 정의합니다.

기본값은 Qt.Vertical

series : PieSeries

매퍼에서 사용하는 파이 시리즈입니다. 매퍼 요소를 ` PieSeries`의 자식 요소로 정의하는 경우, 이 속성을 정의하지 마십시오. 이 속성이 매퍼로 설정되면 시리즈의 모든 데이터가 삭제됩니다. 새로운 시리즈가 지정되면 기존 시리즈는 연결이 해제되지만(단, 데이터는 유지됩니다).

valuesSection : qsizetype

파이 차트의 각 조각 값과 동기화되는 모델의 열 또는 행입니다. 기본값은 -1(유효하지 않은 매핑)입니다.

orientation도 참조하십시오 .

Signal 문서

countChanged()

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

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

firstChanged()

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

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

labelsSectionChanged()

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

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

modelChanged()

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

참고: 이에 대응하는핸들러는 onModelChanged 입니다.

orientationChanged()

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

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

seriesChanged()

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

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

valuesSectionChanged()

값 섹션이 변경되면 이 신호가 발생합니다.

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

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