QValue3DAxisFormatter Class

QValue3DAxisFormatter 클래스는 3D 값 축 포맷터를 위한 베이스 클래스입니다. 더 보기...

Header: #include <QValue3DAxisFormatter>
CMake: find_package(Qt6 REQUIRED COMPONENTS Graphs)
target_link_libraries(mytarget PRIVATE Qt6::Graphs)
qmake: QT += graphs
QML에서: Value3DAxisFormatter
상속합니다: QObject
상속 대상:

QLogValue3DAxisFormatter

공용 함수

QValue3DAxisFormatter(QObject *parent = nullptr)
virtual ~QValue3DAxisFormatter() override

보호 함수

bool allowNegatives() const
bool allowZero() const
QValue3DAxis *axis() const
virtual QValue3DAxisFormatter *createNewInstance() const
QList<float> gridPositions() &&
const QList<float> &gridPositions() const &
QList<float> labelPositions() &&
const QList<float> &labelPositions() const &
QStringList labelStrings() &&
const QStringList &labelStrings() const &
QLocale locale() const
void markDirty(bool labelsChange = false)
virtual void populateCopy(QValue3DAxisFormatter &copy)
virtual float positionAt(float value) const
virtual void recalculate()
void setAllowNegatives(bool allow)
void setAllowZero(bool allow)
void setGridPoitions(QList<float> gridPositions)
void setLabelStrings(QStringList labelStrings)
void setLocale(const QLocale &locale)
void setSubGridPositions(QList<float> subGridPositions)
void setlabelPositions(QList<float> labelPositions)
virtual QString stringForValue(qreal value, const QString &format)
QList<float> subGridPositions() &&
const QList<float> &subGridPositions() const &
virtual float valueAt(float position) const

상세 설명

이 클래스는 선형 값 3D 축에 대한 포맷 규칙을 제공합니다. 사용자 정의 값 축을 구현하려면 이 클래스를 서브클래스화하세요.

베이스 클래스에는 생성자와 소멸자 외에 공용 API가 없습니다. 내부적으로만 사용하도록 되어 있습니다. 그러나 서브클래스는 필요에 따라 공용 속성을 구현할 수 있습니다.

QValue3DAxisQLogValue3DAxisFormatter참조하세요 .

멤버 함수 문서

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

선택적 부모 parent 를 사용하여 새 값 3D 축 포매터를 구성합니다.

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

값 3D 축 포맷터를 삭제합니다.

[protected] bool QValue3DAxisFormatter::allowNegatives() const

음수 값이 상위 축의 유효한 값인 경우 true 을 반환합니다. 기본 구현은 항상 true 을 반환합니다.

setAllowNegatives()도 참조하세요 .

[protected] bool QValue3DAxisFormatter::allowZero() const

부모 축에 0이 유효한 값이면 true 을 반환합니다. 기본 구현은 항상 true 을 반환합니다.

setAllowZero()도 참조하세요 .

[protected] QValue3DAxis *QValue3DAxisFormatter::axis() const

부모 축을 반환합니다. 스레드 렌더러를 사용하는 환경에서 스레드 안전을 유지하려면 recalculate() 메서드에서만 부모 축에 액세스해야 합니다.

recalculate()도 참조하세요 .

[virtual protected] QValue3DAxisFormatter *QValue3DAxisFormatter::createNewInstance() const

새로운 빈 값 3D 축 포매터를 생성합니다. 서브클래스에서 다시 구현해야 합니다.

새 포맷터를 반환합니다. 렌더러는 이 메서드를 사용하여 포맷터의 복사본을 캐시합니다. 새 복사본의 소유권은 호출자에게 이전됩니다.

[protected] QList<float> QValue3DAxisFormatter::gridPositions() &&

값별로 정규화된 그리드 선 위치의 배열을 반환합니다. 기본 배열 크기는 부모 축의 세그먼트 수에 1을 더한 값이지만 recalculate() 메서드의 서브클래스 구현은 배열 크기를 다르게 조정할 수 있습니다.

QValue3DAxis::segmentCountrecalculate()도 참조하세요 .

[protected] const QList<float> &QValue3DAxisFormatter::gridPositions() const &

정규화된 그리드 선 위치의 배열에 대한 참조를 반환합니다. 기본 배열 크기는 부모 축의 세그먼트 수에 1을 더한 값이지만 recalculate() 메서드의 서브클래스 구현은 배열의 크기를 다르게 조정할 수 있습니다.

