이 페이지에서

QBarCategoryAxis Class

QBarCategoryAxis 클래스는 그래프의 축에 범주를 추가합니다. 더 보기...

헤더: #include <QBarCategoryAxis>
CMake: find_package(Qt6 REQUIRED COMPONENTS Graphs)
target_link_libraries(mytarget PRIVATE Qt6::Graphs)
qmake: QT += graphs
QML에서: BarCategoryAxis
상속: QAbstractAxis

공개 유형

(since 6.11) enum class LabelPosition { Center, OnValue }

속성

공개 함수

QBarCategoryAxis(QObject *parent = nullptr)
virtual ~QBarCategoryAxis() override
void append(const QString &category)
void append(const QStringList &categories)
QString at(qsizetype index) const
QStringList categories()
void clear()
qsizetype count() const
void insert(qsizetype index, const QString &category)
QBarCategoryAxis::LabelPosition labelPosition() const
QString max() const
QString min() const
void remove(const QString &category)
void remove(qsizetype index)
void replace(const QString &oldCategory, const QString &newCategory)
void setCategories(const QStringList &categories)
void setLabelPosition(QBarCategoryAxis::LabelPosition position)
void setMax(const QString &max)
void setMin(const QString &min)
void setRange(const QString &minCategory, const QString &maxCategory)

재구현된 공용 함수

virtual QAbstractAxis::AxisType type() const override

신호

void categoriesChanged()
void countChanged()
void labelPositionChanged(QBarCategoryAxis::LabelPosition position)
void maxChanged(const QString &max)
void minChanged(const QString &min)

상세 설명

QBarCategoryAxis는 눈금, 격자선 및 음영이 포함된 축선을 표시하도록 설정할 수 있습니다. 범주는 눈금 사이에 그려집니다.

멤버 유형 설명

[since 6.11] enum class QBarCategoryAxis::LabelPosition

이 열거형은 카테고리 레이블의 위치를 나타냅니다.

상수값설명
QBarCategoryAxis::LabelPosition::Center0라벨이 범주 중앙에 정렬됩니다.
QBarCategoryAxis::LabelPosition::OnValue1라벨이 범주의 상단 경계선에 배치됩니다.

이 열거형은 Qt 6.11에서 도입되었습니다.

속성 문서

categories : QStringList

이 속성은 축의 범주를 나타냅니다.

액세스 함수:

QStringList categories()
void setCategories(const QStringList &categories)

알림 신호:

void categoriesChanged()

[read-only] count : qsizetype

이 속성은 축의 범주 수를 나타냅니다.

액세스 함수:

qsizetype count() const

알림 신호:

void countChanged()

[since 6.11] labelPosition : LabelPosition

이 속성은 범주 레이블의 위치를 지정합니다. 축의 시작점과 끝점에 있는 레이블은 ‘값’을 기준으로 배치될 경우 다른 축의 레이블과 겹칠 수 있습니다.

이 열거형은 Qt 6.11에서 도입되었습니다.

액세스 함수:

QBarCategoryAxis::LabelPosition labelPosition() const
void setLabelPosition(QBarCategoryAxis::LabelPosition position)

알림 신호:

void labelPositionChanged(QBarCategoryAxis::LabelPosition position)

max : QString

이 속성은 축의 최대값을 나타냅니다.

축의 최대값입니다. 지정된 값은 ` categories`에 포함되어야 합니다.

액세스 함수:

QString max() const
void setMax(const QString &max)

알림 신호:

void maxChanged(const QString &max)

min : QString

이 속성은 축의 최소값을 나타냅니다.

축상의 최소값입니다. 지정된 값은 ` categories`에 포함되어야 합니다.

액세스 함수:

QString min() const
void setMin(const QString &min)

알림 신호:

void minChanged(const QString &min)

멤버 함수 설명서

[explicit] QBarCategoryAxis::QBarCategoryAxis(QObject *parent = nullptr)

parent 의 자식인 축 객체를 생성합니다.

[override virtual noexcept] QBarCategoryAxis::~QBarCategoryAxis()

축 객체를 삭제합니다.

[invokable] void QBarCategoryAxis::append(const QString &category)

