QAbstract3DAxis Class
QAbstract3DAxis 클래스는 3D 그래프의 축을 위한 기본 클래스입니다. 더 보기...
| 헤더: | #include <QAbstract3DAxis> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Graphs) target_link_libraries(mytarget PRIVATE Qt6::Graphs) |
| qmake: | QT += graphs |
| QML에서: | Abstract3DAxis |
| 상속: | QObject |
| 상속받는 클래스: |
- 상속받은 멤버를 포함한 모든 멤버 목록
- QAbstract3DAxis는 3D용Qt Graphs C++ 클래스의 일부입니다.
공개 유형
| enum class | AxisOrientation { None, X, Y, Z } |
| enum class | AxisType { None, Category, Value } |
속성
|
|
공개 함수
| virtual | ~QAbstract3DAxis() override |
| bool | isAutoAdjustRange() const |
| bool | isScaleLabelsByCount() const |
| bool | isTitleFixed() const |
| bool | isTitleVisible() const |
| float | labelAutoAngle() const |
| qreal | labelSize() const |
| QStringList | labels() const |
| bool | labelsVisible() const |
| float | max() const |
| float | min() const |
| QAbstract3DAxis::AxisOrientation | orientation() const |
| void | setAutoAdjustRange(bool autoAdjust) |
| void | setLabelAutoAngle(float degree) |
| void | setLabelSize(qreal size) |
| void | setLabels(const QStringList &labels) |
| void | setLabelsVisible(bool visible) |
| void | setMax(float max) |
| void | setMin(float min) |
| void | setRange(float min, float max) |
| void | setScaleLabelsByCount(bool adjust) |
| void | setTitle(const QString &title) |
| void | setTitleFixed(bool fixed) |
| void | setTitleOffset(float offset) |
| void | setTitleVisible(bool visible) |
| QString | title() const |
| float | titleOffset() const |
| QAbstract3DAxis::AxisType | type() const |
신호
| void | autoAdjustRangeChanged(bool autoAdjust) |
| void | labelAutoAngleChanged(float angle) |
| void | labelSizeChanged(qreal size) |
| void | labelVisibleChanged(bool visible) |
| void | labelsChanged() |
| void | maxChanged(float value) |
| void | minChanged(float value) |
| void | orientationChanged(QAbstract3DAxis::AxisOrientation orientation) |
| void | rangeChanged(float min, float max) |
| void | scaleLabelsByCountChanged(bool adjust) |
| void | titleChanged(const QString &newTitle) |
| void | titleFixedChanged(bool fixed) |
| void | titleOffsetChanged(float offset) |
| void | titleVisibleChanged(bool visible) |
QCategory3DAxis 및 QValue3DAxis도 참조하십시오 .
멤버 유형 설명
enum class QAbstract3DAxis::AxisOrientation
축 객체의 방향.
| 상수 | 값 |
|---|---|
QAbstract3DAxis::AxisOrientation::None | 0 |
QAbstract3DAxis::AxisOrientation::X | 1 |
QAbstract3DAxis::AxisOrientation::Y | 2 |
QAbstract3DAxis::AxisOrientation::Z | 3 |
enum class QAbstract3DAxis::AxisType
축 객체의 유형.
| 상수 | 값 |
|---|---|
QAbstract3DAxis::AxisType::None | 0 |
QAbstract3DAxis::AxisType::Category | 1 |
QAbstract3DAxis::AxisType::Value | 2 |
속성 설명
autoAdjustRange : bool
이 속성은 축이 모든 데이터가 축에 들어갈 수 있도록 범위를 자동으로 조정할지 여부를 결정합니다.
액세스 함수:
| bool | isAutoAdjustRange() const |
| void | setAutoAdjustRange(bool autoAdjust) |
알림 신호:
| void | autoAdjustRangeChanged(bool autoAdjust) |
setRange(), setMin(), setMax()도 참조하십시오 .
labelAutoAngle : float
이 속성은 카메라 각도가 변경될 때 레이블이 자동으로 회전할 수 있는 최대 각도를 지정합니다.
각도는 0에서 90 사이(양쪽 끝값 포함)여야 합니다. 기본값은 0입니다. 값이 0인 경우, 축 레이블은 자동으로 회전하지 않습니다. 값이 0보다 큰 경우, 레이블은 지정된 각도 범위 내에서 카메라 방향을 향하도록 회전하려고 시도합니다.
액세스 함수:
| float | labelAutoAngle() const |
| void | setLabelAutoAngle(float degree) |
알림 신호:
| void | labelAutoAngleChanged(float angle) |
[since 6.9] labelSize : qreal
라벨의 크기
라벨의 크기입니다. 이 값의 기본값은 1.0 입니다.
이 열거형은 Qt 6.9에서 도입되었습니다.
액세스 함수:
| qreal | labelSize() const |
| void | setLabelSize(qreal size) |
Notifier 신호:
| void | labelSizeChanged(qreal size) |
scaleLabelsByCount도 참조하십시오 .
labels : QStringList
이 속성은 축의 레이블을 지정합니다.
참고: ` QValue3DAxis `에 대해 이 속성을설정해도 아무런 효과가 없습니다. 이 축은 레이블을 자동으로 생성하기 때문입니다.
액세스 함수:
| QStringList | labels() const |
| void | setLabels(const QStringList &labels) |
알림 신호:
| void | labelsChanged() |
labelsVisible : bool
이 속성은 주 그래프 뷰에서 축 레이블이 표시되는지 여부를 결정합니다.
기본값은 ` true`입니다.
액세스 함수:
| bool | labelsVisible() const |
| void | setLabelsVisible(bool visible) |
알림 신호:
| void | labelVisibleChanged(bool visible) |
max : float
이 속성은 축의 최대값을 지정합니다.
이 속성을 설정할 때, 범위가 유효한 상태를 유지하도록 필요한 경우 최소값이 조정됩니다.
참고: ` QCategory3DAxis`의 경우 , 표시할 마지막 행 또는 열의 인덱스를 지정합니다.
액세스 함수:
| float | max() const |
| void | setMax(float max) |
알림 신호:
| void | maxChanged(float value) |
min : float
이 속성은 축의 최소값을 저장합니다.
이 속성을 설정할 때, 범위가 유효한 상태를 유지하도록 필요에 따라 최대값이 조정됩니다.
참고: ` QCategory3DAxis`의 경우 , 표시할 첫 번째 행 또는 열의 인덱스를 지정합니다.
액세스 함수:
| float | min() const |
| void | setMin(float min) |
알림 신호:
| void | minChanged(float value) |
[read-only] orientation : QAbstract3DAxis::AxisOrientation
이 속성은 축의 방향을 나타냅니다.
값은 AxisOrientation 에 나열된 값 중 하나입니다.
액세스 함수:
| QAbstract3DAxis::AxisOrientation | orientation() const |
알림 신호:
| void | orientationChanged(QAbstract3DAxis::AxisOrientation orientation) |
[since 6.9] scaleLabelsByCount : bool
이 속성은 라벨의 총 개수에 따라 라벨의 크기가 자동으로 조정되는지 여부와 관계없이 적용됩니다.
이 열거형은 Qt 6.9에서 도입되었습니다.
액세스 함수:
| bool | isScaleLabelsByCount() const |
| void | setScaleLabelsByCount(bool adjust) |
알림 신호:
| void | scaleLabelsByCountChanged(bool adjust) |
labelSize()도 참조하십시오 .
title : QString
이 속성은 축의 제목을 저장합니다.
액세스 함수:
| QString | title() const |
| void | setTitle(const QString &title) |
알림 신호:
| void | titleChanged(const QString &newTitle) |
titleVisible 및 titleFixed도 참조하십시오 .
titleFixed : bool
이 속성은 축 제목의 회전 각도를 지정합니다.
false 인 경우, 기본 그래프 뷰의 축 제목은 축 레이블과 마찬가지로 카메라를 향해 회전됩니다. true 인 경우, 축 제목은 해당 축을 중심으로만 회전되며 카메라를 향해 방향을 맞추지는 않습니다. 이 속성은 labelAutoAngle 속성 값이 0인 경우 아무런 영향을 미치지 않습니다. 기본값은 true 입니다.
액세스 함수:
| bool | isTitleFixed() const |
| void | setTitleFixed(bool fixed) |
알림 신호:
| void | titleFixedChanged(bool fixed) |
관련 항목: labelAutoAngle, title 및 titleVisible.
titleOffset : float
축 상의 축 제목 위치입니다. 값은 -1.0f 과 1.0f
액세스 함수:
| float | titleOffset() const |
| void | setTitleOffset(float offset) |
알림 신호:
| void | titleOffsetChanged(float offset) |
title 및 titleFixed도 참조하십시오 .
titleVisible : bool
이 속성은 주 그래프 보기에서 축 제목이 표시되는지 여부를 결정합니다.
기본값은 ` false`입니다.
액세스 함수:
| bool | isTitleVisible() const |
| void | setTitleVisible(bool visible) |
알림 신호:
| void | titleVisibleChanged(bool visible) |
title 및 titleFixed도 참조하십시오 .
[read-only] type : const QAbstract3DAxis::AxisType
이 속성은 축의 유형을 나타냅니다.
값은 ` AxisType ` 값 중 하나입니다.
액세스 함수:
| QAbstract3DAxis::AxisType | type() const |
멤버 함수 설명서
[override virtual noexcept] QAbstract3DAxis::~QAbstract3DAxis()
QAbstract3DAxis 를 삭제합니다.
[signal] void QAbstract3DAxis::rangeChanged(float min, float max)
범위가 변경될 때, 해당 범위의 최소값과 최대값인 min 및 max 을 반환합니다.
void QAbstract3DAxis::setRange(float min, float max)
축의 값 범위를 min 에서 max 로 설정합니다. 범위를 설정할 때, 범위가 유효한 상태를 유지하도록 필요에 따라 최대값이 조정됩니다.
참고: QCategory3DAxis 의경우 , 표시할 행 또는 열의 인덱스 범위를 지정합니다.
© 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.