QValue3DAxis::segmentCountrecalculate()도 참조하세요 .

[protected] QList<float> QValue3DAxisFormatter::labelPositions() &&

값별로 정규화된 레이블 위치의 배열을 반환합니다. 기본 배열 크기는 부모 축의 세그먼트 수에 1을 더한 값이지만 recalculate() 메서드의 서브클래스 구현은 배열 크기를 다르게 조정할 수 있습니다. 기본적으로 인덱스 0의 레이블은 축의 최소값에 해당합니다.

QValue3DAxis::segmentCount, QAbstract3DAxis::labels, recalculate()도 참조하세요 .

[protected] const QList<float> &QValue3DAxisFormatter::labelPositions() const &

정규화된 레이블 위치의 배열에 대한 참조를 반환합니다. 기본 배열 크기는 부모 축의 세그먼트 수에 1을 더한 값이지만 recalculate() 메서드의 서브클래스 구현은 배열 크기를 다르게 조정할 수 있습니다. 기본적으로 인덱스 0의 레이블은 축의 최소값에 해당합니다.

QValue3DAxis::segmentCount, QAbstract3DAxis::labels, recalculate()도 참조하세요 .

[protected] QStringList QValue3DAxisFormatter::labelStrings() &&

포맷터 레이블 문자열을 포함하는 값별 문자열 목록을 반환합니다.

setLabelStrings() 및 labelPositions()도 참조하세요 .

[protected] const QStringList &QValue3DAxisFormatter::labelStrings() const &

포맷터 레이블 문자열이 포함된 문자열 목록에 대한 참조를 반환합니다.

labelPositions()도 참조하세요 .

[protected] QLocale QValue3DAxisFormatter::locale() const

이 포맷터가 사용 중인 현재 로캘을 반환합니다.

setLocale()도 참조하세요 .

[protected] void QValue3DAxisFormatter::markDirty(bool labelsChange = false)

이 포맷터를 더티로 표시하여 렌더러가 다음 렌더러 동기화 시 캐시의 새 복사본을 만들도록 합니다. 이 메서드는 포맷터가 확인된 값에 영향을 미치는 방식으로 변경될 때마다 서브클래스에서 호출해야 합니다. 변경으로 인해 상위 축 레이블 문자열을 다시 생성해야 하는 경우 labelsChangetrue 으로 설정합니다.

[virtual protected] void QValue3DAxisFormatter::populateCopy(QValue3DAxisFormatter &copy)

이 포매터로 위치, 값, 문자열을 해결하는 데 필요한 모든 값을 포매터의 copy 에 복사합니다. 서브클래스에서 이 메서드를 다시 구현할 때는 어느 시점에서 슈퍼클래스 버전을 호출하세요. 렌더러는 이 메서드를 사용하여 포맷터의 복사본을 캐시합니다.

새 복사본을 반환합니다. 새 복사본의 소유권은 호출자에게 이전됩니다.

[virtual protected] float QValue3DAxisFormatter::positionAt(float value) const

주어진 value 에 대한 축을 따라 정규화된 위치를 반환합니다. 반환되는 값은 부모 축 범위 내에 있는 경우 0.0 (최소값)과 1.0 (최대값) 사이여야 합니다.

상위 축의 최소값과 최대값 사이의 선형 보간으로 위치를 확인할 수 없는 경우 이 메서드를 다시 구현합니다.

recalculate() 및 valueAt()도 참조하세요 .

[virtual protected] void QValue3DAxisFormatter::recalculate()

레이블 및 격자선 위치 배열과 레이블 문자열 배열의 크기를 조정하고 채울 뿐만 아니라 값을 해당 위치에 매핑하는 데 필요한 값을 계산합니다. 이 함수 내부에서 부모 축에 액세스할 수 있습니다.

기본 배열 내용이 적합하지 않은 경우 이 메서드는 서브클래스에서 다시 구현해야 합니다.

크기를 조정하고 채워야 하는 배열에 대한 설명은 gridPositions(), subGridPositions(), labelPositions() 및 labelStrings() 메서드를 참조하세요.

gridPositions(), subGridPositions(), labelPositions(), labelStrings() 및 axis()도 참조하세요 .

[protected] void QValue3DAxisFormatter::setAllowNegatives(bool allow)

allowtrue 인 경우 상위 축이 음수 값을 가질 수 있도록 허용합니다.

