이 페이지에서

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 클래스를 사용하여 간단한 막대 차트를 만드는 방법은 ‘위젯이 포함된 차트 갤러리’를 참조하십시오.

1월부터 6월까지 5명의 월별 값을 그룹화한 세로 막대 그래프

QBarSet, QBarSeries, QStackedBarSeries, QPercentBarSeries, QHorizontalBarSeries, QHorizontalStackedBarSeries 및 QHorizontalPercentBarSeries도 참조하십시오 .

멤버 유형 문서

enum QAbstractBarSeries::LabelsPosition

이 열거형 값은 데이터 값 레이블의 위치를 나타냅니다:

상수값설명
QAbstractBarSeries::LabelsCenter0라벨이 막대의 중앙에 위치합니다.
QAbstractBarSeries::LabelsInsideEnd1라벨이 막대 상단 내부에 위치합니다.
QAbstractBarSeries::LabelsInsideBase2라벨이 막대 안쪽 하단에 위치합니다.
QAbstractBarSeries::LabelsOutsideEnd3라벨은 막대 상단 바깥쪽에 위치합니다.

속성 문서

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)

알림 신호:

멤버 함수 설명서

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