QAbstractBarSeries Class
QAbstractBarSeries 클래스는 모든 막대형 시리즈 클래스의 추상 상위 클래스입니다. 더 보기...
| Header: | #include <QAbstractBarSeries> |
| In QML: | AbstractBarSeries |
| Inherits: | QAbstractSeries |
| Inherited By: | QBarSeries, QHorizontalBarSeries, QHorizontalPercentBarSeries, QHorizontalStackedBarSeries, QPercentBarSeries, and QStackedBarSeries |
| Status: | Deprecated |
이 클래스는 더 이상 사용되지 않습니다. 새로운 코드에서는 이 클래스를 사용하지 않도록 강력히 권장합니다.
공개 유형
| enum | LabelsPosition { LabelsCenter, LabelsInsideEnd, LabelsInsideBase, LabelsOutsideEnd } |
속성
|
|
공개 함수
| virtual | ~QAbstractBarSeries() |
| bool | append(QBarSet *set) |
| bool | append(const QList<QBarSet *> &sets) |
| QList<QBarSet *> | barSets() const |
| qreal | barWidth() const |
| void | clear() |
| int | count() const |
| bool | insert(int index, QBarSet *set) |
| bool | isLabelsVisible() const |
| qreal | labelsAngle() const |
| QString | labelsFormat() const |
| QAbstractBarSeries::LabelsPosition | labelsPosition() const |
| int | labelsPrecision() const |
| bool | remove(QBarSet *set) |
| void | setBarWidth(qreal width) |
| void | setLabelsAngle(qreal angle) |
| void | setLabelsFormat(const QString &format) |
| void | setLabelsPosition(QAbstractBarSeries::LabelsPosition position) |
| void | setLabelsPrecision(int precision) |
| void | setLabelsVisible(bool visible = true) |
| bool | take(QBarSet *set) |
신호
| void | barsetsAdded(const QList<QBarSet *> &sets) |
| void | barsetsRemoved(const QList<QBarSet *> &sets) |
| void | clicked(int index, QBarSet *barset) |
| void | countChanged() |
| void | doubleClicked(int index, QBarSet *barset) |
| void | hovered(bool status, int index, QBarSet *barset) |
| void | labelsAngleChanged(qreal angle) |
| void | labelsFormatChanged(const QString &format) |
| void | labelsPositionChanged(QAbstractBarSeries::LabelsPosition position) |
| void | labelsPrecisionChanged(int precision) |
| void | labelsVisibleChanged() |
| void | pressed(int index, QBarSet *barset) |
| void | released(int index, QBarSet *barset) |
상세 설명
막대 차트에서 막대는 각 범주마다 하나의 데이터 값을 포함하는 막대 집합으로 정의됩니다. 막대의 위치는 범주에 의해 지정되며, 높이는 데이터 값에 의해 결정됩니다. 여러 막대 집합을 포함하는 막대 시계열은 동일한 범주에 속하는 막대들을 그룹으로 묶습니다. 막대의 표시 방식은 막대 차트를 생성할 때 선택된 이 클래스의 하위 클래스에 따라 결정됩니다.
주 막대 축에 ` QBarCategoryAxis ` 대신 ` QValueAxis `을 사용하는 경우, 막대는 범주의 인덱스 값을 기준으로 그룹화됩니다.
QBarSeries 클래스를 사용하여 간단한 막대 차트를 만드는 방법은 ‘위젯이 포함된 차트 갤러리’를 참조하십시오.

