Back to Qt.io
Contact Us Blog Download Qt

QBarCategoryAxis Class

QBarCategoryAxis 클래스는 차트의 축에 카테고리를 추가합니다. 더 보기...

Header: #include <QBarCategoryAxis>
In QML: BarCategoryAxis
Inherits: QAbstractAxis

속성

공용 함수

QBarCategoryAxis(QObject *parent = nullptr)
virtual ~QBarCategoryAxis()
void append(const QString &category)
void append(const QStringList &categories)
QString at(int index) const
QStringList categories()
void clear()
int count() const
void insert(int index, const QString &category)
QString max() const
QString min() const
void remove(const QString &category)
void replace(const QString &oldCategory, const QString &newCategory)
void setCategories(const QStringList &categories)
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 maxChanged(const QString &max)
void minChanged(const QString &min)
void rangeChanged(const QString &min, const QString &max)

상세 설명

눈금선, 격자선, 음영이 있는 축선을 표시하도록 QBarCategoryAxis를 설정할 수 있습니다. 카테고리는 눈금 사이에 그려집니다. 위젯이 있는 차트 갤러리에서 설명한 것처럼 선 시리즈와 함께 사용할 수도 있습니다.

다음 코드는 QBarCategoryAxis를 사용하는 방법을 보여줍니다:

QChartView *chartView = new QChartView;
QBarSeries *series = new QBarSeries;
// ...
chartView->chart()->addSeries(series);
chartView->chart()->createDefaultAxes();

QBarCategoryAxis *axisX = new QBarCategoryAxis;
QStringList categories;
categories << "Jan" << "Feb" << "Mar" << "Apr" << "May" << "Jun";
axisX->append(categories);
axisX->setRange("Feb", "May");
chartView->chart()->setAxisX(axisX, series);

속성 문서

categories : QStringList

이 속성은 축의 카테고리를 보유합니다.

함수에 액세스합니다:

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

알림 신호:

void categoriesChanged()

[read-only] count : const int

이 속성은 축의 카테고리 수를 보유합니다.

함수에 액세스합니다:

int count() const

알림 신호:

void countChanged()

max : QString

이 속성은 축의 최대값을 보유합니다.

함수에 액세스합니다:

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

알림 신호:

void maxChanged(const QString &max)

min : QString

이 속성은 축의 최소값을 보유합니다.

함수에 액세스합니다:

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

알림 신호:

void minChanged(const QString &min)

멤버 함수 문서

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

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

[virtual noexcept] QBarCategoryAxis::~QBarCategoryAxis()

축 개체를 파괴합니다.

void QBarCategoryAxis::append(const QString &category)

축에 category 을 추가합니다. 축의 최대값은 마지막 category 과 일치하도록 변경됩니다. 이전에 정의된 카테고리가 없는 경우 축의 최소값도 category 와 일치하도록 변경됩니다.

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

void QBarCategoryAxis::append(const QStringList &categories)

축에 categories 을 추가합니다. 축의 최대값은 categories 의 마지막 카테고리와 일치하도록 변경됩니다. 이전에 정의된 카테고리가 없는 경우 축의 최소값도 categories 의 첫 번째 카테고리와 일치하도록 변경됩니다.

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

QString QBarCategoryAxis::at(int index) const

index 에서 카테고리를 반환합니다. 인덱스가 유효해야 합니다.

QStringList QBarCategoryAxis::categories()

카테고리를 반환합니다.

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

setCategories()도 참조하세요 .

[signal] void QBarCategoryAxis::categoriesChanged()

이 신호는 축의 카테고리가 변경될 때 발산됩니다.

참고: 속성에 대한 알림 신호 categories.

[invokable] void QBarCategoryAxis::clear()

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

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

int QBarCategoryAxis::count() const

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

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

[signal] void QBarCategoryAxis::countChanged()

이 신호는 축의 카테고리 수가 변경될 때 발산됩니다.

참고: 속성에 대한 알림 신호 count.

void QBarCategoryAxis::insert(int index, const QString &category)

index 축에 category 을 삽입합니다. category 은 유효한 QString 이어야 하며 중복될 수 없습니다. category 을 다른 카테고리에 앞에 붙이거나 추가하면 축의 최소값과 최대값이 그에 따라 업데이트됩니다.

QString QBarCategoryAxis::max() const

최대 카테고리를 반환합니다.

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

setMax()도 참조하세요 .

[signal] void QBarCategoryAxis::maxChanged(const QString &max)

이 신호는 축의 max 값이 변경될 때 발생합니다.

참고: max 속성에 대한 알림 신호입니다.

QString QBarCategoryAxis::min() const

최소 카테고리를 반환합니다.

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

setMin()도 참조하세요 .

[signal] void QBarCategoryAxis::minChanged(const QString &min)

이 신호는 축의 min 값이 변경될 때 발생합니다.

참고: min 속성에 대한 알림 신호입니다.

[signal] void QBarCategoryAxis::rangeChanged(const QString &min, const QString &max)

이 신호는 축의 min 또는 max 값이 변경될 때 발생합니다.

void QBarCategoryAxis::remove(const QString &category)

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

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

oldCategory 을 newCategory 으로 바꿉니다. 축에 oldCategory 이 존재하지 않으면 아무 작업도 수행되지 않습니다. newCategory 은 유효한 QString 이어야 하며 중복될 수 없습니다. 최소 또는 최대 카테고리를 바꾸면 축의 최소값과 최대값이 그에 따라 업데이트됩니다.

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.

축의 타입을 반환합니다.

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