Back to Qt.io
Contact Us Blog Download Qt
이 페이지에서

QBarCategoryAxis Class

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

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

이 클래스는 더 이상 사용되지 않습니다. 새로운 코드에서는 이 클래스를 사용하지 않는 것을 강력히 권장합니다.

속성

공개 함수

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

카테고리를 반환합니다.

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

setCategories()도 참조하십시오 .

[signal] void QBarCategoryAxis::categoriesChanged()

이 신호는 축의 범주가 변경될 때 발생합니다.

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

[invokable] void QBarCategoryAxis::clear()

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

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

int QBarCategoryAxis::count() const

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

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

[signal] void QBarCategoryAxis::countChanged()

이 신호는 축의 범주 수가 변경될 때 발생합니다.

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

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

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

QString QBarCategoryAxis::max() const

최대 범주를 반환합니다.

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

setMax()도 참조하십시오 .

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

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

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

QString QBarCategoryAxis::min() const

최소 범주를 반환합니다.

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

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를 재구현합니다.

축의 유형을 반환합니다.

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