이 페이지에서

QAbstractAxis Class

QAbstractAxis 클래스는 특화된 축 클래스에 사용되는 기본 클래스입니다. 더 보기...

헤더: #include <QAbstractAxis>
CMake: find_package(Qt6 REQUIRED COMPONENTS Graphs)
target_link_libraries(mytarget PRIVATE Qt6::Graphs)
qmake: QT += graphs
QML에서: AbstractAxis
상속: QObject
상속받는 클래스:

QBarCategoryAxis, QDateTimeAxis, QLogValueAxis, 그리고 QValueAxis

공개 유형

enum class AxisType { Value, BarCategory, DateTime, LogValue }

속성

공개 함수

virtual ~QAbstractAxis() override
Qt::Alignment alignment() const
QColor color() const
void hide()
bool isGridVisible() const
bool isLineVisible() const
bool isSubGridVisible() const
bool isTitleVisible() const
bool isVisible() const
QQmlComponent *labelDelegate() const
qreal labelsAngle() const
bool labelsVisible() const
void setAlignment(Qt::Alignment alignment)
void setColor(QColor color)
void setGridVisible(bool visible = true)
void setLabelDelegate(QQmlComponent *newLabelDelegate)
void setLabelsAngle(qreal angle)
void setLabelsVisible(bool visible = true)
void setLineVisible(bool visible = true)
void setMax(const QVariant &max)
void setMin(const QVariant &min)
void setRange(const QVariant &min, const QVariant &max)
void setSubColor(QColor color)
void setSubGridVisible(bool visible = true)
void setTextElideMode(Qt::TextElideMode elideMode)
void setTitleColor(QColor color)
void setTitleFont(const QFont &font)
void setTitleText(const QString &title)
void setTitleVisible(bool visible = true)
void setVisible(bool visible = true)
void show()
QColor subColor() const
Qt::TextElideMode textElideMode() const
QColor titleColor() const
QFont titleFont() const
QString titleText() const
virtual QAbstractAxis::AxisType type() const = 0

신호

void alignmentChanged(Qt::Alignment alignment)
void colorChanged(QColor newColor)
void gridVisibleChanged(bool visible)
void labelDelegateChanged()
void labelsAngleChanged(qreal angle)
void labelsVisibleChanged(bool visible)
void lineVisibleChanged(bool visible)
void subColorChanged(QColor newColor)
void subGridVisibleChanged(bool visible)
void textElideModeChanged(Qt::TextElideMode elideMode)
void titleColorChanged(QColor color)
void titleFontChanged(const QFont &font)
void titleTextChanged(const QString &title)
void titleVisibleChanged(bool visible)
void update()
void visibleChanged(bool visible)

상세 설명

각 시계열은 하나의 가로축과 하나의 세로축에만 바인딩할 수 있습니다.

축선, 제목, 레이블, 격자선 등 다양한 축 요소의 속성과 표시 여부를 개별적으로 제어할 수 있습니다.

멤버 유형 문서

enum class QAbstractAxis::AxisType

이 열거형 유형은 축 객체의 유형을 지정합니다.

상수상수 값
QAbstractAxis::AxisType::Value0
QAbstractAxis::AxisType::BarCategory1
QAbstractAxis::AxisType::DateTime2
QAbstractAxis::AxisType::LogValue (since Qt 6.12)3

속성 설명

[since 6.9] alignment : Qt::Alignment

이 속성은 축의 정렬 방향을 지정합니다.

Qt::AlignLeft, Qt::AlignRight, Qt::AlignBottom 또는 Qt::AlignTop 중 하나일 수 있습니다.

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

액세스 함수:

Qt::Alignment alignment() const
void setAlignment(Qt::Alignment alignment)

Notifier 신호:

void alignmentChanged(Qt::Alignment alignment)

color : QColor

이 속성은 주요 눈금과 축선을 그릴 때 사용되는 색상을 지정합니다.

테마가 변경되더라도 이 속성은 테마 색상을 재정의합니다.

액세스 함수:

QColor color() const
void setColor(QColor color)

알림 신호:

void colorChanged(QColor newColor)

gridVisible : bool

이 속성은 격자선의 표시 여부를 결정합니다. 기본값은 ‘ true ’입니다.

액세스 함수:

bool isGridVisible() const
void setGridVisible(bool visible = true)

알림 신호:

void gridVisibleChanged(bool visible)

labelDelegate : QQmlComponent*

이 속성은 축의 레이블로 사용되는 사용자 정의 QML 컴포넌트를 포함합니다. 이 컴포넌트는 Text 컴포넌트이거나 “속성 문자열 텍스트”를 포함해야 하며, 그래야만 이 속성에 레이블의 값이 할당됩니다.

액세스 함수:

QQmlComponent *labelDelegate() const
void setLabelDelegate(QQmlComponent *newLabelDelegate)

Notifier 신호:

void labelDelegateChanged()

labelsAngle : qreal

이 속성은 축 레이블의 각도를 도 단위로 저장합니다.

액세스 함수:

qreal labelsAngle() const
void setLabelsAngle(qreal angle)

알림 신호:

void labelsAngleChanged(qreal angle)

labelsVisible : bool

이 속성은 축 레이블이 표시되는지 여부를 결정합니다. 기본적으로 값은 ‘ true ’입니다.

액세스 함수:

bool labelsVisible() const
void setLabelsVisible(bool visible = true)

알림 신호:

void labelsVisibleChanged(bool visible)

lineVisible : bool