축에 category 를 추가합니다. 축의 최대값은 마지막 category 와 일치하도록 변경됩니다. 이전에 카테고리가 정의되지 않은 경우, 축의 최소값도 category 와 일치하도록 변경됩니다.

범주는 유효한 QString 이어야 하며 중복될 수 없습니다. 중복된 범주는 추가되지 않습니다.

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

[invokable] void QBarCategoryAxis::append(const QStringList &categories)

categories 를 축에 추가합니다. 축의 최대값은 categories 에 있는 마지막 범주와 일치하도록 변경됩니다. 이전에 범주가 정의되지 않은 경우, 축의 최소값도 categories 에 있는 첫 번째 범주와 일치하도록 변경됩니다.

범주는 유효한 QString 이어야 하며 중복될 수 없습니다. 중복된 범주는 추가되지 않습니다.

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

[invokable] QString QBarCategoryAxis::at(qsizetype index) const

index 에 있는 카테고리를 반환합니다.

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

QStringList QBarCategoryAxis::categories()

카테고리를 반환합니다.

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

setCategories()도 참조하십시오 .

[invokable] void QBarCategoryAxis::clear()

모든 범주를 제거합니다. 축 범위의 최대값과 최소값을 QString::null로 설정합니다.

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

qsizetype QBarCategoryAxis::count() const

카테고리 개수를 반환합니다.

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

[invokable] void QBarCategoryAxis::insert(qsizetype index, const QString &category)

index 에 있는 축에 category 를 삽입합니다. category 는 유효한 QString 여야 하며, 중복될 수 없습니다. category 가 다른 범주 앞에 추가되거나 뒤에 추가되면, 축의 최소값과 최대값이 그에 따라 업데이트됩니다.

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

QString QBarCategoryAxis::max() const

최대 범주를 반환합니다.

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

setMax()도 참조하십시오 .

QString QBarCategoryAxis::min() const

최소 범주를 반환합니다.

참고: min 속성의게터 함수입니다.

setMin()도 참조하십시오 .

[invokable] void QBarCategoryAxis::remove(const QString &category)

축에서 ‘ category ’을 제거합니다. 현재 축의 최대값 또는 최소값을 설정하고 있는 범주를 제거하면 축의 범위에 영향을 미칩니다.

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

[invokable] void QBarCategoryAxis::remove(qsizetype index)

index 에 있는 범주를 축에서 제거합니다. 현재 축의 최대값이나 최소값을 설정하고 있는 범주를 제거하면 축의 범위에 영향을 미칩니다.

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

[invokable] void QBarCategoryAxis::replace(const QString &oldCategory, const QString &newCategory)

oldCategory 을 newCategory 으로 대체합니다. 축에 oldCategory 이 존재하지 않으면 아무 작업도 수행되지 않습니다. newCategory 은 유효한 QString 이어야 하며, 중복될 수 없습니다. 최소 또는 최대 범주가 대체되면 축의 최소 및 최대 값이 그에 따라 업데이트됩니다.

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

void QBarCategoryAxis::setCategories(const QStringList &categories)

categories 를 설정하고 기존 값을 삭제합니다. 축 범위는 categories 에 있는 첫 번째 및 마지막 범주에 맞춰 조정됩니다.

카테고리는 유효한 QString 이어야 하며 중복될 수 없습니다.

참고: categories 속성에 대한설정 함수입니다.

categories()도 참조하십시오 .

void QBarCategoryAxis::setMax(const QString &max)

최대 범주를 ` max`로 설정합니다.

참고: max 속성에 대한세터 함수입니다.

max()도 참조하십시오 .

void QBarCategoryAxis::setMin(const QString &min)

최소 범주를 ‘ min ’로 설정합니다.

참고: min 속성에 대한세터 함수입니다.

min()도 참조하십시오 .

void QBarCategoryAxis::setRange(const QString &minCategory, const QString &maxCategory)

minCategory 에서 maxCategory 까지의 축 범위를 설정합니다.

[override virtual] QAbstractAxis::AxisType QBarCategoryAxis::type() const

QAbstractAxis::type() const를 재구현합니다.

축의 유형을 반환합니다.

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