allowNegatives()도 참조하세요 .

[protected] void QValue3DAxisFormatter::setAllowZero(bool allow)

allowtrue 인 경우 상위 축이 0 값을 갖도록 허용합니다.

allowZero()도 참조하세요 .

[protected] void QValue3DAxisFormatter::setGridPoitions(QList<float> gridPositions)

gridPositions 에서 새 그리드 위치 목록을 설정합니다. 값은 0.0 (최소값)에서 1.0 (최대값) 사이여야 합니다.

QValue3DAxis::segmentCount, recalculate() 및 gridPositions참조하세요 .

[protected] void QValue3DAxisFormatter::setLabelStrings(QStringList labelStrings)

labelStrings 에서 새 레이블 문자열 목록을 설정합니다. 배열 크기는 인덱스가 대응하는 레이블 위치 배열의 크기와 같아야 합니다.

labelPositions() 및 labelStrings()도 참조하세요 .

[protected] void QValue3DAxisFormatter::setLocale(const QLocale &locale)

이 포맷터가 사용하는 locale 을 설정합니다. 부모 축이 그래프의 활성 축으로 설정되거나 축 포맷터가 그래프에 연결된 축으로 설정되거나 그래프의 로캘이 변경될 때마다 그래프가 자동으로 포맷터의 로캘을 그래프의 로캘로 설정합니다.

locale() 및 Q3DGraphsWidgetItem::locale참조하세요 .

[protected] void QValue3DAxisFormatter::setSubGridPositions(QList<float> subGridPositions)

subGridPositions 에서 새 하위 그리드 위치 목록을 설정합니다. 값은 0.0 (최소값)에서 1.0 (최대값) 사이여야 합니다.

QValue3DAxis::segmentCount, QValue3DAxis::subSegmentCount, recalculate() 및 subGridPositions도 참조하세요 .

[protected] void QValue3DAxisFormatter::setlabelPositions(QList<float> labelPositions)

labelPositions 에서 새 레이블 위치 목록을 설정합니다. 값은 0.0 (최소값)에서 1.0 (최대값) 사이여야 합니다.

QValue3DAxis::segmentCount, QAbstract3DAxis::labels, recalculate() 및 labelPositions()도 참조하세요 .

[virtual protected] QString QValue3DAxisFormatter::stringForValue(qreal value, const QString &format)

지정된 valueformat 을 사용하여 포맷된 레이블 문자열을 반환합니다.

QValue3DAxis::labelFormat 속성에 지정된 기본 서식 지정 규칙이 충분하지 않은 경우 하위 클래스에서 이 메서드를 다시 구현하여 지정된 value 에 대한 서식 지정 문자열을 확인합니다.

recalculate(), labelStrings() 및 QValue3DAxis::labelFormat참조하세요 .

[protected] QList<float> QValue3DAxisFormatter::subGridPositions() &&

값별로 정규화된 하위 그리드 선 위치의 배열을 반환합니다. 기본 배열 크기는 부모 축의 세그먼트 수에 부모 축의 하위 세그먼트 수에서 1을 뺀 값과 같지만 recalculate() 메서드의 서브클래스 구현은 배열 크기를 다르게 조정할 수 있습니다.

setSubGridPositions(), QValue3DAxis::segmentCount, QValue3DAxis::subSegmentCount, recalculate()도 참조하세요 .

[protected] const QList<float> &QValue3DAxisFormatter::subGridPositions() const &

정규화된 하위 그리드 선 위치의 배열에 대한 참조를 반환합니다. 기본 배열 크기는 부모 축의 세그먼트 수에 부모 축의 하위 세그먼트 수에서 1을 뺀 값과 같지만 recalculate() 메서드의 서브클래스 구현은 배열의 크기를 다르게 조정할 수 있습니다.

QValue3DAxis::segmentCount, QValue3DAxis::subSegmentCount, recalculate()도 참조하세요 .

[virtual protected] float QValue3DAxisFormatter::valueAt(float position) const

축을 따라 정규화된 position 값을 반환합니다. position 값은 부모 축 범위 내의 값을 얻으려면 0.0 (최소값)과 1.0 (최대값) 사이에 있어야 합니다.

상위 축의 최소값과 최대값 사이의 선형 보간으로 값을 해결할 수 없는 경우 이 방법을 다시 구현합니다.

recalculate() 및 positionAt()도 참조하세요 .

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