QBarSet Class

QBarSet 클래스는 막대 그래프에서 하나의 막대 집합을 나타냅니다. 더 보기...

Header: #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)

알림 신호:

void borderWidthChanged(qreal width)

color : QColor

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

함수에 액세스합니다:

QColor color() const
void setColor(QColor color)

알림 신호:

void colorChanged(QColor color)

[read-only] count : const 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 : const 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 유형 목록을 값으로 설정할 수 있습니다.

실수 유형 목록을 값으로 설정하면 해당 유형이 막대 세트 값을 직접 정의합니다.

포인트 유형 목록을 값으로 설정하는 경우 포인트의 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

막대 집합에서 index 에 지정된 값을 반환합니다. 인덱스가 범위를 벗어나면 0.0이 반환됩니다.

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

QColor QBarSet::borderColor() const

막대 세트의 선 색상을 반환합니다.

참고: borderColor 속성에 대한 게터 함수입니다.

setBorderColor()도 참조하세요 .

[invokable] void QBarSet::clear()

집합에서 모든 값을 제거합니다.

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

QColor QBarSet::color() const

막대 세트의 채우기 색을 반환합니다.

참고: 속성 색에 대한 게터 함수입니다.

setColor()도 참조하세요 .

[invokable] qsizetype QBarSet::count() const

막대 집합의 값 수를 반환합니다.

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

참고: 속성 개수에 대한 Getter 함수.

[invokable] void QBarSet::deselectAllBars()

세트의 모든 막대를 선택 해제합니다.

참고: QBarSet::selectedBarsChanged 를 출력합니다.

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

setBarSelected()도 참조하세요 .

[invokable] void QBarSet::deselectBar(qsizetype index)

index 에서 막대를 선택 해제합니다.

참고: 이 함수는 메타 객체 시스템과 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

막대 세트의 레이블을 반환합니다.

참고: 속성 레이블에 대한 게터 함수입니다.

setLabel()도 참조하세요 .

QColor QBarSet::labelColor() const

막대 세트의 텍스트 색상을 반환합니다.

참고: labelColor 속성에 대한 게터 함수입니다.

setLabelColor()도 참조하세요 .

[invokable] void QBarSet::remove(qsizetype index, qsizetype count = 1)

index 에 지정된 값으로 시작하는 바 세트에서 count 에 지정된 값의 개수를 제거합니다.

참고: 이 함수는 메타 객체 시스템과 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)

index 에 있는 막대를 selected 에서 지정한 대로 선택 또는 선택 취소된 것으로 표시합니다.

참고: 선택된 막대는 지정된 경우 선택한 색상을 사용하여 그려집니다. 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이 반환됩니다.

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