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 |
- 상속된 멤버를 포함한 모든 멤버 목록
- QBarCategoryAxis는 2D용Qt Graphs C++ 클래스의 일부입니다.
공개 유형
(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) |
멤버 유형 설명
[since 6.11] enum class QBarCategoryAxis::LabelPosition
이 열거형은 카테고리 레이블의 위치를 나타냅니다.
| 상수 | 값 | 설명 |
|---|---|---|
QBarCategoryAxis::LabelPosition::Center | 0 | 라벨이 범주 중앙에 정렬됩니다. |
QBarCategoryAxis::LabelPosition::OnValue | 1 | 라벨이 범주의 상단 경계선에 배치됩니다. |
이 열거형은 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`에 포함되어야 합니다.
액세스 함수:
알림 신호:
| void | maxChanged(const QString &max) |
min : QString
이 속성은 축의 최소값을 나타냅니다.
축상의 최소값입니다. 지정된 값은 ` categories`에 포함되어야 합니다.
액세스 함수:
알림 신호:
| 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.