QBarSet Class
QBarSet 클래스는 막대 그래프에서 하나의 막대 집합을 나타냅니다. 더 보기...
| 헤더: | #include <QBarSet> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Graphs) target_link_libraries(mytarget PRIVATE Qt6::Graphs) |
| qmake: | QT += graphs |
| QML에서: | BarSet |
| 상속: | QObject |
- 상속된 멤버를 포함한 모든 멤버 목록
- QBarSet은 2D용 ‘Qt Graphs ’ C++ 클래스의 일부입니다.
속성
|
|
공개 함수
| QBarSet(const QString &label, QObject *parent = nullptr) | |
| virtual | ~QBarSet() override |
| void | append(const QList<qreal> &values) |
| void | append(qreal value) |
| qreal | at(qsizetype index) const |
| QColor | borderColor() const |
| qreal | borderWidth() const |
| void | clear() |
| QColor | color() const |
| qsizetype | count() const |
| void | deselectAllBars() |
| void | deselectBar(qsizetype index) |
| void | deselectBars(const QList<qsizetype> &indexes) |
| void | insert(qsizetype index, qreal value) |
| bool | isBarSelected(qsizetype index) const |
| QString | label() const |
| QColor | labelColor() const |
| void | remove(qsizetype index, qsizetype count = 1) |
| void | replace(qsizetype index, qreal value) |
| void | selectAllBars() |
| void | selectBar(qsizetype index) |
| void | selectBars(const QList<qsizetype> &indexes) |
| QList<qsizetype> | selectedBars() const |
| QColor | selectedColor() const |
| void | setBarSelected(qsizetype index, bool selected) |
| void | setBorderColor(QColor color) |
| void | setBorderWidth(qreal borderWidth) |
| void | setColor(QColor color) |
| void | setLabel(const QString &label) |
| void | setLabelColor(QColor color) |
| void | setSelectedColor(QColor color) |
| void | setValues(const QVariantList &values) |
| qreal | sum() const |
| void | toggleSelection(const QList<qsizetype> &indexes) |
| QVariantList | values() const |
| QBarSet & | operator<<(qreal value) |
| qreal | operator[](qsizetype index) const |
신호
| void | borderColorChanged(QColor color) |
| void | borderWidthChanged(qreal width) |
| void | colorChanged(QColor color) |
| void | countChanged() |
| void | labelChanged() |
| void | labelColorChanged(QColor color) |
| void | selectedBarsChanged(const QList<qsizetype> &indexes) |
| void | selectedColorChanged(QColor color) |
| void | update() |
| void | updatedBars() |
| void | valueAdded(qsizetype index, qsizetype count) |
| void | valueChanged(qsizetype index) |
| void | valueRemoved(qsizetype index, qsizetype count) |
| void | valuesAdded(qsizetype index, qsizetype count) |
| void | valuesChanged() |
| void | valuesRemoved(qsizetype index, qsizetype count) |
상세 설명
막대 집합은 각 범주마다 하나의 데이터 값을 포함합니다. 집합의 첫 번째 값은 첫 번째 범주에 속하는 것으로 간주되며, 두 번째 값은 두 번째 범주에 속하는 것으로 간주되는 식으로 이어집니다. 집합의 값 개수가 범주 수보다 적을 경우, 누락된 값은 집합의 맨 끝에 위치한 것으로 간주됩니다. 집합 중간에 누락된 값이 있는 경우, 수치 0이 사용됩니다. 0값으로 구성된 집합의 레이블은 표시되지 않습니다.
QBarSeries도 참조하십시오 .
속성 문서
borderColor : QColor
이 속성은 막대 세트의 테두리 색상을 지정합니다.
액세스 함수:
| QColor | borderColor() const |
| void | setBorderColor(QColor color) |
알림 신호:
| void | borderColorChanged(QColor color) |
borderWidth : qreal
이 속성은 테두리 선의 너비를 지정합니다. 기본적으로 너비는 -1이며, 이는 테두리 너비가 테마에 의해 정의됨을 의미합니다.
액세스 함수:
| qreal | borderWidth() const |
| void | setBorderWidth(qreal borderWidth) |
Notifier 신호:
| void | borderWidthChanged(qreal width) |
color : QColor
이 속성은 막대 세트의 채우기 색상을 지정합니다.
액세스 함수:
알림 신호:
| void | colorChanged(QColor color) |
[read-only] count : qsizetype
이 속성은 막대 집합에 포함된 값의 개수를 나타냅니다.
액세스 함수:
| qsizetype | count() const | [see note below] |
참고: 이 함수는 메타 객체 시스템과 QML을 통해 호출할 수 있습니다. Q_INVOKABLE 를 참조하십시오.
알림 신호:
| void | countChanged() |
label : QString
이 속성은 막대 세트의 레이블을 저장합니다.
액세스 함수:
알림 신호:
| void | labelChanged() |
labelColor : QColor
이 속성은 막대 세트의 텍스트(라벨) 색상을 지정합니다.
액세스 함수:
| QColor | labelColor() const |
| void | setLabelColor(QColor color) |
알림 신호:
| void | labelColorChanged(QColor color) |
[read-only] selectedBars : QList<qsizetype>
이 속성은 현재 선택된 막대의 인덱스를 포함합니다.
액세스 함수:
| QList<qsizetype> | selectedBars() const |
알림 신호:
| void | selectedBarsChanged(const QList<qsizetype> &indexes) |
selectedColor : QColor
이 속성은 선택된 집합의 채우기 색상을 저장합니다.
액세스 함수:
| QColor | selectedColor() const |
| void | setSelectedColor(QColor color) |
알림 신호:
| void | selectedColorChanged(QColor color) |
values : QVariantList
이 속성은 막대 세트의 값을 저장합니다.
real 또는 point 유형의 목록을 값으로 설정할 수 있습니다.
실수(real) 유형의 목록을 값으로 설정하면, 해당 값들이 바로 막대 집합의 값을 정의합니다.
점 유형의 목록을 값으로 설정하면, 점의 x 좌표가 막대 집합에서 0을 기준으로 한 인덱스를 지정합니다. 막대 집합의 크기는 가장 큰 x 좌표 값 + 1입니다. 0과 가장 큰 값 사이의 x 좌표에 해당하는 점이 누락된 경우, 해당 점의 값은 0으로 설정됩니다.
액세스 함수:
| QVariantList | values() const |
| void | setValues(const QVariantList &values) |
알림 신호:
| void | valuesChanged() |
멤버 함수 설명서
[explicit] QBarSet::QBarSet(const QString &label, QObject *parent = nullptr)
label 라는 레이블과 parent 를 부모로 하는 막대 차트 세트를 생성합니다.
[override virtual noexcept] QBarSet::~QBarSet()
설정된 막대를 제거합니다.
[invokable] void QBarSet::append(const QList<qreal> &values)
values 로 지정된 실수 값 목록을 막대 집합의 끝에 추가합니다.
참고: 이 함수는 메타 객체 시스템 및 QML을 통해 호출할 수 있습니다. Q_INVOKABLE 를 참조하십시오.
또한 append ()를참조하십시오 .
[invokable] void QBarSet::append(qreal value)
value 로 지정된 새 값을 막대 집합의 끝에 추가합니다.
참고: 이 함수는 메타 객체 시스템과 QML을 통해 호출할 수 있습니다. Q_INVOKABLE 를 참조하십시오.
[invokable] qreal QBarSet::at(qsizetype index) const
bar 세트에서 index 로 지정된 값을 반환합니다. 인덱스가 범위를 벗어날 경우 0.0이 반환됩니다.
참고: 이 함수는 메타 객체 시스템 및 QML을 통해 호출할 수 있습니다. Q_INVOKABLE 를 참조하십시오.
QColor QBarSet::borderColor() const
지정된 막대 세트의 선 색상을 반환합니다.
참고: borderColor 속성에 대한게터 함수입니다.
setBorderColor()도 참조하십시오 .
[invokable] void QBarSet::clear()
집합에서 모든 값을 제거합니다.
참고: 이 함수는 메타 객체 시스템과 QML을 통해 호출할 수 있습니다. Q_INVOKABLE 를 참조하십시오.
QColor QBarSet::color() const
막대 세트의 채우기 색상을 반환합니다.
참고: color 속성에 대한게터 함수입니다.
setColor()도 참조하십시오 .
[invokable] qsizetype QBarSet::count() const
바 세트에 포함된 값의 개수를 반환합니다.
참고: 이 함수는 메타 객체 시스템과 QML을 통해 호출할 수 있습니다. Q_INVOKABLE 를 참조하십시오.
참고: count 속성에 대한게터 함수입니다.
[invokable] void QBarSet::deselectAllBars()
세트에 포함된 모든 막대를 선택 해제합니다.
참고: ` QBarSet::selectedBarsChanged`이벤트를 발생시킵니다 .
참고: 이 함수는 메타 객체 시스템과 QML을 통해 호출할 수 있습니다. Q_INVOKABLE 를 참조하십시오.
setBarSelected()도 참조하십시오 .
[invokable] void QBarSet::deselectBar(qsizetype index)
index 에 있는 막대를 선택 해제합니다.
참고: QBarSet::selectedBarsChanged 를발생시킵니다 .
참고: 이 함수는 메타 객체 시스템 및 QML을 통해 호출할 수 있습니다. Q_INVOKABLE 를 참조하십시오.
setBarSelected()도 참조하십시오 .
[invokable] void QBarSet::deselectBars(const QList<qsizetype> &indexes)
indexes 목록에서 여러 막대가 선택 해제된 것으로 표시합니다.
참고: ` QBarSet::selectedBarsChanged`를발생시킵니다 .
참고: 이 함수는 메타 객체 시스템과 QML을 통해 호출할 수 있습니다. Q_INVOKABLE 를 참조하십시오.
setBarSelected()도 참조하십시오 .
[invokable] void QBarSet::insert(qsizetype index, qreal value)
index 로 지정된 위치에 value 를 삽입합니다. 삽입된 값 뒤에 오는 값들은 한 칸씩 위로 이동합니다.
참고: 이 함수는 메타 객체 시스템을 통해 또는 QML에서 호출할 수 있습니다. Q_INVOKABLE 를 참조하십시오.
remove()도 참조하십시오 .
[invokable] bool QBarSet::isBarSelected(qsizetype index) const
지정된 index 에 있는 막대가 선택된 막대 중 하나일 경우 ` true `를 반환하고, 그렇지 않은 경우 ` false `를 반환합니다.
참고: 선택된 막대는 QBarSet::setSelectedColor 를 통해 색상이 지정된 경우 해당 색상으로 그려집니다.
참고: 이 함수는 메타 객체 시스템과 QML을 통해 호출할 수 있습니다. Q_INVOKABLE 를 참조하십시오.
selectedBars(), setBarSelected(), setSelectedColor()도 참조하십시오 .
QString QBarSet::label() const
바 세트의 레이블을 반환합니다.
참고: label 속성의게터 함수입니다.
setLabel()도 참조하십시오 .
QColor QBarSet::labelColor() const
지정된 막대 세트의 텍스트 색상을 반환합니다.
참고: labelColor 속성에 대한게터 함수입니다.
setLabelColor()도 참조하십시오 .
[invokable] void QBarSet::remove(qsizetype index, qsizetype count = 1)
count 로 지정된 개수의 값을 index 로 지정된 값부터 시작하는 막대 집합에서 제거합니다.
참고: 이 함수는 메타 객체 시스템 및 QML을 통해 호출할 수 있습니다. Q_INVOKABLE 를 참조하십시오.
insert()도 참조하십시오 .
[invokable] void QBarSet::replace(qsizetype index, qreal value)
value 로 지정된 값을 index 로 지정된 위치에 설정된 막대에 추가합니다.
참고: 이 함수는 메타 객체 시스템과 QML을 통해 호출할 수 있습니다. Q_INVOKABLE 를 참조하십시오.
[invokable] void QBarSet::selectAllBars()
세트에 포함된 모든 막대를 선택 상태로 표시합니다.
참고: ` QBarSet::selectedBarsChanged`를발생시킵니다 .
참고: 이 함수는 메타 객체 시스템 및 QML을 통해 호출할 수 있습니다. Q_INVOKABLE 를 참조하십시오.
setBarSelected()도 참조하십시오 .
[invokable] void QBarSet::selectBar(qsizetype index)
index 에 있는 막대를 선택된 상태로 표시합니다.
참고: QBarSet::selectedBarsChanged 를발생시킵니다 .
참고: 이 함수는 메타 객체 시스템 및 QML을 통해 호출할 수 있습니다. Q_INVOKABLE 를 참조하십시오.
setBarSelected()도 참조하십시오 .
[invokable] void QBarSet::selectBars(const QList<qsizetype> &indexes)
indexes 목록에서 여러 막대를 선택된 상태로 표시합니다.
참고: ` QBarSet::selectedBarsChanged`를발생시킵니다 .
참고: 이 함수는 메타 객체 시스템 및 QML을 통해 호출할 수 있습니다. Q_INVOKABLE 를 참조하십시오.
setBarSelected()도 참조하십시오 .
QList<qsizetype> QBarSet::selectedBars() const
선택된 것으로 표시된 막대 목록을 반환합니다.
참고: selectedBars 속성에 대한게터 함수입니다.
setBarSelected()도 참조하십시오 .
[signal] void QBarSet::selectedBarsChanged(const QList<qsizetype> &indexes)
이 신호는 선택된 막대가 변경될 때 발생합니다. ` indexes `는 선택된 막대의 인덱스 목록입니다.
참고: ` selectedBars` 속성에 대한알림 신호입니다.
QColor QBarSet::selectedColor() const
선택된 막대의 색상을 반환합니다.
이는 선택된 것으로 표시된 막대의 채우기(브러시) 색상입니다. 지정되지 않은 경우, ` QBarSet::color `의 값이 기본값으로 사용됩니다.
참고: selectedColor 속성에 대한게터 함수입니다.
setSelectedColor() 및 color도 참조하십시오 .
[invokable] void QBarSet::setBarSelected(qsizetype index, bool selected)
selected 에 지정된 대로 index 에 있는 막대를 선택 또는 선택 해제 상태로 표시합니다.
참고: 선택된 막대는 지정된 경우 선택된 색상으로 그려집니다. QBarSet::selectedBarsChanged 를 발생시킵니다.
참고: 이 함수는 메타 객체 시스템 및 QML을 통해 호출할 수 있습니다. Q_INVOKABLE 를 참조하십시오.
isBarSelected() 및 setSelectedColor()도 참조하십시오 .
void QBarSet::setBorderColor(QColor color)
color 로 설정된 막대의 선 색상을 지정합니다.
참고: borderColor 속성에 대한세터 함수입니다.
borderColor()도 참조하십시오 .
void QBarSet::setColor(QColor color)
color 로 설정된 막대 세트의 채우기 색상을 설정합니다.
참고: color 속성에 대한세터 함수입니다.
color()도 참조하십시오 .
void QBarSet::setLabel(const QString &label)
label 를 막대 집합의 새 레이블로 설정합니다.
참고: label 속성에 대한설정 함수입니다.
label()도 참조하십시오 .
void QBarSet::setLabelColor(QColor color)
color 로 설정된 막대의 텍스트 색상을 지정합니다.
참고: labelColor 속성에 대한세터 함수입니다.
labelColor()도 참조하십시오 .
void QBarSet::setSelectedColor(QColor color)
선택한 막대의 color 속성을 설정합니다.
참고: selectedColor 속성에 대한세터 함수입니다.
selectedColor항목도 참조하십시오 .
[invokable] qreal QBarSet::sum() const
바 세트에 포함된 모든 값의 합을 반환합니다.
참고: 이 함수는 메타 객체 시스템 및 QML을 통해 호출할 수 있습니다. Q_INVOKABLE 를 참조하십시오.
[invokable] void QBarSet::toggleSelection(const QList<qsizetype> &indexes)
지정된 indexes 에 있는 막대의 선택 상태를 반대 상태로 변경합니다.
참고: ` QBarSet::selectedBarsChanged`이벤트를 발생시킵니다 .
참고: 이 함수는 메타 객체 시스템 및 QML을 통해 호출할 수 있습니다. Q_INVOKABLE 를 참조하십시오.
setBarSelected()도 참조하십시오 .
[signal] void QBarSet::update()
이 신호는 바셋이 업데이트될 때 발생합니다.
[signal] void QBarSet::updatedBars()
이 세트의 막대가 업데이트되면 이 신호가 발생합니다.
[signal] void QBarSet::valueAdded(qsizetype index, qsizetype count)
이 신호는 막대 집합에 새로운 값이 추가될 때 발생합니다. ` index `는 처음 삽입된 값의 위치를 나타내며, ` count `는 삽입된 값의 개수를 나타냅니다.
[signal] void QBarSet::valueChanged(qsizetype index)
index 로 지정된 위치의 값이 변경되면 이 신호가 발생합니다.
at()도 참조하십시오 .
[signal] void QBarSet::valueRemoved(qsizetype index, qsizetype count)
이 신호는 막대 집합에서 값이 제거될 때 발생합니다. ` index `는 가장 먼저 제거된 값의 위치를 나타내며, ` count `는 제거된 값의 개수를 나타냅니다.
[signal] void QBarSet::valuesAdded(qsizetype index, qsizetype count)
이 신호는 막대 집합에 새로운 값이 추가될 때 발생합니다. index 는 처음 삽입된 값의 위치를 나타내며, count 는 삽입된 값의 개수입니다.
[signal] void QBarSet::valuesRemoved(qsizetype index, qsizetype count)
이 신호는 막대 집합에서 값이 제거될 때 발생합니다. ` index `는 가장 먼저 제거된 값의 위치를 나타내며, ` count `는 제거된 값의 개수입니다.
remove()도 참조하십시오 .
QBarSet &QBarSet::operator<<(qreal value)
value 로 지정된 실수 값을 막대 집합의 끝에 추가하는 편리한 연산자입니다.
append()도 참조하십시오 .
qreal QBarSet::operator[](qsizetype index) const
index 로 지정된 막대 세트의 값을 반환합니다. 인덱스가 범위를 벗어난 경우 0.0이 반환됩니다.
© 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.