이 페이지에서

HBoxPlotModelMapper QML Type

박스 플롯 시퀀스용 수평형 모델 매퍼. 더 보기...

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

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

속성

상세 설명

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

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

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

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

BoxPlotSeries {
    HBoxPlotModelMapper {
        model: myCustomModel // QAbstractItemModel derived implementation
        firstBoxSetRow: 1
        lastBoxSetRow: 3
        firstColumn: 1
    }
}

VBoxPlotModelMapper도 참조하십시오 .

속성 문서

columnCount : int

박스 플롯 시리즈의 데이터로 매핑되는 모델의 열 수입니다. 최소값이자 기본값은 -1이며, 값은 모델의 열 수로 제한됩니다.

firstBoxSetRow : int

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

firstColumn : int

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

lastBoxSetRow : int

모델의 행은 마지막 박스-위스커 항목의 데이터 소스로 사용됩니다. 기본값은 -1(유효하지 않은 매핑)입니다.

model : SomeModel

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

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

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.