이 페이지에서

VBoxPlotModelMapper QML Type

박스 플롯 시계열용 수직 모델 매퍼. 더 보기...

Import Statement: import QtCharts 2.12
In C++: QVBoxPlotModelMapper
Status: Deprecated

이 유형은 더 이상 권장되지 않습니다. 새로운 코드에서는 이 유형을 사용하지 않는 것을 강력히 권장합니다.

속성

상세 설명

VBoxPlotModelMapper 유형을 사용하면 QAbstractItemModel 클래스에서 파생된 데이터 모델을 차트의 데이터 소스로 활용할 수 있습니다. 수직 모델 매퍼는 데이터 모델과 ` BoxPlotSeries ` 유형 간의 연결을 생성하는 데 사용되며, 이를 통해 데이터 모델의 각 열은 박스 앤 위스커 항목을 정의하고, 각 행은 해당 박스 앤 위스커 항목의 범위 및 세 가지 중앙값에 매핑됩니다.

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

모델 매퍼는 박스 플롯 시리즈 내의 모든 막대형 박스-위스커 항목이 동일한 크기를 갖도록 보장합니다. 따라서 박스-위스커 항목에서 값을 추가하거나 제거하면 박스 플롯 시리즈의 모든 박스-위스커 항목에 동일한 변경 사항이 적용됩니다.

다음 QML 코드 스니펫은 세 개의 박스-위스커 항목을 가진 박스 플롯 시리즈를 생성합니다(모델에 최소 4개의 열이 있다고 가정). 각 박스-위스커 항목은 1행부터 시작하는 데이터를 포함합니다. 항목의 이름은 열 헤더로 정의됩니다.

BoxPlotSeries {
    VBoxPlotModelMapper {
        model: myCustomModel // QAbstractItemModel derived implementation
        firstBoxSetColumn: 1
        lastBoxSetColumn: 3
        firstRow: 1
    }
}

HBoxPlotModelMapper도 참조하십시오 .

속성 문서

firstBoxSetColumn : int

첫 번째 박스-위스커 항목의 데이터 소스로 사용되는 모델의 열입니다. 기본값은 -1(유효하지 않은 매핑)입니다.

firstRow : int

박스 플롯 시리즈에서 박스-위스커 항목의 첫 번째 값이 포함된 모델의 행입니다.

기본값은 0입니다.

lastBoxSetColumn : int

마지막 박스-수염도 항목의 데이터 소스로 사용되는 모델의 열입니다. 기본값은 -1(유효하지 않은 매핑)입니다.

model : SomeModel

매퍼에서 사용하는 데이터 모델입니다. 이 모델을 구현하고 QML에 노출시켜야 합니다.

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

rowCount : int

박스 플롯 시리즈의 데이터로 매핑되는 모델의 행 수입니다.

기본값은 -1입니다(모델의 열 수로 제한됨).

series : AbstractBarSeries

매퍼에서 사용하는 박스 플롯 시리즈입니다.

이 시리즈가 매퍼에 설정되면 시리즈의 모든 데이터는 삭제됩니다. 새로운 시리즈가 지정되면 기존 시리즈는 연결이 해제되지만(데이터는 그대로 유지됩니다).

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