QValueAxis Class
QValueAxis 클래스는 차트의 축에 값을 추가합니다. 더 보기...
| Header: | #include <QValueAxis> |
| In QML: | ValueAxis |
| Inherits: | QAbstractAxis |
| Inherited By: |
공용 유형
| 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
이 열거형은 축에 틱과 레이블을 배치하는 방법을 설명합니다.
| Constant | 값 | 설명 |
|---|---|---|
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.
축의 타입을 반환합니다.
© 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.
