이 페이지에서

QValue3DAxis Class

QValue3DAxis 클래스는 그래프의 축을 조작합니다. 더 보기...

헤더: #include <QValue3DAxis>
CMake: find_package(Qt6 REQUIRED COMPONENTS Graphs)
target_link_libraries(mytarget PRIVATE Qt6::Graphs)
qmake: QT += graphs
QML에서: Value3DAxis
상속: QAbstract3DAxis

속성

공개 함수

QValue3DAxis(QObject *parent = nullptr)
virtual ~QValue3DAxis() override
QValue3DAxisFormatter *formatter() const
QString labelFormat() const
bool reversed() const
qsizetype segmentCount() const
void setFormatter(QValue3DAxisFormatter *formatter)
void setLabelFormat(const QString &format)
void setReversed(bool enable)
void setSegmentCount(qsizetype count)
void setSubSegmentCount(qsizetype count)
qsizetype subSegmentCount() const

신호

void formatterChanged(QValue3DAxisFormatter *formatter)
void labelFormatChanged(const QString &format)
void reversedChanged(bool enable)
void segmentCountChanged(qsizetype count)
void subSegmentCountChanged(qsizetype count)

상세 설명

값 축에는 값의 범위와, 해당 범위를 나눌 세그먼트 및 하위 세그먼트의 개수를 지정할 수 있습니다.

각 세그먼트 사이에는 레이블이 그려지고, 각 세그먼트와 각 하위 세그먼트 사이에는 격자선이 그려집니다.

참고: 표시된경우 , 세그먼트가 항상 하나 이상 존재하므로 범위의 최소값과 최대값을 나타내는 그리드 선과 레이블이 항상 두 개 이상 표시됩니다.

속성 설명서

formatter : QValue3DAxisFormatter*

이 속성은 사용할 축 서식 지정기를 저장합니다.

새로운 포맷터가 설정되면 기존 포맷터는 모두 삭제됩니다.

액세스 함수:

QValue3DAxisFormatter *formatter() const
void setFormatter(QValue3DAxisFormatter *formatter)

알림 신호:

void formatterChanged(QValue3DAxisFormatter *formatter)

labelFormat : QString

이 속성은 이 축의 레이블에 사용될 레이블 형식을 지정합니다.

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

Q3DGraphsWidgetItem::locale 가 "C" 이외의 값인 경우, 지원되는 지정자는 d, e, E, f, g, G 및 i로 제한됩니다. 또한, 정밀도 수정자만 지원됩니다. 나머지 서식 설정은 애플리케이션의 기본 QLocale 에서 가져옵니다.

사용 예:

axis->setLabelFormat("%.2f mm");

액세스 함수:

QString labelFormat() const
void setLabelFormat(const QString &format)

알림 신호:

void labelFormatChanged(const QString &format)

formatter 및 Q3DGraphsWidgetItem::locale도 참조하십시오 .

reversed : bool

이 속성은 축이 역순으로 렌더링되는지 여부를 결정합니다.

true 인 경우, 축이 역순으로 렌더링되며, 이는 그래프가 렌더링될 때 최소값과 최대값의 위치가 바뀜을 의미합니다. 이 속성은 축의 실제 최소값과 최대값에는 영향을 미치지 않습니다.

액세스 함수:

bool reversed() const
void setReversed(bool enable)

알림 신호:

void reversedChanged(bool enable)

segmentCount : qsizetype

이 속성은 축에 표시될 세그먼트의 수를 지정합니다.

이는 그려지는 레이블의 개수를 나타냅니다. 그려질 격자선의 개수는 다음 공식으로 계산됩니다: segments * subsegments + 1. 사전 설정된 기본값은 5 입니다. 이 값은 1 보다 작을 수 없습니다.

액세스 함수:

qsizetype segmentCount() const
void setSegmentCount(qsizetype count)

알림 신호:

void segmentCountChanged(qsizetype count)

setSubSegmentCount()도 참조하십시오 .

subSegmentCount : qsizetype

이 속성은 축상의 각 세그먼트 내에 포함된 하위 세그먼트의 개수를 나타냅니다.

각 세그먼트 외에도 각 하위 세그먼트 사이에 격자선이 그려집니다. 사전 설정된 기본값은 1 입니다. 이 값은 1 보다 작을 수 없습니다.

액세스 함수:

qsizetype subSegmentCount() const
void setSubSegmentCount(qsizetype count)

알림 신호:

void subSegmentCountChanged(qsizetype count)

setSegmentCount()도 참조하십시오 .

멤버 함수 문서

[explicit] QValue3DAxis::QValue3DAxis(QObject *parent = nullptr)

주어진 ` parent`를 사용하여 `QValue3DAxis`를 생성합니다.

[override virtual noexcept] QValue3DAxis::~QValue3DAxis()

QValue3DAxis 를 삭제합니다.

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