QBoxPlotSeries Class
QBoxPlotSeries 클래스는 박스-위스커 차트로 데이터를 표시합니다. 더 보기...
| Header: | #include <QBoxPlotSeries> |
| In QML: | BoxPlotSeries |
| Inherits: | QAbstractSeries |
| Status: | Deprecated |
이 클래스는 더 이상 권장되지 않습니다. 새로운 코드에서는 이 클래스를 사용하지 않는 것을 강력히 권장합니다.
속성
|
공개 함수
| QBoxPlotSeries(QObject *parent = nullptr) | |
| virtual | ~QBoxPlotSeries() |
| bool | append(QBoxSet *set) |
| bool | append(const QList<QBoxSet *> &sets) |
| bool | boxOutlineVisible() |
| QList<QBoxSet *> | boxSets() const |
| qreal | boxWidth() |
| QBrush | brush() const |
| void | clear() |
| int | count() const |
| bool | insert(int index, QBoxSet *set) |
| QPen | pen() const |
| bool | remove(QBoxSet *set) |
| void | setBoxOutlineVisible(bool visible) |
| void | setBoxWidth(qreal width) |
| void | setBrush(const QBrush &brush) |
| void | setPen(const QPen &pen) |
| bool | take(QBoxSet *set) |
재구현된 공용 함수
| virtual QAbstractSeries::SeriesType | type() const override |
신호
| void | boxOutlineVisibilityChanged() |
| void | boxWidthChanged() |
| void | boxsetsAdded(const QList<QBoxSet *> &sets) |
| void | boxsetsRemoved(const QList<QBoxSet *> &sets) |
| void | brushChanged() |
| void | clicked(QBoxSet *boxset) |
| void | countChanged() |
| void | doubleClicked(QBoxSet *boxset) |
| void | hovered(bool status, QBoxSet *boxset) |
| void | penChanged() |
| void | pressed(QBoxSet *boxset) |
| void | released(QBoxSet *boxset) |
상세 설명
박스 플롯 시리는 박스-위스커 항목들을 담는 컨테이너 역할을 합니다. 여러 시리의 항목들은 인덱스 값에 따라 범주로 그룹화됩니다.
QBarCategoryAxis 클래스는 차트의 축에 범주를 추가하는 데 사용됩니다. 범주 레이블은 고유해야 합니다. 여러 박스-위스커 항목에 동일한 범주 레이블이 정의된 경우, 첫 번째 항목만 그려집니다.
박스-위스커 차트를 만드는 방법은 ‘위젯이 포함된 차트 갤러리’를 참조하십시오.