QBarSet, QBarSeries, QStackedBarSeries, QPercentBarSeries, QHorizontalBarSeries, QHorizontalStackedBarSeries 및 QHorizontalPercentBarSeries도 참조하십시오 .
멤버 유형 문서
enum QAbstractBarSeries::LabelsPosition
이 열거형 값은 데이터 값 레이블의 위치를 나타냅니다:
| 상수 | 값 | 설명 |
|---|---|---|
QAbstractBarSeries::LabelsCenter | 0 | 라벨이 막대의 중앙에 위치합니다. |
QAbstractBarSeries::LabelsInsideEnd | 1 | 라벨이 막대 상단 내부에 위치합니다. |
QAbstractBarSeries::LabelsInsideBase | 2 | 라벨이 막대 안쪽 하단에 위치합니다. |
QAbstractBarSeries::LabelsOutsideEnd | 3 | 라벨은 막대 상단 바깥쪽에 위치합니다. |
속성 문서
barWidth : qreal
이 속성은 시리즈의 막대 폭을 지정합니다.
너비의 단위는 x축의 단위와 동일합니다. 막대의 최소 너비는 0이며, 음수 값은 0으로 처리됩니다. 너비를 0으로 설정하면 x축의 스케일에 관계없이 화면상의 막대 너비가 1픽셀이 됩니다. 0보다 넓은 막대는 x축 스케일을 사용하여 크기가 조정됩니다.
참고: QBarSeries와 함께 사용할경우 , 이 값은 개별 막대의 너비가 아닌 막대 그룹의 너비를 지정합니다.
액세스 함수:
| qreal | barWidth() const |
| void | setBarWidth(qreal width) |
QBarSeries도 참조하십시오 .
[read-only] count : int
이 속성은 막대 차트 시리즈에 포함된 막대 세트의 개수를 나타냅니다.
액세스 함수:
| int | count() const |
알림 신호:
| void | countChanged() |
labelsAngle : qreal
이 속성은 값 레이블의 각도를 도 단위로 저장합니다.
액세스 함수:
| qreal | labelsAngle() const |
| void | setLabelsAngle(qreal angle) |
알림 신호:
| void | labelsAngleChanged(qreal angle) |
labelsFormat : QString
이 속성은 막대 시리즈에서 레이블을 표시하는 데 사용되는 형식을 지정합니다.
QAbstractBarSeries 다음 형식 태그를 지원합니다:
| @value | 막대의 값 |
예를 들어, 다음처럼 형식 태그를 사용하면 값 뒤에 단위(u)가 표시된 레이블이 생성됩니다:
series->setLabelsFormat("@value u");기본적으로 레이블에는 막대의 값이 표시됩니다. 백분율 막대 차트의 경우 값 뒤에 %가 추가됩니다. 레이블은 플롯 영역에 표시되며, 막대들이 서로 가까이 있을 경우 레이블이 겹칠 수 있습니다.
액세스 함수:
| QString | labelsFormat() const |
| void | setLabelsFormat(const QString &format) |
알림 신호:
| void | labelsFormatChanged(const QString &format) |
labelsVisible, labelsPosition 및 labelsPrecision도 참조하십시오 .
labelsPosition : LabelsPosition
이 속성은 값 레이블의 위치를 지정합니다.
액세스 함수:
| QAbstractBarSeries::LabelsPosition | labelsPosition() const |
| void | setLabelsPosition(QAbstractBarSeries::LabelsPosition position) |
알림 신호:
| void | labelsPositionChanged(QAbstractBarSeries::LabelsPosition position) |
labelsVisible 및 labelsFormat도 참조하십시오 .
labelsPrecision : int
이 속성은 값 레이블에 표시되는 유의 자릿수의 최대 개수를 지정합니다.
기본값은 6입니다.
액세스 함수:
| int | labelsPrecision() const |
| void | setLabelsPrecision(int precision) |
알림 신호:
| void | labelsPrecisionChanged(int precision) |
labelsVisible : bool
이 속성은 막대형 시리즈에서 레이블의 표시 여부를 결정합니다.
액세스 함수:
| bool | isLabelsVisible() const |
| void | setLabelsVisible(bool visible = true) |
알림 신호:
| void | labelsVisibleChanged() |
멤버 함수 설명서
[virtual noexcept] QAbstractBarSeries::~QAbstractBarSeries()
추상 막대 차트 시리즈와 해당 시리즈가 소유한 막대 집합을 제거합니다.
bool QAbstractBarSeries::append(QBarSet *set)
set 로 지정된 막대 집합을 막대 시리즈에 추가하고 해당 집합의 소유권을 인수합니다. 집합이 null이거나 이미 해당 시리즈에 속해 있는 경우, 추가되지 않습니다. 추가에 성공하면 true 를 반환합니다.
bool QAbstractBarSeries::append(const QList<QBarSet *> &sets)
sets 로 지정된 막대 세트 목록을 막대 시계에 추가하고 해당 세트의 소유권을 인수합니다. 모든 세트가 성공적으로 추가된 경우 ` true `를 반환합니다. 세트 중 하나라도 `null`이거나 이전에 해당 시리즈에 추가된 적이 있는 경우, 아무것도 추가되지 않고 이 함수는 ` false`를 반환합니다. 세트 중 하나라도 목록에 두 번 이상 나타나는 경우, 아무것도 추가되지 않고 이 함수는 ` false`를 반환합니다.
QList<QBarSet *> QAbstractBarSeries::barSets() const
막대 시리즈에 포함된 막대 세트 목록을 반환합니다. 막대 세트의 소유권은 유지됩니다.
qreal QAbstractBarSeries::barWidth() const
시리즈의 막대 너비를 반환합니다.
참고: barWidth 속성에 대한게터 함수입니다.
참조: setBarWidth().
[signal] void QAbstractBarSeries::barsetsAdded(const QList<QBarSet *> &sets)
이 신호는 sets 에서 지정한 막대가 시계에 추가될 때 발생합니다.
append() 및 insert()항목도 참조하십시오 .
[signal] void QAbstractBarSeries::barsetsRemoved(const QList<QBarSet *> &sets)
sets 에서 지정한 막대가 시계열에서 제거되면 이 신호가 발생합니다.
remove()도 참조하십시오 .
void QAbstractBarSeries::clear()
시리즈에서 모든 바 세트를 제거하고 영구적으로 삭제합니다.
[signal] void QAbstractBarSeries::clicked(int index, QBarSet *barset)
이 신호는 사용자가 barset 로 지정된 막대 세트에서 index 로 지정된 막대를 클릭할 때 발생합니다.
int QAbstractBarSeries::count() const
바 시리즈에 포함된 바 세트의 개수를 반환합니다.
참고: count 속성에 대한게터 함수입니다.
[signal] void QAbstractBarSeries::countChanged()
이 신호는 append()이나 remove()과 같이 막대 세트의 개수가 변경될 때 발생합니다.
참고: count 속성에 대한알림 신호입니다.
[signal] void QAbstractBarSeries::doubleClicked(int index, QBarSet *barset)
이 신호는 사용자가 barset 로 지정된 막대 세트 내에서 index 로 지정된 막대를 더블 클릭할 때 발생합니다.
[signal] void QAbstractBarSeries::hovered(bool status, int index, QBarSet *barset)
이 신호는 barset 로 지정된 막대 세트 내의 index 로 지정된 막대 위에 마우스를 올렸을 때 발생합니다. 마우스가 해당 막대 위로 이동하면 status 가 true 로 변하고, 마우스가 다시 그 막대에서 멀어지면 false 로 변합니다.
bool QAbstractBarSeries::insert(int index, QBarSet *set)
set 로 지정된 막대 세트를 index 로 지정된 위치에 시리즈에 삽입하고, 해당 세트의 소유권을 가져옵니다. 세트가 null이거나 이미 해당 시리즈에 속해 있는 경우, 세트는 추가되지 않습니다. 삽입에 성공하면 true 를 반환합니다.
bool QAbstractBarSeries::isLabelsVisible() const
레이블의 표시 여부를 반환합니다.
참고: labelsVisible 속성에 대한게터 함수입니다.
[signal] void QAbstractBarSeries::labelsAngleChanged(qreal angle)
이 신호는 값 레이블의 angle 속성이 변경될 때 발생합니다.
참고: 속성 labelsAngle 에 대한알림 신호입니다.
[signal] void QAbstractBarSeries::labelsFormatChanged(const QString &format)
이 신호는 데이터 값 레이블의 ` format ` 속성이 변경될 때 발생합니다.
참고: 속성 labelsFormat 에 대한알림 신호입니다.
[signal] void QAbstractBarSeries::labelsPositionChanged(QAbstractBarSeries::LabelsPosition position)
값 레이블의 position 가 변경될 때 이 신호가 발생합니다.
참고: 속성 labelsPosition 에 대한알림 신호입니다.
[signal] void QAbstractBarSeries::labelsPrecisionChanged(int precision)
이 신호는 값 레이블의 precision 속성이 변경될 때 발생합니다.
참고: 속성 labelsPrecision 에 대한알림 신호입니다.
[signal] void QAbstractBarSeries::labelsVisibleChanged()
이 신호는 레이블의 표시 상태가 변경될 때 발생합니다.
참고: 속성 ` labelsVisible`에 대한알림 신호입니다.
isLabelsVisible() 및 setLabelsVisible()도 참조하십시오 .
[signal] void QAbstractBarSeries::pressed(int index, QBarSet *barset)
이 신호는 사용자가 barset 로 지정된 막대 세트 중 index 로 지정된 막대를 클릭한 후 마우스 버튼을 누르고 있을 때 발생합니다.
[signal] void QAbstractBarSeries::released(int index, QBarSet *barset)
이 신호는 사용자가 barset 로 지정된 바 세트 내의 index 로 지정된 바에서 마우스 버튼을 놓을 때 발생합니다.
bool QAbstractBarSeries::remove(QBarSet *set)
set 로 지정된 막대 집합을 시리즈에서 제거하고, 제거에 성공하면 해당 집합을 영구적으로 삭제합니다. 집합이 제거된 경우 true 를 반환합니다.
void QAbstractBarSeries::setBarWidth(qreal width)
시리즈 막대의 너비를 ` width`로 설정합니다.
참고: barWidth 속성에 대한세터 함수입니다.
barWidth()도 참조하십시오 .
void QAbstractBarSeries::setLabelsVisible(bool visible = true)
막대형 시리즈에서 레이블의 표시 여부를 ‘ visible ’로 설정합니다.
참고: labelsVisible 속성에 대한세터 함수입니다.
isLabelsVisible()도 참조하십시오 .
bool QAbstractBarSeries::take(QBarSet *set)
시리즈에서 단일 막대 세트( set )를 가져옵니다. 막대 세트 객체는 삭제하지 않습니다.
참고: 시리즈는 바 세트의 상위 객체로 유지됩니다. 완전한 소유권을 확보하려면 상위 객체를 설정해야 합니다.
테이크 작업이 성공하면 true 를 반환합니다.
© 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.