Value3DAxis QML Type
그래프의 축을 조작합니다. 더 보기...
| Import Statement: | import QtGraphs |
| In C++: | QValue3DAxis |
| Inherits: |
- 상속된 멤버를 포함한 모든 멤버 목록
- Value3DAxis는 3D용Qt Graphs QML 유형의 일부입니다.
속성
- autoAdjustRange : bool
- formatter : Value3DAxisFormatter
- labelAutoAngle : real
- labelFormat : string
- labelSize : real
(since 6.9) - labels : list
- labelsVisible : bool
- max : real
- min : real
- orientation : Abstract3DAxis.AxisOrientation
- reversed : bool
- scaleLabelsByCount : bool
(since 6.9) - segmentCount : qsizetype
- subSegmentCount : qsizetype
- title : string
- titleFixed : bool
- titleOffset : real
- titleVisible : bool
- type : Abstract3DAxis.AxisType
신호
- autoAdjustRangeChanged(bool autoAdjust)
- formatterChanged(Value3DAxisFormatter formatter)
- labelAutoAngleChanged(real angle)
- labelFormatChanged(string format)
- labelSizeChanged(real size)
- labelVisibilityChanged(bool visible)
- labelsChanged()
- maxChanged(real value)
- minChanged(real value)
- orientationChanged(AxisOrientation orientation)
- rangeChanged(real min, real max)
- reversedChanged(bool enable)
- scaleLabelsByCountChanged(bool adjust)
- segmentCountChanged(qsizetype count)
- subSegmentCountChanged(qsizetype count)
- titleChanged(string newTitle)
- titleFixedChanged(bool fixed)
- titleOffsetChanged(real offset)
- titleVisibilityChanged(bool visible)
상세 설명
이 유형은 값의 범위와 해당 범위를 나눌 세그먼트 및 하위 세그먼트 수를 지정할 수 있는 축을 제공합니다.
속성 설명
autoAdjustRange : bool
축이 모든 데이터가 들어갈 수 있도록 범위를 자동으로 조정할지 여부를 지정합니다.
formatter : Value3DAxisFormatter
사용할 축 서식 지정기입니다. 새로운 서식 지정기를 설정하면 기존 서식 지정기는 모두 삭제됩니다.
labelAutoAngle : real
카메라 각도가 변경될 때 레이블이 자동으로 회전할 수 있는 최대 각도입니다. 각도는 0에서 90까지(0 및 90 포함) 설정할 수 있습니다. 기본값은 0입니다. 값이 0인 경우, 축 레이블은 자동으로 회전하지 않습니다. 값이 0보다 큰 경우, 레이블은 지정된 각도 범위 내에서 카메라를 향하도록 방향을 조정합니다.
labelFormat : string
이 축의 레이블에 사용할 레이블 형식입니다.
이 형식 문자열은 표준 C++ 라이브러리의 ` printf() `에서 제공하는 다음 변환 지정자, 길이 수정자 및 플래그를 지원합니다: d, i, o, x, X, f, F, e, E, g, G, c.
GraphsItem3D::locale 가 "C" 이외의 값인 경우, 지원되는 지정자는 d, e, E, f, g, G 및 i로 제한됩니다. 또한, 정밀도 수정자만 지원됩니다. 나머지 서식 지정은 애플리케이션의 기본 Locale 에서 가져옵니다.
GraphsItem3D::locale도 참조하십시오 .
labelSize : real [since 6.9]
라벨의 크기입니다. 이 값의 기본값은 ` 1.0`입니다.
이 속성은 Qt 6.9에서 도입되었습니다.
scaleLabelsByCount도 참조하십시오 .
labels : list
축의 레이블입니다.
참고: Value3DAxis 의 경우 레이블이 자동으로 생성되므로 이 속성을설정해도 아무런 효과가 없습니다.
labelsVisible : bool
주 그래프 보기에서 축 레이블을 표시할지 여부를 지정합니다.
기본값은 ' true'입니다.
max : real
축의 최대값입니다. 이 속성을 설정하면, 범위가 유효한 상태를 유지하도록 필요에 따라 최소값이 조정됩니다.
min : real
축의 최소값입니다. 이 속성을 설정하면 범위가 유효한 상태를 유지하도록 필요에 따라 최대값이 조정됩니다.
orientation : Abstract3DAxis.AxisOrientation [read-only]
축의 방향.
reversed : bool
true 인 경우, 축이 반대로 표시됩니다. 즉, 그래프가 렌더링될 때 최소값과 최대값의 위치가 바뀝니다. 이 속성은 축의 실제 최소값과 최대값에는 영향을 미치지 않습니다.
scaleLabelsByCount : bool [since 6.9]
라벨의 총 개수에 따라 라벨 크기가 자동으로 조정되는지 여부.
이 속성은 Qt 6.9에서 도입되었습니다.
labelSize도 참조하십시오 .
segmentCount : qsizetype
축의 세그먼트 수입니다. 이는 그려지는 레이블의 개수를 나타냅니다. 그려질 격자선의 수는 다음 공식으로 계산됩니다: segments * subsegments + 1. 사전 설정된 기본값은 5 입니다. 이 값은 1 보다 작을 수 없습니다.
subSegmentCount : qsizetype
축의 각 세그먼트 내에 포함된 하위 세그먼트의 수입니다. 각 세그먼트 외에도 각 하위 세그먼트 사이에 격자선이 그려집니다. 사전 설정된 기본값은 ` 1`입니다. 이 값은 ` 1`보다 작을 수 없습니다.
title : string
축의 제목입니다.
titleVisible 및 titleFixed도 참조하십시오 .
titleFixed : bool
축 제목의 회전.
false 인 경우, 기본 그래프 뷰의 축 제목은 축 레이블과 마찬가지로 카메라 방향으로 회전됩니다. true 인 경우, 축 제목은 해당 축을 중심으로만 회전되며 카메라 방향으로 향하지는 않습니다. 이 속성은 labelAutoAngle 속성의 값이 0인 경우 아무런 효과가 없습니다. 기본값은 true 입니다.
labelAutoAngle, title 및 titleVisible도 참조하십시오 .
titleOffset : real
축상의 축 제목 위치입니다. 값은 -1.0f 과 1.0f
기본값은 0 입니다.
title 및 titleVisible도 참조하십시오 .
titleVisible : bool
주 그래프 보기에서 축 제목이 표시될지 여부를 지정합니다.
기본값은 false 입니다.
title 및 titleFixed도 참조하십시오 .
type : Abstract3DAxis.AxisType [read-only]
축의 유형.
신호 문서
autoAdjustRangeChanged(bool autoAdjust)
이 신호는 autoAdjustRange 속성의 값이 autoAdjust 로 변경될 때 발생합니다.
참고: 해당 핸들러는 onAutoAdjustRangeChanged 입니다.
formatterChanged(Value3DAxisFormatter formatter)
이 신호는 formatter 이 formatter 로 변경될 때 발생합니다.
참고: 해당 핸들러는 onFormatterChanged 입니다.
labelAutoAngleChanged(real angle)
이 신호는 레이블의 회전 각도가 angle 로 변경될 때 발생합니다.
참고: 해당 핸들러는 onLabelAutoAngleChanged 입니다.
labelFormatChanged(string format)
이 신호는 labelFormat 이 format 로 변경될 때 발생합니다.
참고: 이에 해당하는핸들러는 onLabelFormatChanged 입니다.
labelSizeChanged(real size)
이 신호는 labelSize 속성의 값이 size 로 변경될 때 발생합니다.
참고: 이에 대응하는핸들러는 onLabelSizeChanged 입니다.
labelVisibilityChanged(bool visible)
이 신호는 레이블의 표시 상태가 ‘ visible ’로 변경될 때 발생합니다.
참고: 이에 대응하는핸들러는 onLabelVisibilityChanged 입니다.
labelsChanged()
이 신호는 축 레이블이 변경될 때 발생합니다.
참고: 이에 해당하는핸들러는 onLabelsChanged 입니다.
maxChanged(real value)
이 신호는 축의 최대값이 value 로 변경될 때 발생합니다.
참고: 해당 핸들러는 onMaxChanged 입니다.
minChanged(real value)
이 신호는 축의 최소값이 value 로 변경될 때 발생합니다.
참고: 해당 핸들러는 onMinChanged 입니다.
orientationChanged(AxisOrientation orientation)
이 신호는 축 방향이 orientation 로 변경될 때 발생합니다.
참고: 이에 해당하는핸들러는 onOrientationChanged 입니다.
rangeChanged(real min, real max)
이 신호는 축 범위가 변경될 때 발생합니다. min 및 max 는 새로운 범위의 최소값과 최대값입니다.
참고: 해당 핸들러는 onRangeChanged 입니다.
reversedChanged(bool enable)
이 신호는 reversed 이 enable 로 변경될 때 발생합니다.
참고: 이에 해당하는핸들러는 onReversedChanged 입니다.
scaleLabelsByCountChanged(bool adjust)
이 신호는 scaleLabelsByCount 속성의 값이 adjust 로 변경될 때 발생합니다.
참고: 이에 해당하는핸들러는 onScaleLabelsByCountChanged 입니다.
segmentCountChanged(qsizetype count)
이 신호는 segmentCount 이 count 로 변경될 때 발생합니다.
참고: 이에 해당하는핸들러는 onSegmentCountChanged 입니다.
subSegmentCountChanged(qsizetype count)
이 신호는 subSegmentCount 이 count 으로 변경될 때 발생합니다.
참고: 이에 해당하는핸들러는 onSubSegmentCountChanged 입니다.
titleChanged(string newTitle)
이 신호는 title 이 newTitle 으로 변경될 때 발생합니다.
참고: 이에 해당하는핸들러는 onTitleChanged 입니다.
titleFixedChanged(bool fixed)
이 신호는 titleFixed 속성의 값이 fixed 로 변경될 때 발생합니다.
참고: 해당 핸들러는 onTitleFixedChanged 입니다.
titleOffsetChanged(real offset)
이 신호는 ` titleOffset ` 속성의 값이 ` offset`로 변경될 때 발생합니다.
참고: 해당 핸들러는 onTitleOffsetChanged 입니다.
titleVisibilityChanged(bool visible)
이 신호는 제목의 표시 상태가 ‘ visible ’로 변경될 때 발생합니다.
참고: 이에 대응하는핸들러는 onTitleVisibilityChanged 입니다.
© 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.