QBarSeries Class
QBarSeries 클래스는 데이터를 막대 그래프로 표시합니다. 더 보기...
| Header: | #include <QBarSeries> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Graphs)target_link_libraries(mytarget PRIVATE Qt6::Graphs) |
| qmake: | QT += graphs |
| QML에서: | BarSeries |
| 상속합니다: | QAbstractSeries |
- 상속된 멤버를 포함한 모든 멤버의 목록
- QBarSeries는 Qt Graphs 2D용 C++ 클래스의 일부입니다.
공용 유형
| enum class | BarsType { Groups, Stacked, StackedPercent } |
| enum class | LabelsPosition { Center, InsideEnd, InsideBase, OutsideEnd } |
속성
|
|
공용 함수
| QBarSeries(QObject *parent = nullptr) | |
| bool | append(QBarSet *set) |
| bool | append(const QList<QBarSet *> &sets) |
| QBarSet * | at(qsizetype index) |
| QQmlComponent * | barDelegate() const |
| QList<QBarSet *> | barSets() const |
| qreal | barWidth() const |
| QBarSeries::BarsType | barsType() const |
| QList<QColor> | borderColors() const |
| void | clear() |
| qsizetype | count() const |
| qsizetype | find(QBarSet *set) const |
| bool | insert(qsizetype index, QBarSet *set) |
| qreal | labelsAngle() const |
| QString | labelsFormat() const |
| qreal | labelsMargin() const |
| QBarSeries::LabelsPosition | labelsPosition() const |
| int | labelsPrecision() const |
| bool | labelsVisible() const |
| bool | remove(QBarSet *set) |
| bool | remove(qsizetype index) |
| void | removeMultiple(qsizetype index, qsizetype count) |
| bool | replace(const QList<QBarSet *> &sets) |
| bool | replace(QBarSet *oldValue, QBarSet *newValue) |
| void | replace(qsizetype index, QBarSet *set) |
| QList<QColor> | seriesColors() const |
| void | setBarDelegate(QQmlComponent *newBarDelegate) |
| void | setBarWidth(qreal width) |
| void | setBarsType(QBarSeries::BarsType type) |
| void | setBorderColors(const QList<QColor> &newBorderColors) |
| void | setLabelsAngle(qreal angle) |
| void | setLabelsFormat(const QString &format) |
| void | setLabelsMargin(qreal margin) |
| void | setLabelsPosition(QBarSeries::LabelsPosition position) |
| void | setLabelsPrecision(int precision) |
| void | setLabelsVisible(bool visible = true) |
| void | setSeriesColors(const QList<QColor> &newSeriesColors) |
| bool | take(QBarSet *set) |
재구현된 공용 함수
| virtual QAbstractSeries::SeriesType | type() const override |
신호
| void | barDelegateChanged() |
| void | barSetsChanged() |
| void | barWidthChanged() |
| void | barsTypeChanged(QBarSeries::BarsType type) |
| void | barsetsAdded(const QList<QBarSet *> &sets) |
| void | barsetsRemoved(const QList<QBarSet *> &sets) |
| void | borderColorsChanged() |
| void | countChanged() |
| void | labelsAngleChanged(qreal angle) |
| void | labelsFormatChanged(const QString &format) |
| void | labelsMarginChanged(qreal margin) |
| void | labelsPositionChanged(QBarSeries::LabelsPosition position) |
| void | labelsPrecisionChanged(int precision) |
| void | labelsVisibleChanged(bool visible) |
| void | seriesColorsChanged() |
| void | setValueAdded(qsizetype index, qsizetype count, QBarSet *barset) |
| void | setValueChanged(qsizetype index, QBarSet *barset) |
| void | setValueRemoved(qsizetype index, qsizetype count, QBarSet *barset) |
| void | updatedBars() |
상세 설명
이 클래스는 기본적으로 카테고리별로 그룹화된 일련의 막대로 데이터를 그리며, 각 막대 세트에서 카테고리당 하나의 막대가 시리즈에 추가됩니다. 또한 가로 막대와 그룹화된 막대를 스택으로 지원합니다.
막대 시리즈는 GraphsView x축을 BarCategoryAxis 으로 설정하고 y축을 ValueAxis 으로 설정해야 합니다.
QBarSet 및 QAbstractSeries 을참조하세요 .
멤버 유형 문서
enum class QBarSeries::BarsType
이 열거형 값은 막대 시리즈의 유형을 설명합니다:
| 상수 | 값 | 설명 |
|---|---|---|
QBarSeries::BarsType::Groups | 0 | 막대 세트는 카테고리별로 그룹화됩니다. |
QBarSeries::BarsType::Stacked | 1 | 막대 세트는 카테고리별로 서로 겹쳐 쌓입니다. |
QBarSeries::BarsType::StackedPercent | 2 | 막대 세트는 카테고리별로 서로 겹쳐 쌓입니다. 세그먼트 크기는 스택에 있는 모든 세그먼트의 총 값과 비교한 세그먼트 값의 백분율에 해당합니다. |
enum class QBarSeries::LabelsPosition
이 열거형 값은 데이터 값 레이블의 위치를 설명합니다:
| 상수 | 값 | 설명 |
|---|---|---|
QBarSeries::LabelsPosition::Center | 0 | 레이블은 막대 중앙에 위치합니다. |
QBarSeries::LabelsPosition::InsideEnd | 1 | 레이블은 막대 상단의 막대 내부에 있습니다. |
QBarSeries::LabelsPosition::InsideBase | 2 | 레이블은 하단의 막대 내부에 있습니다. |
QBarSeries::LabelsPosition::OutsideEnd | 3 | 레이블은 상단의 막대 외부에 있습니다. |
속성 문서
barDelegate : QQmlComponent*
이 속성에는 각 막대를 시각화하는 데 사용되는 사용자 지정 QML 컴포넌트가 들어 있습니다. 이 구성 요소의 인스턴스는 각 막대에 대해 생성됩니다. 이 속성을 정의하지 않으면 막대에 대한 기본 직사각형 시각화가 사용됩니다.
이 컴포넌트에 사용할 수 있는 동적 속성은 다음과 같습니다:
| 유형 | 이름 | 설명 |
|---|---|---|
| QColor | 바 색상 | 막대의 채우기 색상입니다. 이 값은 QGraphsTheme 또는 QBarSet 가 색상을 재정의하는 경우 QBarSet::color 에서 가져옵니다. |
| QColor | 바 테두리색 | 바의 테두리 색상입니다. 이 값은 QGraphsTheme 또는 QBarSet 가 색을 재정의하는 경우 QBarSet::borderColor 에서 가져옵니다. |
| qreal | barBorderWidth | 바 테두리의 너비입니다. 이 값은 QGraphsTheme 또는 QBarSet 가 너비를 재정의하는 경우 QBarSet::borderWidth 에서 가져옵니다. |
| qreal | barValue | 바의 값입니다. 이 값은 QBarSet::values 에서 가져옵니다. |
| QString | barLabel | 막대의 레이블입니다. 이 값은 QBarSet::label 에서 가져옵니다. |
| bool | barSelected | 이 값은 바가 선택된 경우, 즉 바 인덱스가 QBarSet::selectedBars 에 있을 때 참입니다. |
이 중 하나를 사용하려면 정의된 이름의 속성을 사용자 정의 컴포넌트에 추가하세요. 예: "property color barColor" 및 "property real barValue".
함수에 액세스합니다:
| QQmlComponent * | barDelegate() const |
| void | setBarDelegate(QQmlComponent *newBarDelegate) |
알림 신호:
| void | barDelegateChanged() |
[read-only] barSets : QList<QBarSet *> const
이 속성에는 시리즈에 추가된 세트의 목록이 저장됩니다.
함수에 액세스합니다:
| QList<QBarSet *> | barSets() const |
알림 신호:
| void | barSetsChanged() |
barWidth : qreal
이 속성은 계열 막대의 너비를 보유합니다.
너비 단위는 X축의 단위입니다. 막대의 최소 너비는 0이며 음수 값은 0으로 처리됩니다. 너비를 0으로 설정하면 X축의 배율에 관계없이 화면에서 막대의 너비가 1픽셀이 됩니다. 0보다 넓은 막대는 X축 배율을 사용하여 크기가 조정됩니다.
기본적으로 바 너비는 0.5입니다(바는 사용 가능한 너비의 50%를 차지합니다). 유효한 값의 범위는 0.0(0%)에서 1.0(100%)입니다.
참고: QBarSeries 와 함께 사용할 경우 이 값은 단일 막대의 너비가 아닌 막대 그룹의 너비를 지정합니다.
기능에 액세스합니다:
| qreal | barWidth() const |
| void | setBarWidth(qreal width) |
알림 신호:
| void | barWidthChanged() |
QBarSeries 를참조하세요 .
barsType : BarsType
이 속성은 막대 시리즈의 유형을 보유합니다.
액세스 함수:
| QBarSeries::BarsType | barsType() const |
| void | setBarsType(QBarSeries::BarsType type) |
알림 신호:
| void | barsTypeChanged(QBarSeries::BarsType type) |
borderColors : QList<QColor>
이 속성에는 계열의 모든 개체에 사용할 테두리 색상 목록이 저장됩니다.
색상보다 시리즈가 많은 경우 색상 목록이 래핑되고 목록의 첫 번째 색상으로 다시 시작됩니다. 이 속성을 설정하지 않으면(기본값) QGraphsTheme::borderColors 의 색상이 사용됩니다.
기능에 액세스합니다:
| QList<QColor> | borderColors() const |
| void | setBorderColors(const QList<QColor> &newBorderColors) |
알림 신호:
| void | borderColorsChanged() |
[read-only] count : const qsizetype
이 속성은 막대 시리즈에 있는 막대 세트의 수를 보유합니다.
함수에 액세스합니다:
| qsizetype | count() const | [see note below] |
참고: 이 함수는 메타 객체 시스템과 QML을 통해 호출할 수 있습니다. Q_INVOKABLE 을 참조하세요.
알림 신호:
| void | countChanged() |
labelsAngle : qreal
이 속성은 값 레이블의 각도를 도 단위로 저장합니다.
함수에 액세스합니다:
| qreal | labelsAngle() const |
| void | setLabelsAngle(qreal angle) |
알림 신호:
| void | labelsAngleChanged(qreal angle) |
labelsFormat : QString
이 속성은 막대 시리즈에서 레이블을 표시하는 데 사용되는 형식을 보유합니다.
QBarSeries 다음 형식 태그를 지원합니다:
| @value | 막대의 값 |
예를 들어, 다음과 같이 형식 태그를 사용하면 값 뒤에 단위(u)가 표시되는 레이블이 생성됩니다:
series->setLabelsFormat("@value u");
기본적으로 레이블은 막대의 값을 표시합니다. 퍼센트 막대 시리즈의 경우 값 뒤에 %가 추가됩니다. 레이블은 플롯 영역에 표시되며, 막대가 서로 가까이 있는 경우 레이블이 겹칠 수 있습니다.
기능에 액세스합니다:
| QString | labelsFormat() const |
| void | setLabelsFormat(const QString &format) |
알림 신호:
| void | labelsFormatChanged(const QString &format) |
labelsVisible, labelsPosition, labelsPrecision 를참조하세요 .
labelsMargin : qreal
이 속성은 값 레이블의 여백을 픽셀 단위로 유지합니다.
이 측면 여백은 labelsPosition 이 LabelsPosition.Center 이 아닌 다른 값으로 설정된 경우에 사용됩니다. 기본값은 0 입니다.
기능에 액세스합니다:
| qreal | labelsMargin() const |
| void | setLabelsMargin(qreal margin) |
알림 신호:
| void | labelsMarginChanged(qreal margin) |
labelsPosition : LabelsPosition
이 속성은 값 레이블의 위치를 보유합니다.
함수에 액세스합니다:
| QBarSeries::LabelsPosition | labelsPosition() const |
| void | setLabelsPosition(QBarSeries::LabelsPosition position) |
알림 신호:
| void | labelsPositionChanged(QBarSeries::LabelsPosition position) |
labelsVisible 및 labelsFormat 을참조하세요 .
labelsPrecision : int
이 속성은 값 레이블에 표시되는 유효 자릿수의 최대값을 보유합니다.
기본값은 6입니다.
기능에 액세스합니다:
| int | labelsPrecision() const |
| void | setLabelsPrecision(int precision) |
알림 신호:
| void | labelsPrecisionChanged(int precision) |
labelsVisible : bool
이 속성은 막대 시리즈에서 레이블의 가시성을 유지합니다. 기본 레이블 가시성은 false 입니다.
기능에 액세스합니다:
| bool | labelsVisible() const |
| void | setLabelsVisible(bool visible = true) |
알림 신호:
| void | labelsVisibleChanged(bool visible) |
seriesColors : QList<QColor>
이 속성에는 계열의 모든 개체에 사용할 기본 색상 목록이 저장됩니다.
시리즈가 색상보다 많으면 색상 목록이 래핑되고 목록의 첫 번째 색상으로 다시 시작됩니다. 이 속성을 설정하지 않으면(기본값) QGraphsTheme::seriesColors 의 색상이 사용됩니다.
기능에 액세스합니다:
| QList<QColor> | seriesColors() const |
| void | setSeriesColors(const QList<QColor> &newSeriesColors) |
알림 신호:
| void | seriesColorsChanged() |
멤버 함수 문서
[explicit] QBarSeries::QBarSeries(QObject *parent = nullptr)
QObject 와 parent 의 자식인 빈 막대 시리즈를 구성합니다 .
[invokable] bool QBarSeries::append(QBarSet *set)
set 으로 지정된 막대 집합을 막대 시리즈에 추가하고 소유권을 가져옵니다. 집합이 null이거나 이미 시리즈에 속해 있으면 추가되지 않습니다. 추가에 성공하면 true 을 반환합니다.
참고: 이 함수는 메타 객체 시스템과 QML을 통해 호출할 수 있습니다. Q_INVOKABLE 을 참조하세요.
[invokable] bool QBarSeries::append(const QList<QBarSet *> &sets)
sets 에 지정된 막대 세트 목록을 막대 시리즈에 추가하고 세트의 소유권을 가져옵니다. 모든 집합이 성공적으로 추가되면 true 을 반환합니다. 집합 중 하나라도 null이거나 이전에 시리즈에 추가된 적이 있는 경우 아무것도 추가되지 않고 false 을 반환합니다. 목록에 두 번 이상 나타나는 집합이 있으면 아무것도 추가되지 않고 false 을 반환합니다.
참고: 이 함수는 메타 객체 시스템과 QML을 통해 호출할 수 있습니다. Q_INVOKABLE 을 참조하세요.
[invokable] QBarSet *QBarSeries::at(qsizetype index)
index 위치에 지정된 BarSet 을 검색합니다. BarSet 을 찾지 못하면 null을 반환합니다.
참고: 이 함수는 메타 객체 시스템과 QML을 통해 호출할 수 있습니다. Q_INVOKABLE 을 참조하세요.
QList<QBarSet *> QBarSeries::barSets() const
막대 시리즈의 막대 세트 목록을 반환합니다. 막대 세트의 소유권을 유지합니다.
참고: 바 세트 프로퍼티에 대한 게터 함수입니다.
qreal QBarSeries::barWidth() const
시리즈의 막대 너비를 반환합니다.
참고: barWidth 속성에 대한 게터 함수입니다.
setBarWidth()도 참조하세요 .
[signal] void QBarSeries::barsetsAdded(const QList<QBarSet *> &sets)
이 신호는 sets 에 지정된 막대 세트가 시리즈에 추가될 때 발생합니다.
[signal] void QBarSeries::barsetsRemoved(const QList<QBarSet *> &sets)
이 신호는 sets 에서 지정한 막대 세트가 시리즈에서 제거될 때 발생합니다.
remove()도 참조하세요 .
[invokable] void QBarSeries::clear()
시리즈에서 모든 막대 세트를 제거하고 영구적으로 삭제합니다.
참고: 이 함수는 메타 객체 시스템과 QML을 통해 호출할 수 있습니다. Q_INVOKABLE 을 참조하세요.
[invokable] qsizetype QBarSeries::count() const
막대 시리즈에 있는 막대 세트의 수를 반환합니다.
참고: 이 함수는 메타객체 시스템과 QML을 통해 호출할 수 있습니다. Q_INVOKABLE 을 참조하세요.
참고: 속성 개수에 대한 Getter 함수.
[invokable] qsizetype QBarSeries::find(QBarSet *set) const
set 에 정의된 대로 찾은 첫 번째 BarSet 의 인덱스를 반환합니다. BarSet 을 찾을 수 없으면 -1을 반환합니다.
참고: 이 함수는 메타 객체 시스템과 QML을 통해 호출할 수 있습니다. Q_INVOKABLE 을 참조하세요.
[invokable] bool QBarSeries::insert(qsizetype index, QBarSet *set)
set 으로 지정된 막대 집합을 index 으로 지정된 위치의 계열에 삽입하고 집합의 소유권을 가져옵니다. 집합이 null이거나 이미 시리즈에 속해 있으면 추가되지 않습니다. 삽입에 성공하면 true 을 반환합니다.
참고: 이 함수는 메타 객체 시스템과 QML을 통해 호출할 수 있습니다. Q_INVOKABLE 을 참조하세요.
bool QBarSeries::labelsVisible() const
레이블의 표시 여부를 반환합니다.
참고: 레이블Visible 속성에 대한 게터 함수입니다.
setLabelsVisible()도 참조하세요 .
[signal] void QBarSeries::labelsVisibleChanged(bool visible)
이 신호는 레이블의 표시 여부가 visible 로 변경될 때 발생합니다.
참고: 속성에 대한 알림 신호 labelsVisible.
labelsVisible() 및 setLabelsVisible()도 참조하세요 .
[invokable] bool QBarSeries::remove(QBarSet *set)
set 에 지정된 바 세트를 시리즈에서 제거하고 제거에 성공하면 영구적으로 삭제합니다. 집합이 제거된 경우 true 을 반환합니다.
참고: 이 함수는 메타 객체 시스템과 QML을 통해 호출할 수 있습니다. Q_INVOKABLE 을 참조하세요.
[invokable] bool QBarSeries::remove(qsizetype index)
index 위치에서 BarSet 을 제거합니다. BarSet 은 영구적으로 삭제됩니다.
참고: 이 함수는 메타 객체 시스템과 QML을 통해 호출할 수 있습니다. Q_INVOKABLE 을 참조하세요.
[invokable] void QBarSeries::removeMultiple(qsizetype index, qsizetype count)
index 부터 여러 개의 count 까지의 시리즈에서 여러 개의 바셋을 제거합니다. 바셋은 영구적으로 삭제됩니다.
참고: 이 함수는 메타 객체 시스템과 QML을 통해 호출할 수 있습니다. Q_INVOKABLE 을 참조하세요.
[invokable] bool QBarSeries::replace(const QList<QBarSet *> &sets)
이 BarSeries 내부의 전체 BarSet 목록을 sets 에 지정된 바셋으로 바꿉니다. 원래의 모든 바셋은 영구적으로 삭제됩니다. 모든 바셋이 교체되면 true 을 반환합니다.
참고: 이 함수는 메타 객체 시스템과 QML을 통해 호출할 수 있습니다. Q_INVOKABLE 을 참조하세요.
[invokable] bool QBarSeries::replace(QBarSet *oldValue, QBarSet *newValue)
oldValue 에 지정된 BarSet 을 newValue 의 으로 바꿉니다. oldValue 의 BarSet 은 시리즈 내에서 발견되면 영구적으로 삭제됩니다. 대체에 성공하면 true 을 반환합니다.
참고: 이 함수는 메타 객체 시스템과 QML을 통해 호출할 수 있습니다. Q_INVOKABLE 을 참조하세요.
[invokable] void QBarSeries::replace(qsizetype index, QBarSet *set)
index 에 있는 BarSet 을 set 로 바꿉니다. 원본 BarSet 은 영구적으로 삭제됩니다.
참고: 이 함수는 메타 객체 시스템과 QML을 통해 호출할 수 있습니다. Q_INVOKABLE 을 참조하세요.
void QBarSeries::setBarWidth(qreal width)
시리즈의 막대 너비를 width 로 설정합니다.
참고: 속성의 세터 함수 barWidth.
barWidth()도 참조하세요 .
void QBarSeries::setLabelsVisible(bool visible = true)
막대 시리즈의 레이블 표시 여부를 visible 로 설정합니다.
참고: 속성에 대한 세터 함수 labelsVisible.
labelsVisible()도 참조하세요 .
[signal] void QBarSeries::setValueAdded(qsizetype index, qsizetype count, QBarSet *barset)
이 신호는 바셋의 값이 변경될 때 발생합니다. index 은 시리즈에서 바셋의 인덱스입니다. 추가된 값의 수는 count 으로 표시됩니다. barset 은 변경된 집합에 대한 포인터입니다.
[signal] void QBarSeries::setValueChanged(qsizetype index, QBarSet *barset)
이 신호는 바셋의 값이 변경될 때 발신됩니다. index 는 시리즈에서 바셋의 인덱스입니다. barset 은 변경된 세트에 대한 포인터입니다.
[signal] void QBarSeries::setValueRemoved(qsizetype index, qsizetype count, QBarSet *barset)
이 신호는 바셋의 값이 변경될 때 발생합니다. index 은 시리즈에서 바셋의 인덱스입니다. 제거된 값의 수는 count 으로 표시됩니다. barset 은 변경된 집합에 대한 포인터입니다.
[invokable] bool QBarSeries::take(QBarSet *set)
시리즈에서 set 하나를 가져옵니다. 막대 집합 객체를 삭제하지 않습니다.
참고: 시리즈는 막대 집합의 상위 개체로 유지됩니다. 전체 소유권을 가져가려면 부모 객체를 설정해야 합니다.
가져오기 작업이 성공하면 true 을 반환합니다.
참고: 이 함수는 메타 객체 시스템과 QML을 통해 호출할 수 있습니다. Q_INVOKABLE 을 참조하세요.
[override virtual] QAbstractSeries::SeriesType QBarSeries::type() const
속성에 대한 액세스 함수를 다시 구현합니다: QAbstractSeries::type.
막대 시리즈를 반환합니다.
[signal] void QBarSeries::updatedBars()
이 신호는 막대가 업데이트될 때 발생합니다.
© 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.