이 속성은 축선의 표시 여부를 결정합니다. 기본값은 ‘ true ’입니다.

액세스 함수:

bool isLineVisible() const
void setLineVisible(bool visible = true)

알림 신호:

void lineVisibleChanged(bool visible)

subColor : QColor

이 속성은 보조 눈금을 그릴 때 사용되는 색상을 지정합니다.

테마가 변경되더라도 이 속성은 테마 색상을 재정의합니다.

액세스 함수:

QColor subColor() const
void setSubColor(QColor color)

Notifier 신호:

void subColorChanged(QColor newColor)

subGridVisible : bool

이 속성은 서브그리드 선의 표시 여부를 지정합니다.

서브그리드 선을 지원하는 축에만 적용됩니다. 기본값은 ` true`입니다.

액세스 함수:

bool isSubGridVisible() const
void setSubGridVisible(bool visible = true)

알림 신호:

void subGridVisibleChanged(bool visible)

[since 6.10] textElideMode : Qt::TextElideMode

이 속성은 텍스트가 넘칠 때 생략 부호를 배치할 위치를 지정합니다.

Qt::ElideLeft, Qt::ElideRight, Qt::ElideMiddle 또는 Qt::ElideNone 중 하나를 지정할 수 있습니다. 기본값은 Qt::ElideNone 입니다.

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

액세스 함수:

Qt::TextElideMode textElideMode() const
void setTextElideMode(Qt::TextElideMode elideMode)

Notifier 시그널:

void textElideModeChanged(Qt::TextElideMode elideMode)

titleColor : QColor

이 속성은 제목 텍스트를 그릴 때 사용되는 색상을 지정합니다.

액세스 함수:

QColor titleColor() const
void setTitleColor(QColor color)

알림 신호:

void titleColorChanged(QColor color)

titleFont : QFont

이 속성은 축 제목의 글꼴을 지정합니다.

액세스 함수:

QFont titleFont() const
void setTitleFont(const QFont &font)

알림 신호:

void titleFontChanged(const QFont &font)

titleText : QString

이 속성은 축의 제목을 저장합니다.

기본값은 비어 있습니다. 축 제목은 HTML 서식을 지원합니다.

액세스 함수:

QString titleText() const
void setTitleText(const QString &title)

알림 신호:

void titleTextChanged(const QString &title)

titleVisible : bool

이 속성은 축 제목의 표시 여부를 지정합니다.

기본값은 ‘ true ’입니다.

액세스 함수:

bool isTitleVisible() const
void setTitleVisible(bool visible = true)

알림 신호:

void titleVisibleChanged(bool visible)

visible : bool

이 속성은 축의 표시 여부를 지정합니다. 기본값은 ‘ true ’입니다.

액세스 함수:

bool isVisible() const
void setVisible(bool visible = true)

알림 신호:

void visibleChanged(bool visible)

멤버 함수 설명서

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

축 객체를 삭제합니다. 축이 그래프에 추가되면 그래프 객체가 소유권을 갖게 됩니다.

void QAbstractAxis::hide()

축, 레이블 및 격자선을 보이지 않게 합니다.

void QAbstractAxis::setLineVisible(bool visible = true)

축선과 눈금이 ‘ visible ’인지 여부를 결정합니다.

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

isLineVisible()도 참조하십시오 .

void QAbstractAxis::setMax(const QVariant &max)

축에 표시되는 최대 값을 설정합니다. 실제 축 유형에 따라 ` max ` 매개변수는 적절한 값 유형으로 변환됩니다. 변환이 불가능한 경우, 이 함수 호출은 아무런 작업도 수행하지 않습니다.

void QAbstractAxis::setMin(const QVariant &min)

축에 표시되는 최소값을 설정합니다. 실제 축 유형에 따라 ` min ` 매개변수는 적절한 유형의 값으로 변환됩니다. 변환이 불가능한 경우, 이 함수 호출은 아무런 작업도 수행하지 않습니다.

void QAbstractAxis::setRange(const QVariant &min, const QVariant &max)

축에 표시될 범위를 설정합니다. 실제 축 유형에 따라 ` min ` 및 ` max ` 매개변수는 적절한 유형의 값으로 변환됩니다. 변환이 불가능한 경우, 이 함수 호출은 아무 작업도 수행하지 않습니다.

void QAbstractAxis::setTitleColor(QColor color)

color 에 제목 그리기에 사용되는 색상을 설정합니다.

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

titleColor()도 참조하십시오 .

void QAbstractAxis::setTitleFont(const QFont &font)

제목을 그릴 때 사용되는 글꼴을 ` font`로 설정합니다.

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

titleFont()도 참조하십시오 .

void QAbstractAxis::setVisible(bool visible = true)

축, 레이블 및 격자선의 표시 여부를 ` visible`로 설정합니다.

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

isVisible()도 참조하십시오 .

void QAbstractAxis::show()

축, 레이블 및 격자선을 표시합니다.

QColor QAbstractAxis::titleColor() const

제목을 그리는 데 사용되는 색상을 반환합니다.

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

setTitleColor()도 참조하십시오 .

QFont QAbstractAxis::titleFont() const

제목 그리기에 사용된 글꼴을 반환합니다.

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

setTitleFont()도 참조하십시오 .

[pure virtual] QAbstractAxis::AxisType QAbstractAxis::type() const

축의 유형을 반환합니다.

[signal] void QAbstractAxis::update()

이 신호는 축을 업데이트해야 할 때 발생합니다.

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