BoxPlotSeries QML Type
데이터를 박스형 및 수염형 차트로 표시합니다. 더 보기...
| Import Statement: | import QtCharts 2.11 |
| In C++: | QBoxPlotSeries |
| Inherits: |
속성
- axisX : AbstractAxis
- axisXTop : AbstractAxis
- axisY : AbstractAxis
- axisYRight : AbstractAxis
- boxOutlineVisible : bool
- boxWidth : real
- brushFilename : string
- count : int
신호
- boxsetsAdded(list sets)
- boxsetsRemoved(list sets)
- clicked(BoxSet boxset)
- doubleClicked(BoxSet boxset)
- hovered(bool status, BoxSet boxset)
- pressed(BoxSet boxset)
- released(BoxSet boxset)
방법
- void append(BoxSet box)
- void append(string label, VariantList values)
- BoxSet at(int index)
- void clear()
- void insert(int index, string label, VariantList values)
- void remove(QBoxSet boxset)
상세 설명
박스 플롯 계열은 박스형 및 수염형 항목을 담는 컨테이너 역할을 합니다. 여러 계열의 항목은 인덱스 값에 따라 카테고리로 그룹화됩니다.
BarCategoryAxis 클래스는 차트 축에 카테고리를 추가하는 데 사용됩니다. 카테고리 레이블은 고유해야 합니다. 여러 상자형 및 수염형 항목에 대해 동일한 카테고리 레이블이 정의된 경우 첫 번째 레이블만 그려집니다.
다음 QML 코드 스니펫은 간단한 박스형 수염 차트를 만드는 방법을 보여줍니다:
import QtQuick 2.0 import QtCharts 2.0 ChartView { title: "Box Plot series" width: 400 height: 300 theme: ChartView.ChartThemeBrownSand legend.alignment: Qt.AlignBottom BoxPlotSeries { id: plotSeries name: "Income" BoxSet { label: "Jan"; values: [3, 4, 5.1, 6.2, 8.5] } BoxSet { label: "Feb"; values: [5, 6, 7.5, 8.6, 11.8] } BoxSet { label: "Mar"; values: [3.2, 5, 5.7, 8, 9.2] } BoxSet { label: "Apr"; values: [3.8, 5, 6.4, 7, 8] } BoxSet { label: "May"; values: [4, 5, 5.2, 6, 7] } } }

BoxSet 및 BarCategoryAxis 을참조하세요 .
속성 문서
axisX : AbstractAxis
시리즈에 사용되는 x축입니다. 축X와 axisXTop 모두 정의되지 않은 상태로 두면 계열에 대해 BarCategoryAxis 이 생성됩니다.
axisXTop 를참조하세요 .
axisXTop : AbstractAxis
차트 뷰 위에 그려지는 시리즈에 사용되는 X축입니다.
참고: axisX 또는 axisXTop 중 하나만 제공할 수 있으며 둘 다 제공할 수는 없습니다.
axisX 를참조하세요 .
axisY : AbstractAxis
시리즈에 사용되는 Y축입니다. Y축과 axisYRight 축을 모두 정의하지 않은 상태로 두면 계열에 대해 ValueAxis 이 생성됩니다.
axisYRight 를참조하세요 .
axisYRight : AbstractAxis
차트 보기에서 오른쪽에 그려지는 시리즈에 사용되는 Y축입니다.
참고: axisY 또는 axisYRight 중 하나만 제공할 수 있으며 둘 다 제공할 수는 없습니다.
axisY 를참조하세요 .
boxOutlineVisible : bool
상자 윤곽선의 가시성입니다.
boxWidth : real
상자 및 수염 항목의 너비입니다. 이 값은 해당 카테고리 내에서 항목의 상대적인 너비를 나타냅니다. 값은 0.0에서 1.0 사이일 수 있습니다. 음수 값은 0.0으로 대체되고 1.0보다 큰 값은 1.0으로 대체됩니다.
brushFilename : string
시리즈의 브러시로 사용되는 파일의 이름입니다.
count : int [read-only]
박스 플롯 계열의 박스 및 수염 항목 수입니다.
신호 문서
boxsetsAdded(list sets)
이 신호는 sets 에 지정된 상자 및 수염 항목이 시리즈에 추가될 때 발생합니다.
해당 신호 핸들러는 onBoxsetsAdded() 입니다.
참고: 해당 핸들러는 onBoxsetsAdded 입니다.
boxsetsRemoved(list sets)
이 신호는 sets 에서 지정한 상자 및 수염 항목이 시리즈에서 제거될 때 발생합니다.
해당 신호 핸들러는 onBoxsetsRemoved() 입니다.
참고: 해당 핸들러는 onBoxsetsRemoved 입니다.
clicked(BoxSet boxset)
이 신호는 사용자가 차트에서 boxset 에 지정된 상자 및 수염 항목을 클릭할 때 발생합니다.
해당 신호 핸들러는 onClicked() 입니다.
참고: 해당 핸들러는 onClicked 입니다.
doubleClicked(BoxSet boxset)
이 신호는 사용자가 차트에서 boxset 에 지정된 상자 및 수염 항목을 더블클릭할 때 발생합니다.
해당 신호 핸들러는 onDoubleClicked() 입니다.
참고: 해당 핸들러는 onDoubleClicked 입니다.
hovered(bool status, BoxSet boxset)
이 신호는 차트에서 boxset 으로 지정된 상자 및 수염 항목 위로 마우스를 가져가면 발생합니다. 마우스가 항목 위로 이동하면 status 이 true 으로 바뀌고, 마우스가 다시 멀어지면 false 으로 바뀝니다.
해당 신호 핸들러는 onHovered() 입니다.
참고: 해당 핸들러는 onHovered 입니다.
pressed(BoxSet boxset)
이 신호는 사용자가 차트에서 boxset 을 누르면 발산됩니다.
해당 신호 핸들러는 onPressed 입니다.
참고: 해당 핸들러는 onPressed 입니다.
released(BoxSet boxset)
이 신호는 사용자가 차트에서 boxset 에 지정된 상자 및 수염 항목을 마우스로 누른 상태에서 손을 떼면 발생합니다.
해당 신호 핸들러는 onReleased() 입니다.
참고: 해당 핸들러는 onReleased 입니다.
메서드 문서
void append(BoxSet box)
box 에서 지정한 상자 및 수염 항목을 시리즈에 추가합니다.
void append(string label, VariantList values)
label 에 지정된 레이블과 values 에 지정된 값을 가진 새 상자 및 수염 항목을 시리즈에 추가합니다.
BoxSet at(int index)
index 에 지정된 위치에 상자 및 수염 항목을 반환합니다.
void clear()
시리즈에서 모든 상자 및 수염 항목을 제거하고 영구적으로 삭제합니다.
void insert(int index, string label, VariantList values)
label 에 지정된 레이블과 values 에 지정된 값을 가진 새 상자 및 수염 항목을 index 에 지정된 위치의 계열에 삽입합니다.
void remove(QBoxSet boxset)
boxset 으로 지정된 상자 및 수염 항목을 시리즈에서 제거합니다.
© 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.