QBoxSet 및 QBarCategoryAxis도 참조하십시오 .
속성 설명서
boxOutlineVisible : bool
이 속성은 상자 윤곽선의 표시 여부를 결정합니다.
액세스 함수:
| bool | boxOutlineVisible() |
| void | setBoxOutlineVisible(bool visible) |
알림 신호:
| void | boxOutlineVisibilityChanged() |
boxWidth : qreal
이 속성은 박스-위스커 항목의 너비를 나타냅니다. 이 값은 해당 항목이 속한 범주 내에서 차지하는 상대적 너비를 나타냅니다. 값의 범위는 0.0에서 1.0 사이입니다. 음수 값은 0.0으로, 1.0보다 큰 값은 1.0으로 대체됩니다.
액세스 함수:
| qreal | boxWidth() |
| void | setBoxWidth(qreal width) |
알림 신호:
| void | boxWidthChanged() |
brush : QBrush
이 속성은 박스-와이커스 항목의 상자를 채우는 데 사용되는 브러시를 저장합니다.
액세스 함수:
| QBrush | brush() const |
| void | setBrush(const QBrush &brush) |
알림 신호:
| void | brushChanged() |
[read-only] count : int
이 속성은 박스 플롯 시리즈에 포함된 박스-위스커 항목의 개수를 나타냅니다.
액세스 함수:
| int | count() const |
알림 신호:
| void | countChanged() |
pen : QPen
이 속성은 박스-위스커 항목의 선을 그리는 데 사용된 펜을 나타냅니다.
액세스 함수:
| QPen | pen() const |
| void | setPen(const QPen &pen) |
알림 신호:
| void | penChanged() |
멤버 함수 문서
[explicit] QBoxPlotSeries::QBoxPlotSeries(QObject *parent = nullptr)
QObject 이며 parent 의 하위 요소인 빈 박스 플롯 시계를 생성합니다.
[virtual noexcept] QBoxPlotSeries::~QBoxPlotSeries()
차트에서 해당 시리즈를 제거합니다.
bool QBoxPlotSeries::append(QBoxSet *set)
set 로 지정된 단일 박스-위스커 항목을 시리즈에 추가하고 해당 항목에 대한 소유권을 가져옵니다. 항목이 null이거나 이미 시리즈에 속해 있는 경우, 추가되지 않습니다. 추가에 성공하면 ` true `를 반환합니다.
bool QBoxPlotSeries::append(const QList<QBoxSet *> &sets)
sets 로 지정된 박스-위스커 항목 목록을 시리에 추가하고 해당 항목에 대한 소유권을 인수합니다. 목록이 null이거나 항목이 이미 시리에 속해 있는 경우, 해당 항목은 추가되지 않습니다. 추가에 성공하면 ` true `를 반환합니다.
[signal] void QBoxPlotSeries::boxOutlineVisibilityChanged()
이 신호는 상자 윤곽선의 표시 여부가 변경될 때 발생합니다.
참고: 속성 ` boxOutlineVisible`에 대한알림 신호입니다.
QList<QBoxSet *> QBoxPlotSeries::boxSets() const
박스 플롯 시리즈에 포함된 박스-수염도표 항목들의 목록을 반환합니다. 항목에 대한 소유권은 유지됩니다.
[signal] void QBoxPlotSeries::boxWidthChanged()
이 신호는 박스-위스커 항목의 너비가 변경될 때 발생합니다.
참고: 속성 boxWidth 에 대한알림 신호입니다.
[signal] void QBoxPlotSeries::boxsetsAdded(const QList<QBoxSet *> &sets)
sets 로 지정된 박스-위스커 항목 목록이 시리즈에 추가되면 이 신호가 발생합니다.
[signal] void QBoxPlotSeries::boxsetsRemoved(const QList<QBoxSet *> &sets)
sets 로 지정된 박스-위스커 항목 목록이 시계열에서 제거되면 이 신호가 발생합니다.
[signal] void QBoxPlotSeries::brushChanged()
박스-위스커 항목의 상자를 채우는 데 사용되는 브러시가 변경되면 이 신호가 발생합니다.
참고: 속성 ` brush`에 대한알림 신호입니다.
void QBoxPlotSeries::clear()
시리즈에서 모든 박스-위스커 항목을 제거하고 영구적으로 삭제합니다.
[signal] void QBoxPlotSeries::clicked(QBoxSet *boxset)
사용자가 차트에서 ` boxset `로 지정된 박스-위스커 항목을 클릭하면 이 신호가 발생합니다.
int QBoxPlotSeries::count() const
박스 플롯 시리즈에 포함된 박스-수염도 항목의 개수를 반환합니다.
참고: count 속성에 대한게터 함수입니다.
[signal] void QBoxPlotSeries::countChanged()
이 신호는 시리즈 내 박스-위스커 항목의 개수가 변경될 때 발생합니다.
참고: 속성 count 에 대한알림 신호입니다.
[signal] void QBoxPlotSeries::doubleClicked(QBoxSet *boxset)
사용자가 차트에서 ` boxset `로 지정된 박스 앤 위스커 항목을 더블클릭하면 이 신호가 발생합니다.
[signal] void QBoxPlotSeries::hovered(bool status, QBoxSet *boxset)
이 신호는 차트에서 ` boxset `로 지정된 박스 앤 위스커 항목 위에 마우스를 올렸을 때 발생합니다. 마우스가 해당 항목 위로 이동하면 ` status `가 ` true`로 바뀌고, 마우스가 다시 해당 항목에서 멀어지면 ` false`로 바뀝니다.
bool QBoxPlotSeries::insert(int index, QBoxSet *set)
set 로 지정된 박스-위스커 항목을 index 로 지정된 위치에 시리즈에 삽입하고, 해당 항목의 소유권을 가져옵니다. 항목이 null이거나 이미 해당 시리즈에 속해 있는 경우, 삽입되지 않습니다. 삽입에 성공하면 true 를 반환합니다.
[signal] void QBoxPlotSeries::penChanged()
박스 앤 위스커 항목의 선을 그리는 데 사용되는 펜이 변경되면 이 신호가 발생합니다.
참고: 속성 ` pen`에 대한알림 신호입니다.
[signal] void QBoxPlotSeries::pressed(QBoxSet *boxset)
사용자가 차트에서 boxset 로 지정된 박스-위스커 항목을 클릭한 후 마우스 버튼을 누르고 있으면 이 신호가 발생합니다.
[signal] void QBoxPlotSeries::released(QBoxSet *boxset)
이 신호는 사용자가 차트에서 ` boxset `로 지정된 박스-위스커 항목에 대한 마우스 클릭을 해제할 때 발생합니다.
bool QBoxPlotSeries::remove(QBoxSet *set)
set 로 지정된 박스-위스커 항목을 시리즈에서 제거하고, 제거에 성공하면 해당 항목을 영구적으로 삭제합니다. 항목이 제거된 경우 true 를 반환합니다.
bool QBoxPlotSeries::take(QBoxSet *set)
시리즈에서 set 로 지정된 박스-위스커 항목을 가져옵니다. 해당 항목은 삭제되지 않습니다.
참고: 시리즈는 해당 항목의 부모 객체로 유지됩니다. 완전한 소유권을 확보하려면 부모 객체를 설정해야 합니다.
take 작업이 성공하면 true 을 반환합니다.
[override virtual] QAbstractSeries::SeriesType QBoxPlotSeries::type() const
QAbstractSeries::type 속성에 대한 액세스 함수를 재구현합니다.
시리즈의 유형을 반환합니다.
QAbstractSeries 및 SeriesType도 참조하십시오 .
© 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.