이 페이지에서

ValueAxis QML Type

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

Import Statement: import QtGraphs
In C++: QValueAxis
Inherits:

AbstractAxis

속성

신호

상세 설명

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

다음 예제 코드는 ValueAxis 유형의 사용 방법을 보여줍니다:

GraphsView {
    axisX: ValueAxis {
        max: 10
        tickInterval: 1
    }
    axisY: ValueAxis {
        min -20
        max: 40
    }
    LineSeries {
        // Add a few XYPoint data...
    }
}

속성 설명

labelDecimals : int

라벨을 표시할 때 사용하는 소수점 자리 수입니다. -1로 설정하면 값의 범위에 따라 소수점 자릿수가 자동으로 조정됩니다. 기본값은 -1입니다.

labelFormat : string

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

기본값은 빈 문자열이며, 이 경우 'f' 서식이 사용됩니다.

ValueAxis {
    titleText: "Temperature °C"
    labelFormat: "%.2f"
    labelPostFormat: "%1 °C"
    // Results in "2.50 °C"
}

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

labelPostFormat : string [since 6.12]

라벨은 먼저 ValueAxis::labelFormat 를 거쳐 값의 서식을 조정한 다음, 이 과정을 거칩니다.

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

ValueAxis {
    titleText: "Temperature °C"
    labelFormat: "%.2f"
    labelPostFormat: "%1 °C"
    // Results in "2.50 °C"
}

이 속성은 Qt 6.12에서 도입되었습니다.

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

max : real

축의 최대값입니다.

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

min : real

축의 최소값입니다.

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

pan : real [since 6.9]

축의 팬 값입니다.

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

이 속성은 Qt 6.9에서 도입되었습니다.

subTickCount : int

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

tickAnchor : real

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

tickInterval : real

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

visualMax : real [read-only, since 6.11]

축의 시각적 최대값입니다.

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

이 속성은 Qt 6.11에서 도입되었습니다.

visualMin : real [read-only, since 6.11]

축의 시각적 최소값입니다.

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

이 속성은 Qt 6.11에서 도입되었습니다.

zoom : real [since 6.9]

축의 확대/축소 값입니다.

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

이 속성은 Qt 6.9에서 도입되었습니다.

신호 문서

labelDecimalsChanged(int decimals)

이 신호는 축 레이블의 소수점 자리 수가 decimals 로 변경될 때 발생합니다.

참고: 해당 핸들러는 onLabelDecimalsChanged 입니다.

labelFormatChanged(string format)

축 레이블의 형식이 format 로 변경될 때 이 신호가 발생합니다.

참고: 이에 대응하는핸들러는 onLabelFormatChanged 입니다.

[since 6.12] labelPostFormatChanged(string format)

축 레이블의 포스트 포맷이 format 로 변경될 때 이 신호가 발생합니다.

참고: 해당 핸들러는 onLabelPostFormatChanged 입니다.

이 신호는 Qt 6.12에서 도입되었습니다.

maxChanged(real max)

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

참고: 해당 핸들러는 onMaxChanged 입니다.

minChanged(real min)

이 신호는 축의 최소값이 min 로 변경될 때 발생합니다.

참고: 해당 핸들러는 onMinChanged 입니다.

rangeChanged(real min, real max)

이 신호는 축의 최소값 또는 최대값이 각각 min 및 max 로 변경될 때 발생합니다.

참고: 해당 핸들러는 onRangeChanged 입니다.

subTickCountChanged(int subTickCount)

subTickCount 로 지정된 축의 서브틱 수가 변경되면 이 신호가 발생합니다.

참고: 해당 핸들러는 onSubTickCountChanged 입니다.

tickAnchorChanged(real tickAnchor)

이 신호는 틱 고정값이 tickAnchor 로 변경될 때 발생합니다.

참고: 해당 핸들러는 onTickAnchorChanged 입니다.

tickIntervalChanged(real tickInterval)

이 신호는 틱 간격 값이 tickInterval 로 변경될 때 발생합니다.

참고: 해당 핸들러는 onTickIntervalChanged 입니다.

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