QValueAxis Class
QValueAxis 클래스는 차트의 축에 값을 추가합니다. 더 보기...
| Header: | #include <QValueAxis> |
| In QML: | ValueAxis |
| Inherits: | QAbstractAxis |
| Inherited By: | |
| Status: | Deprecated |
이 클래스는 더 이상 사용되지 않습니다. 새로운 코드에서는 이 클래스를 사용하지 않을 것을 강력히 권장합니다.
공개 유형
| enum | TickType { TicksDynamic, TicksFixed } |
속성
|
|
공개 함수
| QValueAxis(QObject *parent = nullptr) | |
| virtual | ~QValueAxis() |
| QString | labelFormat() const |
| qreal | max() const |
| qreal | min() const |
| int | minorTickCount() const |
| void | setLabelFormat(const QString &format) |
| void | setMax(qreal max) |
| void | setMin(qreal min) |
| void | setMinorTickCount(int count) |
| void | setRange(qreal min, qreal max) |
| void | setTickAnchor(qreal anchor) |
| void | setTickCount(int count) |
| void | setTickInterval(qreal insterval) |
| void | setTickType(QValueAxis::TickType type) |
| qreal | tickAnchor() const |
| int | tickCount() const |
| qreal | tickInterval() const |
| QValueAxis::TickType | tickType() const |
재구현된 공용 함수
| virtual QAbstractAxis::AxisType | type() const override |
공개 슬롯
| void | applyNiceNumbers() |
신호
| void | labelFormatChanged(const QString &format) |
| void | maxChanged(qreal max) |
| void | minChanged(qreal min) |
| void | minorTickCountChanged(int minorTickCount) |
| void | rangeChanged(qreal min, qreal max) |
| void | tickAnchorChanged(qreal anchor) |
| void | tickCountChanged(int tickCount) |
| void | tickIntervalChanged(qreal interval) |
| void | tickTypeChanged(QValueAxis::TickType type) |
상세 설명
값 축은 눈금, 격자선 및 음영이 포함된 축선을 표시하도록 설정할 수 있습니다. 축상의 값은 눈금 위치에 그려집니다.
다음 예제 코드는 QValueAxis 클래스의 사용 방법을 보여줍니다:
QChartView *chartView = new QChartView;
QLineSeries *series = new QLineSeries;
// ...
chartView->chart()->addSeries(series);
QValueAxis *axisX = new QValueAxis;
axisX->setRange(10, 20.5);
axisX->setTickCount(10);
axisX->setLabelFormat("%.2f");
chartView->chart()->setAxisX(axisX, series);멤버 유형 설명서
enum QValueAxis::TickType
이 열거형은 축에 틱과 레이블이 어떻게 배치되는지를 설명합니다.
| 상수 | 값 | 설명 |
|---|---|---|
QValueAxis::TicksDynamic | 0 | 틱은 tickAnchor 및 tickInterval 값에 따라 배치됩니다. |
QValueAxis::TicksFixed | 1 | 틱은 축 범위 전체에 걸쳐 균등하게 배치됩니다. tickCount 값은 틱의 수를 지정합니다. |
속성 설명
labelFormat : QString
이 속성은 축의 레이블 형식을 저장합니다.
이 형식 문자열은 표준 C++ 라이브러리의 ` printf() `에서 제공하는 다음 변환 지정자, 길이 수정자 및 플래그를 지원합니다: d, i, o, x, X, f, F, e, E, g, G, c.
QChart::localizeNumbers 가 ` true`인 경우, 지원되는 지정자는 d, e, E, f, g, G 및 i로 제한됩니다. 또한, 정밀도 수정자만 지원됩니다. 나머지 서식 지정은 응용 프로그램의 기본 ` QLocale `에서 가져옵니다.
액세스 함수:
| QString | labelFormat() const |
| void | setLabelFormat(const QString &format) |
알림 신호:
| void | labelFormatChanged(const QString &format) |
QString::asprintf()도 참조하십시오 .
max : qreal
이 속성은 축의 최대값을 지정합니다.
이 속성을 설정할 때, 범위가 유효한 상태를 유지하도록 필요한 경우 최소값이 조정됩니다.
액세스 함수:
| qreal | max() const |
| void | setMax(qreal max) |
알림 신호:
| void | maxChanged(qreal max) |
min : qreal
이 속성은 축의 최소값을 저장합니다.
이 속성을 설정할 때, 범위가 유효한 상태를 유지하도록 필요에 따라 최대값이 조정됩니다.
액세스 함수:
| qreal | min() const |
| void | setMin(qreal min) |
알림 신호:
| void | minChanged(qreal min) |
minorTickCount : int
이 속성은 축에 표시되는 보조 눈금의 개수를 지정합니다. 이는 차트의 주요 눈금 사이에 그려지는 격자선의 개수를 나타냅니다. 보조 눈금에는 레이블이 표시되지 않습니다. 기본값은 0입니다.
액세스 함수:
| int | minorTickCount() const |
| void | setMinorTickCount(int count) |
알림 신호:
| void | minorTickCountChanged(int minorTickCount) |
tickAnchor : qreal
이 속성은 동적으로 배치되는 눈금과 레이블이 시작되는 기준값을 지정합니다.
액세스 함수:
| qreal | tickAnchor() const |
| void | setTickAnchor(qreal anchor) |
알림 신호:
| void | tickAnchorChanged(qreal anchor) |
tickCount : int
이 속성은 축에 표시되는 눈금 개수를 지정합니다. 이는 차트에 그려지는 격자선의 개수를 나타냅니다. 기본값은 5이며, 이 값은 2보다 작을 수 없습니다.
액세스 함수:
| int | tickCount() const |
| void | setTickCount(int count) |
알림 신호:
| void | tickCountChanged(int tickCount) |
tickInterval : qreal
이 속성은 동적으로 배치된 눈금과 레이블 사이의 간격을 지정합니다.
액세스 함수:
| qreal | tickInterval() const |
| void | setTickInterval(qreal insterval) |
알림 신호:
| void | tickIntervalChanged(qreal interval) |
tickType : TickType
이 속성은 티크와 레이블의 배치 방식을 지정합니다.
액세스 함수:
| QValueAxis::TickType | tickType() const |
| void | setTickType(QValueAxis::TickType type) |
알림 신호:
| void | tickTypeChanged(QValueAxis::TickType type) |
멤버 함수 설명서
[explicit] QValueAxis::QValueAxis(QObject *parent = nullptr)
parent 의 자식인 축 객체를 생성합니다.
[virtual noexcept] QValueAxis::~QValueAxis()
객체를 삭제합니다.
[slot] void QValueAxis::applyNiceNumbers()
축의 현재 범위와 눈금 개수를 보기 좋게 조정합니다. 이 알고리즘은 1*10^n, 2*10^n 또는 5*10^n의 형태로 표현될 수 있는 수를 ‘보기 좋은 수’로 간주합니다. 이러한 수들은 눈금 간격을 설정하는 데 사용됩니다.
setRange() 및 setTickCount()도 참조하십시오 .
[signal] void QValueAxis::labelFormatChanged(const QString &format)
이 신호는 축 레이블의 format 속성이 변경될 때 발생합니다.
참고: 속성 ` labelFormat`에 대한알림 신호입니다.
[signal] void QValueAxis::maxChanged(qreal max)
max 로 지정된 축의 최대값이 변경되면 이 신호가 발생합니다.
참고: 속성 max 에 대한알림 신호입니다.
[signal] void QValueAxis::minChanged(qreal min)
min 로 지정된 축의 최소값이 변경되면 이 신호가 발생합니다.
참고: 속성 min 에 대한알림 신호입니다.
[signal] void QValueAxis::minorTickCountChanged(int minorTickCount)
minorTickCount 로 지정된 축의 작은 눈금 개수가 변경될 때 이 신호가 발생합니다.
참고: 속성 ` minorTickCount`에 대한알림 신호입니다.
[signal] void QValueAxis::rangeChanged(qreal min, qreal max)
이 신호는 ` min ` 및 ` max`로 지정된 축의 최소값 또는 최대값이 변경될 때 발생합니다.
void QValueAxis::setRange(qreal min, qreal max)
축의 범위를 min 에서 max 로 설정합니다. min 가 max 보다 크면, 이 함수는 아무런 변경도 가하지 않고 반환됩니다.
[signal] void QValueAxis::tickCountChanged(int tickCount)
tickCount 로 지정된 축의 눈금 개수가 변경되면 이 신호가 발생합니다.
참고: 속성 ` tickCount`에 대한알림 신호입니다.
[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.
