이 페이지에서

QValueAxis Class

QValueAxis 클래스는 그래프의 축에 값을 추가합니다. 더 보기...

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

속성

공개 함수

QValueAxis(QObject *parent = nullptr)
virtual ~QValueAxis() override
int labelDecimals() const
QString labelFormat() const
QString labelPostFormat() const
qreal max() const
qreal min() const
qreal pan() const
void setLabelDecimals(int decimals)
void setLabelFormat(const QString &format)
void setLabelPostFormat(const QString &format)
void setMax(qreal max)
void setMin(qreal min)
void setPan(qreal pan)
void setRange(qreal min, qreal max)
void setSubTickCount(qsizetype count)
void setTickAnchor(qreal anchor)
void setTickInterval(qreal interval)
void setZoom(qreal zoom)
qsizetype subTickCount() const
qreal tickAnchor() const
qreal tickInterval() const
qreal visualMax() const
qreal visualMin() const
qreal zoom() const

재구현된 공용 함수

virtual QAbstractAxis::AxisType type() const override

신호

void labelDecimalsChanged(int decimals)
void labelFormatChanged(const QString &format)
void labelPostFormatChanged(const QString &format)
void maxChanged(qreal max)
void minChanged(qreal min)
void panChanged(qreal pan)
void subTickCountChanged(qsizetype subTickCount)
void tickAnchorChanged(qreal tickAnchor)
void tickIntervalChanged(qreal tickInterval)
void visualMaxChanged(qreal newVisualMax)
void visualMinChanged(qreal newVisualMin)
void zoomChanged(qreal zoom)

상세 설명

값 축은 눈금, 격자선 및 음영이 포함된 축선을 표시하도록 설정할 수 있습니다. 축의 값은 눈금 위치에 그려집니다.

속성 설명

labelDecimals : int

이 속성은 레이블을 표시할 때 사용되는 소수점 자리 수를 지정합니다. -1로 설정하면 값의 범위에 따라 소수점 자리가 자동으로 조정됩니다. 기본값은 -1입니다.

액세스 함수:

int labelDecimals() const
void setLabelDecimals(int decimals)

알림 신호:

void labelDecimalsChanged(int decimals)

labelFormat : QString

이 속성은 축의 레이블 형식을 저장합니다.

이 서식 문자열은 표준 C++ 라이브러리의 ` printf() `에서 제공하는 다음 변환 지정자, 길이 수정자 및 플래그를 지원합니다: d, i, o, x, X, f, F, e, E, g, G, c. 그런 다음 서식이 지정된 문자열은 ` QValueAxis::labelPostFormat`를 거칩니다.

기본값은 비어 있으며, 이 경우 'f' 형식이 사용됩니다.

액세스 함수:

QString labelFormat() const
void setLabelFormat(const QString &format)

알림 신호:

void labelFormatChanged(const QString &format)

QString::asprintf()도 참조하십시오 .

[since 6.12] labelPostFormat : QString

이 속성은 축의 레이블 게시 형식을 지정합니다.

레이블은 먼저 값의 서식을 지정하기 위해 ` QValueAxis::labelFormat `를 거친 후, 이 속성을 거칩니다.

기본값은 "%1"입니다.

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

액세스 함수:

QString labelPostFormat() const
void setLabelPostFormat(const QString &format)

알림 신호:

void labelPostFormatChanged(const QString &format)

QString::arg()도 참조하십시오 .

max : qreal

이 속성은 축의 최대값을 지정합니다.

이 속성을 설정할 때, 범위가 유효한 상태를 유지하도록 필요한 경우 최소값이 조정됩니다. 기본값은 10.0입니다.

액세스 함수:

qreal max() const
void setMax(qreal max)

알림 신호:

void maxChanged(qreal max)

min : qreal

이 속성은 축의 최소값을 지정합니다.

이 속성을 설정하면, 범위가 유효한 상태를 유지하도록 필요에 따라 최대값이 조정됩니다. 기본값은 0.0입니다.

액세스 함수:

qreal min() const
void setMin(qreal min)

알림 신호:

void minChanged(qreal min)

[since 6.9] pan : qreal

이 속성은 축의 팬 값을 저장합니다.

팬 값은 그리드 및 레이블의 간격에 영향을 주지 않고 축의 중심을 이동시킵니다. 기본값은 0입니다.

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

액세스 함수:

qreal pan() const
void setPan(qreal pan)

Notifier 신호:

void panChanged(qreal pan)

subTickCount : qsizetype

이 속성은 축에 표시될 세분 눈금의 개수를 지정합니다. 이는 그래프의 주요 눈금선 사이에 몇 개의 세분 눈금이 그려지는지를 나타냅니다. 세분 눈금에는 레이블이 표시되지 않습니다. 기본값은 0입니다.

액세스 함수:

qsizetype subTickCount() const
void setSubTickCount(qsizetype count)

알림 신호:

void subTickCountChanged(qsizetype subTickCount)

tickAnchor : qreal

이 속성은 동적으로 배치되는 눈금과 레이블이 시작되는 기준값을 저장합니다. 기본값은 0입니다.

액세스 함수:

qreal tickAnchor() const
void setTickAnchor(qreal anchor)

알림 신호:

void tickAnchorChanged(qreal tickAnchor)

tickInterval : qreal

이 속성은 동적으로 배치된 눈금과 레이블 간의 간격을 지정합니다. 기본값은 0이며, 이는 최소 및 최대 범위를 기준으로 간격이 자동으로 계산됨을 의미합니다.

액세스 함수:

qreal tickInterval() const
void setTickInterval(qreal interval)

알림 신호:

void tickIntervalChanged(qreal tickInterval)

[read-only, since 6.11] visualMax : qreal

이 속성은 축의 시각적 최대값을 저장합니다.

이 속성은 축이 이동되거나 확대/축소되었을 때 축의 시각적 최대값을 저장합니다. 기본값은 QValueAxis::max

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

액세스 함수:

qreal visualMax() const

알림 신호:

void visualMaxChanged(qreal newVisualMax)

[read-only, since 6.11] visualMin : qreal

이 속성은 축의 시각적 최소값을 저장합니다.

이 속성은 축이 이동되거나 확대/축소되었을 때의 시각적 최소 축 값을 저장합니다. 기본값은 QValueAxis::min

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

액세스 함수:

qreal visualMin() const

알림 신호:

void visualMinChanged(qreal newVisualMin)

[since 6.9] zoom : qreal

이 속성은 축의 확대/축소 값을 저장합니다.

줌 값은 격자 간격과 레이블에 영향을 주지 않으면서 축과 그에 따른 그래프를 확대하거나 축소합니다. 기본값은 1입니다.

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

액세스 함수:

qreal zoom() const
void setZoom(qreal zoom)

알림 신호:

void zoomChanged(qreal zoom)

멤버 함수 문서

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

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

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

객체를 삭제합니다.

void QValueAxis::setRange(qreal min, qreal max)

축의 범위를 min 에서 max 로 설정합니다. min 가 max 보다 크면, 이 함수는 아무런 변경도 가하지 않고 반환됩니다.

[override virtual] QAbstractAxis::AxisType QValueAxis::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.