Back to Qt.io
Contact Us Blog Download Qt

BoxPlotSeries QML Type

데이터를 박스형 및 수염형 차트로 표시합니다. 더 보기...

Import Statement: import QtCharts 2.8
In C++: QBoxPlotSeries
Inherits:

AbstractSeries

속성

신호

방법

  • append(BoxSet box)
  • append(string label, VariantList values)
  • at(int index)
  • clear()
  • insert(int index, string label, VariantList values)
  • 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 및 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 입니다.


메서드 문서

append(BoxSet box)

box 에 지정된 상자 및 수염 항목을 계열에 추가합니다.


append(string label, VariantList values)

label 에 지정된 레이블과 values 에 지정된 값을 가진 새 상자 수염 항목을 계열에 추가합니다.


at(int index)

index 에 지정된 위치에 상자 및 수염 항목을 반환합니다.


clear()

계열에서 모든 상자 수염 항목을 제거하고 영구적으로 삭제합니다.


insert(int index, string label, VariantList values)

label 에 지정된 레이블과 values 에 지정된 값을 가진 새 상자 수염 항목을 index 에 지정된 위치의 계열에 삽입합니다.


remove(QBoxSet boxset)

boxset 으로 지정한 상자 및 수염 항목을 계열에서 제거합니다.


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