이 페이지에서

BoxPlotSeries QML Type

데이터를 박스-위스커 차트로 표시합니다. 더 보기...

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

AbstractSeries

Status: Deprecated

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

속성

신호

방법

  • 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] }
    }
}

1월부터 5월까지 5개월간의 소득을 나타내는 박스 플롯 차트가 표시된 스크린샷


BoxSet 및 BarCategoryAxis도 참조하십시오 .

속성 문서

axisX : AbstractAxis

시리즈에 사용되는 x축입니다. axisX와 axisXTop 를 모두 정의하지 않으면, 해당 시리즈에 대해 BarCategoryAxis가 생성됩니다.

axisXTop항목도 참조하십시오 .

axisXTop : AbstractAxis

차트 뷰 위에 그려진 해당 시리즈에 사용되는 x축입니다.

참고: axisX 와 axisXTop 중 하나만 지정할수 있으며 , 둘 다 지정할 수는 없습니다.

axisX항목도 참조하십시오 .

axisY : AbstractAxis

시리즈에 사용되는 y축입니다. axisY와 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]

박스 플롯 시리즈에 포함된 박스-수염도 항목의 수.

Signal 문서

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.