이 페이지에서

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(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

이 속성은 막대 세트의 채우기 색상을 지정합니다.

액세스 함수:

QColor color() const
void setColor(QColor color)

알림 신호:

void colorChanged(QColor color)

[read-only] count : qsizetype

이 속성은 막대 집합에 포함된 값의 개수를 나타냅니다.

액세스 함수:

qsizetype count() const[see note below]

참고: 이 함수는 메타 객체 시스템과 QML을 통해 호출할 수 있습니다. Q_INVOKABLE 를 참조하십시오.

알림 신호:

void countChanged()

label : QString

이 속성은 막대 세트의 레이블을 저장합니다.

액세스 함수:

QString label() const
void setLabel(const QString &label)

알림 신호:

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 는 삽입된 값의 개수입니다.

append() 및 insert()도 참조하십시오 .

[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.