Back to Qt.io
Contact Us Blog Download Qt

QAbstractBarSeries Class

QAbstractBarSeries 클래스는 모든 막대 시리즈 클래스의 추상 부모 클래스입니다. 더 보기...

Header: #include <QAbstractBarSeries>
In QML: AbstractBarSeries
Inherits: QAbstractSeries
Inherited By:

QBarSeries, QHorizontalBarSeries, QHorizontalPercentBarSeries, QHorizontalStackedBarSeries, QPercentBarSeries, and QStackedBarSeries

공용 유형

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 클래스를 사용하여 간단한 막대형 차트를 만드는 방법을 알아보려면 위젯이 있는 차트 갤러리를 참조하세요.

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 : const 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)

알림 신호:

void labelsVisibleChanged()

멤버 함수 문서

[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

막대 시리즈에 있는 막대 세트의 수를 반환합니다.

참고: 프로퍼티 개수에 대한 게터 함수입니다.

[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 을 반환합니다.

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